Claude SEO: SEO Skill for Claude Code

Claude SEO is an open-source SEO analysis plugin for Claude Code. It runs 25 sub-skills and 18 specialist agents in parallel across technical SEO, content quality (E-E-A-T), Schema.org markup, AI search optimization (GEO), local SEO, e-commerce, and international SEO. Every audit produces a prioritized action plan with testable recommendations grounded in primary-source guidance from Google.

Two versions of this skill.

• 🌐 Public open-source → AgriciDaniel/claude-seo: MIT, public releases, no membership. Use this if you want stable + downloadable.
• 🔒 Community private mirror → AI-Marketing-Hub/claude-seo: early access to upcoming features and direct collaboration with the AI Marketing Hub Pro community. Requires membership.

Why Claude SEO

• AI-search first. Aligned with Google's AI Optimization Guide. Question-based citability scoring, primary-source evidence on llms.txt, IPTC TrainedAlgorithmicMedia for AI-generated product images, agent-friendly page checks per web.dev.
• Parallel execution. Full site audits spawn up to 15 specialist agents simultaneously. Site-level audits complete in minutes rather than hours.
• Falsifiable, not promotional. Every recommendation carries the first-principle observation it rests on, its dependency relationships, an explicit "how would we know this failed?" check, and a leading indicator. See Methodology.

Real results

Google Search Console for a site started 23 March 2026 and run on this workflow: total clicks and impressions across its first three months, through 12 June 2026.

Using Codex instead of Claude Code? Use Codex SEO, the Codex-first port with TOML agents, plugin packaging, deterministic runners, and the same SEO workflow surface.

Who this is for

• SEO agencies running 5+ client sites. Replace quarterly deep audits with weekly automated runs. Same team capacity, 4× audit cadence, every recommendation comes with a falsifiability check the client can verify.
• In-house SEO leads at SaaS / publisher / e-commerce companies. Second-pair-of-eyes before executive reviews. Catches what GSC and Lighthouse hide: schema deprecation, AI-citability gaps, expired-domain heritage risk, parasite-SEO exposure, machine-translation drift.
• Freelance SEO consultants. Anchor day-one client scope with a 15-minute audit and a real 0-100 score. Win the engagement with concrete proof of value before you spend an hour writing the proposal.

Run a full audit and watch parallel agents fan out across the site:

Watch the full demo on YouTube

Table of Contents

• Who this is for
• Installation
• Quick Start
• Commands
• Features
• Compared to manual / agency / commercial tools
• Use cases
• Sample Output
• Architecture
• Methodology
• What's New in v2
• Limitations
• Requirements
• Uninstall
• Extensions
• Ecosystem
• Documentation
• FAQ
• Community Contributors
• License
• Contributing
• Author

Installation

ℹ️ Which version are you installing?

• Public open-source (default). The commands below install from AgriciDaniel/claude-seo — MIT, public releases, no membership required.
• AI Marketing Hub Pro member? Install the community version with early access instead: swap AgriciDaniel/claude-seo for AI-Marketing-Hub/claude-seo and the plugin slug claude-seo@agricidaniel-claude-seo for claude-seo@ai-marketing-hub-claude-seo. Requires gh auth login (or PAT) with access to the AI-Marketing-Hub org. If /plugin marketplace add 404s, DM in the Skool community to get added.

Plugin Install (Claude Code 1.0.33+)

The fastest path. One-time marketplace add, then plugin install:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

The explicit setup step creates an isolated Python environment in Claude's persistent plugin data and installs Playwright Chromium. Check it at any time with /seo doctor. No global Python packages or PATH shims are created.

Manual Install (Unix / macOS / Linux)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

<details> <summary>One-liner (curl, review then run)</summary>

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # review before running
bash install.sh
rm install.sh

</details>

Windows (PowerShell)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

Why git clone instead of irm | iex? Claude Code's own security guardrails flag irm ... | iex as a supply chain risk: downloading and executing remote code without verification. The git clone approach lets you inspect claude-seo\install.ps1 before running it.

Quick Start

# Start Claude Code
claude

# Full site audit: parallel sub-agents produce a prioritized action plan
/seo audit https://example.com

# Deep single-page analysis: on-page elements, content quality, schema
/seo page https://example.com/about

# Schema markup audit: detect, validate, generate
/seo schema https://example.com

# AI search optimization: passage citability + primary-source-aligned recommendations
/seo geo https://example.com

# Generate a sitemap with industry templates
/seo sitemap generate

Commands

32 user-invocable /seo commands across the orchestrator, its sub-skills, and 8 MCP extensions. Full reference in docs/COMMANDS.md.

| Command | Description | |---------|-------------| | /seo setup | Create or refresh the isolated Python runtime and Chromium | | /seo doctor | Check runtime readiness without changing the system | | /seo audit <url> | Full website audit with parallel sub-agent delegation | | /seo page <url> | Deep single-page analysis | | /seo technical <url> | Technical SEO audit across 9 categories | | /seo content <url> | E-E-A-T and content quality analysis | | /seo content-brief <topic> | Detailed content brief: target keywords, outline, internal links | | /seo schema <url> | Detect, validate, and generate Schema.org markup | | /seo geo <url> | AI Overviews / Generative Engine Optimization | | /seo sitemap <url \| generate> | Analyze or generate XML sitemaps | | /seo images <url> | Image optimization analysis | | /seo plan <type> | Strategic SEO planning (saas, local, ecommerce, publisher, agency) | | /seo programmatic <url> | Programmatic SEO analysis and planning | | /seo competitor-pages <url> | Competitor comparison page generation | | /seo local <url> | Local SEO analysis (GBP, citations, reviews, map pack) | | /seo maps [command] | Maps intelligence (geo-grid, GBP audit, reviews, competitors) | | /seo hreflang <url> | Hreflang / i18n SEO audit and generation | | /seo google [command] | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4, PDF reports) | | /seo backlinks <url> | Backlink profile analysis (Moz, Bing, Common Crawl) | | /seo cluster <keyword> | SERP-based semantic clustering | | /seo sxo <url> | Search Experience Optimization (page-type, user stories, personas) | | /seo drift baseline \| compare \| history <url> | SEO drift monitoring with SQLite snapshots | | /seo ecommerce <url> | E-commerce SEO and marketplace intelligence | | /seo flow [stage] | FLOW framework prompts (CC BY 4.0, evidence-led) | | /seo firecrawl [command] <url> | Full-site crawling (extension) | | /seo dataforseo [command] | Live SEO data (extension) | | /seo image-gen [use-case] | AI image generation for SEO assets (extension) | | /seo ahrefs [command] <url> | Backlinks, organic keywords, and content data via the official Ahrefs MCP (extension) | | /seo seranking [command] | AI Share-of-Voice across ChatGPT, Gemini, Perplexity, AI Overviews, AI Mode (extension) | | /seo profound [command] | LLM citation tracking with time-series data (extension) | | /seo bing [command] <url> | Bing Webmaster Tools + IndexNow URL submission (extension) | | /seo unlighthouse <url> | Multi-page Lighthouse runner, runs locally (extension) |

Features

What Core Web Vitals does Claude SEO check?

Claude SEO measures the current three Core Web Vitals: LCP (Largest Contentful Paint, target under 2.5s), INP (Interaction to Next Paint, target under 200ms), and CLS (Cumulative Layout Shift, target under 0.1). INP replaced FID on March 12, 2024; FID was removed from Chrome's field-data tools (CrUX API, PageSpeed Insights) on September 9, 2024 (Lighthouse is a lab tool and never reported FID), and Claude SEO never references FID. Field data comes from the Chrome User Experience Report (CrUX) when available; lab data falls back to Lighthouse via PageSpeed Insights. LCP can be decomposed into subparts (TTFB, load delay, load duration, render delay) via the /seo google CrUX integration to localize bottlenecks. Mobile and desktop are measured separately. CrUX History (25-week trend) is included in the Tier 0 free credential set.

How does Claude SEO assess E-E-A-T?

E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) is evaluated against the Search Quality Rater Guidelines, last updated September 2025 with YMYL expanded to include political and social topics. Experience signals: original research, case studies, first-hand photos. Expertise: author credentials and topical depth. Authoritativeness: external citations and brand mentions. Trustworthiness, the most heavily weighted of the four: contact