Claude SEO: SEO Analysis 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 falsifiable 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.

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.

Claude SEO /seo command demo in Claude Code terminal

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

Claude SEO /seo audit demo: parallel subagents producing a prioritized action plan

Watch the full demo on YouTube

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

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

Claude SEO sub-skill ecosystem: 25 modules grouped into 8 categories (audit, content, schema, technical, AI search, local + maps, commerce + intl, extensions) around the central orchestrator

27 user-invokable commands across the orchestrator and 25 sub-skills. Full reference in docs/COMMANDS.md.

| Command | Description | |---------|-------------| | /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 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) |

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 all Chrome tools (CrUX API, PageSpeed Insights, Lighthouse) on September 9, 2024, 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. Mo

claude-seo

Related Skills

Developers Also Liked