claude-seo

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

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

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?