Claude SEO — a whole SEO team inside Claude Code
Search Engine Optimization makes your website show up when people search Google. Claude SEO is a free, open-source tool that turns Claude Code into an automated SEO team — it audits your site, scores it, and hands you a plain-English action plan. This academy teaches you to use it from zero, no technical background needed.
What is Claude SEO?
Think of it as hiring an SEO agency that works inside your terminal — for free.
Technical SEO
Checks if Google can crawl and index your site, page speed (Core Web Vitals), security, mobile, structured data.
Content & E-E-A-T
Judges whether your pages show real Experience, Expertise, Authority and Trust — what Google now rewards.
Schema & GEO/AEO
Adds the hidden code that earns rich results, and optimizes you to be cited by AI answers (ChatGPT, Google AI).
Backlinks & clusters
Maps who links to you and plans topic clusters so your content strategy actually ranks.
Local & Maps
For shops, restaurants and services — optimizes Google Maps presence and local rankings.
E-commerce & global
Product/category SEO plus multi-language and international checks for stores that sell everywhere.
🧠 How it works
Claude SEO isn't one big prompt — it's an orchestrator that detects your business type and then delegates to a swarm of specialist sub-agents running in parallel, each an expert in one slice of SEO. Their findings are aggregated into a single Health Score and a prioritized action plan.
The audit pipeline
- 1 · RenderCaptures the homepage's raw HTML, the JavaScript-rendered HTML, extracted text and SPA status (so it sees what Google's renderer sees).
- 2 · Detect business typeReads homepage signals to classify the site (local-service, e-commerce, SaaS, blog, …) — this decides which specialists get spawned.
- 3 · CrawlFollows internal links up to 500 pages, respects robots.txt, 5 concurrent requests with a polite delay.
- 4 · Delegate in parallelSpawns 8 always-on specialists + up to 7 conditional ones (local/maps/google/backlinks/cluster/drift/ecommerce) based on the detected type and available API credentials.
- 5 · ScoreAggregates every specialist's findings into a single 0–100 SEO Health Score with per-area sub-scores.
- 6 · PersistWrites all artifacts under {domain}-audit/ — the full report, per-category findings, structured JSON, and screenshots.
- 7 · ReportGenerates a prioritized action plan (Critical › High › Medium › Low) and, optionally, an enterprise PDF with gauges and charts.
skills/seo/SKILL.md — the project manager. Detects context and decides who to call. You usually just talk to it via /seo.
Each is a SKILL.md with activation keywords and instructions for one job (technical, content, schema, local…). You can also call them directly, e.g. /seo technical.
Sub-agents with their own context and tools that do the heavy lifting during an audit, in parallel.
Optional MCP-powered data feeds (DataForSEO, Ahrefs, Firecrawl, SE Ranking, Bing, Profound, Gemini images, Unlighthouse) — each needs that provider's key.
🗺️ Your learning path
Work through the stages in order. Each lesson explains the idea in plain language first, then shows the exact commands. Mark lessons done to earn XP, level up, and unlock your certificate.
Orientation
Understand what SEO is and what this tool does — before touching a command.
⚙️ Install it on your machine
Claude SEO runs inside the Claude Code CLI. Pick the method that matches your setup — the plugin route is easiest.
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seoRun these two lines inside a Claude Code session. Works on Claude Code 1.0.33+.
📦 Skills library
Every one of the 25 sub-skills, explained — what it does, when it kicks in, and a real example. Filter by area or search.
The main entry point. Detects business type and routes to the right sub-skills/agents. Everything flows through here.
Triggers on: Any SEO request — it figures out what you need.
Full website audit: crawls up to 500 pages, detects business type, delegates to up to 15 specialists, produces a 0–100 Health Score + prioritized action plan + optional PDF.
Triggers on: audit · full SEO check · analyze my site · website health check
Deep single-page analysis: on-page elements, content quality, technical meta, schema, images and performance for one URL.
Triggers on: analyze this page · check page SEO · single URL
“Git for SEO.” Captures baselines of SEO-critical elements and detects regressions over time so you catch when something silently breaks.
Triggers on: SEO drift · baseline · did anything break · SEO regression
Search Experience Optimization — reads SERPs backwards to spot page-type mismatches and scores your page from multiple persona perspectives. Explains why an optimized page still won't rank.
Triggers on: SXO · why am I not ranking · search intent · page-type mismatch
Technical audit across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals, structured data, JS rendering, IndexNow.
Triggers on: technical SEO · robots.txt · Core Web Vitals · site speed · security headers
Analyse an existing XML sitemap or generate a new one from industry templates; validates format, URLs and structure.
Triggers on: sitemap · generate sitemap · XML sitemap · sitemap issues
Image optimization for SEO + performance: alt text, file sizes, WebP/AVIF, responsive images, lazy loading, CLS prevention, image-SERP rankings.
Triggers on: image optimization · alt text · image SEO · WebP
Programmatic SEO for pages generated at scale: template engines, URL patterns, internal-linking automation, thin-content safeguards, index-bloat prevention.
Triggers on: programmatic SEO · pages at scale · template pages · generated pages
Content quality + E-E-A-T analysis with AI-citation-readiness scoring; flags thin content and readability problems.
Triggers on: content quality · E-E-A-T · thin content · readability check
Generate a competitive content brief with per-section word counts, competitor scoring, keyword-density guidance and page-type templates.
Triggers on: content brief · write a brief · content outline · blog brief
Detect, validate and generate Schema.org structured data (JSON-LD) to unlock rich results.
Triggers on: schema · structured data · rich results · JSON-LD · markup
Generative Engine Optimization for AI Overviews, ChatGPT search, Perplexity: brand-mention signals, AI-crawler accessibility, llms.txt compliance, passage-level citability scoring.
Triggers on: GEO · AI Overviews · ChatGPT search · get cited by AI · llms.txt
The FLOW framework — evidence-led SEO via Find → Leverage → Optimize → Win, surfacing 41 stage-specific AI prompts.
Triggers on: FLOW · evidence-led SEO · find leverage optimize win
Backlink profile: referring domains, anchor-text distribution, toxic-link detection, competitor link-gap. Works with free APIs (Moz, Bing, Common Crawl) or the DataForSEO extension.
Triggers on: backlinks · link profile · referring domains · toxic links · link gap
Strategic SEO plan with industry templates: competitive analysis, content strategy, site architecture and an implementation roadmap.
Triggers on: SEO plan · SEO strategy · content calendar · site architecture · roadmap
SERP-based semantic topic clustering: groups keywords by actual Google SERP overlap, designs hub-and-spoke clusters with internal-link matrices. Can execute content if claude-blog is installed.
Triggers on: topic cluster · content architecture · pillar pages · keyword grouping
Generate SEO-optimized “X vs Y”, “alternatives to X” and feature-matrix comparison pages with schema and conversion optimization.
Triggers on: comparison page · vs page · alternatives page · X vs Y
Local SEO: Google Business Profile optimization, NAP consistency, citation health, review signals, local schema, multi-location and industry-specific recommendations.
Triggers on: local SEO · Google Business Profile · NAP · citations · near me
Maps intelligence: geo-grid rank tracking, GBP audit via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification, competitor radius mapping.
Triggers on: map rankings · geo grid · GBP audit · local competitors
E-commerce SEO: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing and marketplace keyword gaps.
Triggers on: ecommerce SEO · product SEO · Google Shopping · marketplace
Hreflang / international SEO audit, validation and generation; detects common mistakes and validates language/region codes.
Triggers on: hreflang · international SEO · multi-language · multi-region
Real Google field data: Search Console (analytics, URL inspection, sitemaps), PageSpeed Insights, CrUX (25-week history), Indexing API, and GA4 organic traffic.
Triggers on: Search Console · PageSpeed · CrUX · indexation · organic traffic
Live SEO data via the DataForSEO MCP: SERP analysis, keyword research (volume/difficulty/intent/trends), backlinks, on-page, competitor and AI-visibility data.
Triggers on: keyword volume · SERP data · keyword difficulty (needs DataForSEO key)
AI image generation for SEO assets — OG/social preview images, blog heroes, product photos, infographics, favicons — powered by Gemini (needs the banana extension).
Triggers on: generate image · OG image · hero image · infographic (needs banana ext)
👷 The specialist agents
During a full audit the orchestrator spawns these specialists in parallel — 8 always run; 7 more spawn only when the business type or available API keys call for them. Three are mirrors of the extension data feeds.
robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
E-E-A-T, readability, thin content, AI-citation readiness
structured-data detection, validation, generation recommendations
sitemap structure, quality gates, missing pages
LCP, INP and CLS measurements (Core Web Vitals)
desktop + mobile screenshots, above-the-fold rendering
AI-crawler access, llms.txt, citability, brand-mention signals
page-type match, user stories, persona scoring
GBP signals, NAP consistency, reviews, local schema
geo-grid rank tracking, GBP audit, competitor radius (needs DataForSEO)
CrUX field CWV, GSC indexation, GA4 organic traffic (needs Google creds)
DA/PA, referring domains, anchor text, toxic links (Moz/Bing/Common Crawl)
semantic topic clustering (when content-strategy signals detected)
comparison against a stored baseline (when one exists)
product schema, marketplace intelligence (when e-commerce detected)
FLOW-framework prompt selection (evidence-led workflow)
DataForSEO MCP mirror — live keyword/SERP/backlink data
Gemini (nanobanana) MCP mirror — SEO image generation
🔌 Optional data extensions
The core skill works on its own. These plug in third-party data — each needs that provider's own API key. None are required to start.
| Extension | What it adds | Needs |
|---|---|---|
| dataforseo | Live keyword volumes, SERP data, keyword difficulty, backlinks, AI-visibility scraping. | DataForSEO API key |
| firecrawl | Robust full-site crawling, scraping, sitemapping and JS rendering for large sites. | Firecrawl MCP / API key |
| ahrefs | Referring domains, backlinks, organic keywords, Content Explorer via the official Ahrefs MCP. | Ahrefs API (@ahrefs/mcp) |
| seranking | AI Share-of-Voice across ChatGPT, Gemini, Perplexity, AI Overviews and AI Mode in one query. | SE Ranking API key |
| bing-webmaster | Bing visibility + link data + IndexNow URL submission (feeds Microsoft Copilot citations). | Bing Webmaster API key |
| profound | Time-series brand-citation rates across ChatGPT, Perplexity and other LLMs. | Profound API key |
| banana | AI image generation (OG, hero, product, infographic) via Gemini nanobanana. | nanobanana MCP |
| unlighthouse | Site-wide Lighthouse / Core Web Vitals sweeps across every page. | Unlighthouse (local) |
📄 What the output looks like
Real artifact shapes the skill produces — so you know exactly what you'll get back.
SEO Health Score (audit-data.json envelope)
{
"summary": {
"seo_health_score": 78,
"grade": "B",
"pages_crawled": 412,
"business_type": "saas",
"audit_date": "2026-06-18"
},
"categories": {
"technical": { "score": 84, "critical": 1, "high": 3 },
"content": { "score": 72, "critical": 0, "high": 5 },
"schema": { "score": 65, "critical": 2, "high": 2 },
"performance": { "score": 80, "lcp": "2.1s", "inp": "180ms", "cls": 0.04 },
"geo": { "score": 70, "llms_txt": false, "citability": "medium" }
},
"top_actions": [
{ "priority": "Critical", "area": "schema", "fix": "Add Product JSON-LD to 38 product pages" },
{ "priority": "High", "area": "content", "fix": "Expand 12 thin pages below 300 words" }
]
}Every audit writes this structured envelope so a PDF/HTML report can be generated even without Google API data.
What the audit writes to disk
mysite.com-audit/
├── FULL-AUDIT-REPORT.md # comprehensive findings
├── ACTION-PLAN.md # prioritized: Critical › High › Medium › Low
├── audit-data.json # structured envelope (above)
├── findings/
│ ├── technical.md
│ ├── content.md
│ ├── schema.md
│ ├── performance.md
│ └── visual.md
└── screenshots/ # desktop + mobile (if Playwright installed)All artifacts are persisted under {domain}-audit/ so you can review, diff and report.
🍳 Recipes — end to end
Copy-paste playbooks for the most common goals. Follow the steps top to bottom.
Your very first audit
Get a complete picture of where your site stands and a clear to-do list.
- 1claudeStart a Claude Code session in your project folder.
- 2/seo audit https://mysite.comRun the full audit — go make coffee while the specialists work in parallel.
- 3Open
ACTION-PLAN.mdand read the Critical items first. - 4/seo page <top-url>Drill into your most important page for specific fixes.
The monthly routine
Keep rankings healthy with ~30 minutes a month.
- 1/seo drift baseline https://mysite.comCapture a baseline the first time so you can detect regressions later.
- 2/seo audit https://mysite.comRe-audit monthly.
- 3/seo drift compare https://mysite.comSee exactly what changed since last month.
- 4Fix the top 3 action items, then improve one page with
/seo content.
Rank a local business
Win the map pack and 'near me' searches for a shop or service.
- 1/seo local https://mysite.comAudit Google Business Profile, NAP consistency, citations and reviews.
- 2/seo maps grid "<service>" "<city>"See your geo-grid rankings vs nearby competitors.
- 3/seo schema https://mysite.comAdd LocalBusiness schema for rich results.
E-commerce / product SEO
Get products visible in Google Shopping and search.
- 1/seo ecommerce https://shop.comAudit product SEO, schema and marketplace visibility.
- 2/seo schema https://shop.com/p/123Validate & generate Product + Offer JSON-LD.
- 3/seo images https://shop.comOptimize product images (WebP, alt text, CLS).
Get cited by AI (GEO push)
Show up in ChatGPT, Perplexity and Google AI Overviews.
- 1/seo geo https://mysite.comScore AI-crawler access, llms.txt and passage-level citability.
- 2/seo content <url>Raise E-E-A-T and citation readiness on key pages.
- 3/seo schema <url>Add structured data so AI engines parse you cleanly.
⌨️ Command explorer
Every command, searchable. Try "audit", "image", "report"…
| Command | Area | What it does |
|---|---|---|
| /seo audit <url> | Audit | Full-site audit: parallel specialists, 0–100 score, prioritized action plan. |
| /seo page <url> | Audit | Deep single-page analysis: on-page, content, technical, schema, images, CWV. |
| /seo technical <url> | Technical | 9-category technical audit (crawl, index, security, URLs, mobile, CWV, schema, JS, IndexNow). |
| /seo content <url> | Content | E-E-A-T and content-quality analysis. |
| /seo schema <url> | Technical | Generate JSON-LD structured data markup. |
| /seo geo <url> | AI/GEO | Optimize to be cited by AI answer engines (GEO/AEO). |
| /seo backlinks <url> | Authority | Backlink intelligence and link strategy. |
| /seo cluster <topic> | Strategy | Semantic topic-cluster planning. |
| /seo local <url> | Local | Local SEO audit for area-based businesses. |
| /seo maps <url> | Local | Google Maps / Business Profile intelligence. |
| /seo ecommerce <url> | E-commerce | Product & category page SEO. |
| /seo performance <url> | Technical | Core Web Vitals & speed deep-dive. |
📚 Glossary (no jargon left behind)
Every term a non-technical reader might trip on, in one place.
Search Engine Results Page — the list of results Google shows for a query.
Crawling = engines reading your pages; indexing = storing them so they can appear in results.
Google's speed/usability metrics: LCP (load), INP (responsiveness), CLS (visual stability).
Hidden JSON-LD code describing your page to enable rich results.
Experience, Expertise, Authority, Trust — Google's content-quality framework.
Generative / Answer Engine Optimization — getting cited by AI assistants.
A link from another website to yours; a signal of authority.
A tag telling engines which version of a page is the official one to rank.
❓ FAQ
I'm not technical at all. Can I still use this?
/seo audit https://mysite.com and read a clear action plan. Claude can even apply many fixes when you ask.Does it cost anything?
Will it change my website automatically?
Which platforms work?
How often should I run it?
/seo page check whenever you publish an important page.Claude SEO Graduate
Complete all 16 lessons to unlock your certificate and the Graduate badge.
Awarded by the cabscloud Claude Academy