Interactive academy · self-paced · 16 lessons

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.

25
sub-skills
18
AI sub-agents
8
data extensions
/seo
one command
🧭
Basics
⚙️
Install
🔍
Audit
🛠️
Fix
🚀
Grow
🎓
Graduate

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. 1 · Render
    Captures the homepage's raw HTML, the JavaScript-rendered HTML, extracted text and SPA status (so it sees what Google's renderer sees).
  2. 2 · Detect business type
    Reads homepage signals to classify the site (local-service, e-commerce, SaaS, blog, …) — this decides which specialists get spawned.
  3. 3 · Crawl
    Follows internal links up to 500 pages, respects robots.txt, 5 concurrent requests with a polite delay.
  4. 4 · Delegate in parallel
    Spawns 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. 5 · Score
    Aggregates every specialist's findings into a single 0–100 SEO Health Score with per-area sub-scores.
  6. 6 · Persist
    Writes all artifacts under {domain}-audit/ — the full report, per-category findings, structured JSON, and screenshots.
  7. 7 · Report
    Generates a prioritized action plan (Critical › High › Medium › Low) and, optionally, an enterprise PDF with gauges and charts.
🧠The orchestrator

skills/seo/SKILL.md — the project manager. Detects context and decides who to call. You usually just talk to it via /seo.

📦25 sub-skills

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.

👷18 specialist agents

Sub-agents with their own context and tools that do the heavy lifting during an audit, in parallel.

🔌8 extensions

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-seo

Run these two lines inside a Claude Code session. Works on Claude Code 1.0.33+.

🔑 Requirements: the Claude Code CLI (where the skill runs), Python 3.10+, and Git. Optional: Playwright for screenshots.

📦 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.

/seo[command] [url]Orchestrator

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.

›/seo audit https://mysite.com
/seo audit[url]Audit & analysis

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

›/seo audit https://mysite.com
/seo page[url]Audit & analysis

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

›/seo page https://mysite.com/pricing
/seo driftbaseline|compare|history <url>Audit & analysis

“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

›/seo drift baseline https://mysite.com
/seo sxo<url> [keyword]Audit & analysis

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

›/seo sxo https://mysite.com/blog/x "best crm"
/seo technical[url]Technical

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

›/seo technical https://mysite.com
/seo sitemap[url or generate]Technical

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

›/seo sitemap generate https://mysite.com
/seo images[url]Technical

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

›/seo images https://mysite.com
/seo programmatic[url or plan]Technical

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

›/seo programmatic https://mysite.com
/seo content[url]Content & E-E-A-T

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

›/seo content https://mysite.com/blog/post
/seo content-brief[url-or-keyword] [page-type]Content & E-E-A-T

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

›/seo content-brief "email marketing" blog
/seo schema[url]Schema

Detect, validate and generate Schema.org structured data (JSON-LD) to unlock rich results.

Triggers on: schema · structured data · rich results · JSON-LD · markup

›/seo schema https://mysite.com/product/x
/seo geo[url]AI / GEO

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

›/seo geo https://mysite.com
/seo flow[stage] [url|topic]AI / GEO

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

›/seo flow optimize https://mysite.com
/seo backlinks<url>Backlinks & authority

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

›/seo backlinks https://mysite.com
/seo plan[business-type]Strategy & planning

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

›/seo plan saas
/seo cluster<seed-keyword or url>Strategy & planning

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

›/seo cluster "project management"
/seo competitor-pages[url or generate] [competitor]Strategy & planning

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

›/seo competitor-pages generate "Asana"
/seo local[url]Local & Maps

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

›/seo local https://mysite.com
/seo maps[command] [url|keyword|location]Local & Maps

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

›/seo maps grid "dentist" "Austin, TX"
/seo ecommerce<url or keyword>E-commerce & international

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

›/seo ecommerce https://shop.com/p/123
/seo hreflang[url]E-commerce & international

Hreflang / international SEO audit, validation and generation; detects common mistakes and validates language/region codes.

Triggers on: hreflang · international SEO · multi-language · multi-region

›/seo hreflang https://mysite.com
/seo google[command] [url|property]Data & Google

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

›/seo google gsc https://mysite.com
/seo dataforseo[command] [query]Data & Google

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)

›/seo dataforseo keywords "running shoes"
/seo image-gen[og|hero|product|infographic|batch] <desc>Visual & media

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)

›/seo image-gen og "guide to home espresso"

👷 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.

seo-technicalalways runs

robots.txt, sitemaps, canonicals, Core Web Vitals, security headers

seo-contentalways runs

E-E-A-T, readability, thin content, AI-citation readiness

seo-schemaalways runs

structured-data detection, validation, generation recommendations

seo-sitemapalways runs

sitemap structure, quality gates, missing pages

seo-performancealways runs

LCP, INP and CLS measurements (Core Web Vitals)

seo-visualalways runs

desktop + mobile screenshots, above-the-fold rendering

seo-geoalways runs

AI-crawler access, llms.txt, citability, brand-mention signals

seo-sxoalways runs

page-type match, user stories, persona scoring

seo-localconditional

GBP signals, NAP consistency, reviews, local schema

seo-mapsconditional

geo-grid rank tracking, GBP audit, competitor radius (needs DataForSEO)

seo-googleconditional

CrUX field CWV, GSC indexation, GA4 organic traffic (needs Google creds)

seo-backlinksconditional

DA/PA, referring domains, anchor text, toxic links (Moz/Bing/Common Crawl)

seo-clusterconditional

semantic topic clustering (when content-strategy signals detected)

seo-driftconditional

comparison against a stored baseline (when one exists)

seo-ecommerceconditional

product schema, marketplace intelligence (when e-commerce detected)

seo-flowalways runs

FLOW-framework prompt selection (evidence-led workflow)

seo-dataforseoalways runs

DataForSEO MCP mirror — live keyword/SERP/backlink data

seo-image-genalways runs

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.

ExtensionWhat it addsNeeds
dataforseoLive keyword volumes, SERP data, keyword difficulty, backlinks, AI-visibility scraping.DataForSEO API key
firecrawlRobust full-site crawling, scraping, sitemapping and JS rendering for large sites.Firecrawl MCP / API key
ahrefsReferring domains, backlinks, organic keywords, Content Explorer via the official Ahrefs MCP.Ahrefs API (@ahrefs/mcp)
serankingAI Share-of-Voice across ChatGPT, Gemini, Perplexity, AI Overviews and AI Mode in one query.SE Ranking API key
bing-webmasterBing visibility + link data + IndexNow URL submission (feeds Microsoft Copilot citations).Bing Webmaster API key
profoundTime-series brand-citation rates across ChatGPT, Perplexity and other LLMs.Profound API key
bananaAI image generation (OG, hero, product, infographic) via Gemini nanobanana.nanobanana MCP
unlighthouseSite-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.

  1. 1claudeStart a Claude Code session in your project folder.
  2. 2/seo audit https://mysite.comRun the full audit — go make coffee while the specialists work in parallel.
  3. 3Open ACTION-PLAN.md and read the Critical items first.
  4. 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. 1/seo drift baseline https://mysite.comCapture a baseline the first time so you can detect regressions later.
  2. 2/seo audit https://mysite.comRe-audit monthly.
  3. 3/seo drift compare https://mysite.comSee exactly what changed since last month.
  4. 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. 1/seo local https://mysite.comAudit Google Business Profile, NAP consistency, citations and reviews.
  2. 2/seo maps grid "<service>" "<city>"See your geo-grid rankings vs nearby competitors.
  3. 3/seo schema https://mysite.comAdd LocalBusiness schema for rich results.
🛒

E-commerce / product SEO

Get products visible in Google Shopping and search.

  1. 1/seo ecommerce https://shop.comAudit product SEO, schema and marketplace visibility.
  2. 2/seo schema https://shop.com/p/123Validate & generate Product + Offer JSON-LD.
  3. 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. 1/seo geo https://mysite.comScore AI-crawler access, llms.txt and passage-level citability.
  2. 2/seo content <url>Raise E-E-A-T and citation readiness on key pages.
  3. 3/seo schema <url>Add structured data so AI engines parse you cleanly.

⌨️ Command explorer

Every command, searchable. Try "audit", "image", "report"…

CommandAreaWhat it does
/seo audit <url>AuditFull-site audit: parallel specialists, 0–100 score, prioritized action plan.
/seo page <url>AuditDeep single-page analysis: on-page, content, technical, schema, images, CWV.
/seo technical <url>Technical9-category technical audit (crawl, index, security, URLs, mobile, CWV, schema, JS, IndexNow).
/seo content <url>ContentE-E-A-T and content-quality analysis.
/seo schema <url>TechnicalGenerate JSON-LD structured data markup.
/seo geo <url>AI/GEOOptimize to be cited by AI answer engines (GEO/AEO).
/seo backlinks <url>AuthorityBacklink intelligence and link strategy.
/seo cluster <topic>StrategySemantic topic-cluster planning.
/seo local <url>LocalLocal SEO audit for area-based businesses.
/seo maps <url>LocalGoogle Maps / Business Profile intelligence.
/seo ecommerce <url>E-commerceProduct & category page SEO.
/seo performance <url>TechnicalCore Web Vitals & speed deep-dive.

📚 Glossary (no jargon left behind)

Every term a non-technical reader might trip on, in one place.

SERP

Search Engine Results Page — the list of results Google shows for a query.

Crawl / index

Crawling = engines reading your pages; indexing = storing them so they can appear in results.

Core Web Vitals

Google's speed/usability metrics: LCP (load), INP (responsiveness), CLS (visual stability).

Schema / structured data

Hidden JSON-LD code describing your page to enable rich results.

E-E-A-T

Experience, Expertise, Authority, Trust — Google's content-quality framework.

GEO / AEO

Generative / Answer Engine Optimization — getting cited by AI assistants.

Backlink

A link from another website to yours; a signal of authority.

Canonical

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?
Yes. You run plain commands like /seo audit https://mysite.com and read a clear action plan. Claude can even apply many fixes when you ask.
Does it cost anything?
Claude SEO is free and open-source (MIT). You need Claude Code, and optionally paid data extensions.
Will it change my website automatically?
No — it analyses and recommends. You (or Claude, when you approve) apply changes.
Which platforms work?
Any public website — WordPress, Shopify, Webflow, custom code. It reads your live pages.
How often should I run it?
A full audit monthly, plus a quick /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