# Astro SEO
> Use when optimizing SEO for an Astro site — meta tags, Open Graph, JSON-LD structured data, sitemap/RSS, canonical URLs, hreflang, Core Web Vitals.
- Skill: `fusengine/astro-seo` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add fusengine/astro-seo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fusengine/astro-seo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: fusengine (https://skillmd.com/u/fusengine)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/fusengine/astro-seo
---
Implements SEO for Astro 7 sites: meta tags, Open Graph, and Twitter Cards via a reusable ``/`` component; JSON-LD structured data injected with `set:html` (never string interpolation, to avoid XSS); `@astrojs/sitemap` and `@astrojs/rss` setup; robots.txt and canonical URLs built with `Astro.site`; hreflang for multilingual SEO; and Core Web Vitals optimization leveraging Astro's zero-JS-by-default output.
Does not cover locale routing mechanics beyond hreflang tag generation (astro-i18n), Content Layer schema design (astro-content), or image-specific optimization like ``/`` (astro-assets) — those are separate skills.
# Astro SEO
Complete SEO strategy for Astro 7 sites — zero JS by default makes Astro naturally SEO-friendly.
## Agent Workflow (MANDATORY)
Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:
1. **fuse-ai-pilot:explore-codebase** - Analyze existing layouts, head components, and metadata
2. **fuse-ai-pilot:research-expert** - Verify latest SEO best practices via Context7/Exa
3. **mcp__context7__query-docs** - Check Astro 7 sitemap/RSS integration docs
After implementation, run **fuse-ai-pilot:sniper** for validation.
---
## Overview
### When to Use
- Adding meta tags and Open Graph to any Astro page
- Generating JSON-LD structured data for rich snippets
- Setting up @astrojs/sitemap for search indexing
- Configuring RSS feeds with @astrojs/rss
- Creating robots.txt and canonical URL patterns
- Adding hreflang for multilingual SEO
- Measuring and improving Core Web Vitals
### Why Astro for SEO
| Feature | Benefit |
|---------|---------|
| Zero JS by default | Pure HTML for crawlers, instant indexing |
| Static output | Sub-second TTFB, top Core Web Vitals |
| `Astro.site` | Canonical URL construction built-in |
| Islands Architecture | Only hydrate interactive parts |
---
## Core Concepts
### Head Component Pattern
Create a reusable `` or `` component accepting `title`, `description`, `og`, `canonical` props. Place in all layouts. Use `Astro.site` for absolute URL construction.
### Canonical URLs
Always construct canonicals with `Astro.site`:
```ts
const canonical = new URL(Astro.url.pathname, Astro.site);
```
### Structured Data
Inject JSON-LD via `