# Claude SEO

> One day, SEO used to cost $5-10K/month for agencies to tell you what was broken on your website. They would run a crawler, paste the results into a PDF, and send an invoice. That era is over. Claude SEO is a free, open-source AI SEO audit tool that runs inside Claude Code. You type one command and up to 18 AI agents analyze your site in parallel while you go make coffee. This is the story of how terminal-native SEO analysis became a thing. - @AgriciDaniel, February 2026

## The idea

Give Claude Code a comprehensive SEO analysis skill and let it do the work. It fetches your page, spawns up to 18 parallel subagents, each specializing in a different SEO discipline, and produces a 0-100 health score with a prioritized action plan. You read the report. That is the entire workflow.

## What it covers (v2.0.0)

- **Technical SEO** across 9 categories: crawlability, indexability, security, URL structure, mobile, Core Web Vitals (including INP), structured data, JS rendering, IndexNow
- **E-E-A-T content quality** per the September 2025 Quality Rater Guidelines
- **Schema.org markup** detection, validation, and JSON-LD generation
- **GEO (Generative Engine Optimization)** for Google AI Overviews, ChatGPT, Perplexity, Bing Copilot
- **Local SEO** including Google Business Profile, NAP consistency, citations, reviews, map pack factors
- **Maps intelligence** with geo-grid rank tracking, GBP audit, competitor radius mapping
- **Image optimization** analysis covering alt text, WebP/AVIF conversion, IPTC/XMP metadata injection, lazy loading, CLS prevention
- **Google Images SERP** analysis via DataForSEO for competitive image search
- **XML sitemap** analysis and generation with industry-specific templates
- **Programmatic SEO** at scale with quality gates
- **Competitor comparison** page generation ("X vs Y" and "alternatives to X")
- **International SEO** with hreflang audit and DACH/FR/ES/JA cultural profiles
- **Strategic planning** with industry-specific templates
- **FLOW framework** with 41 evidence-led AI prompts across Find, Leverage, Optimize, Win, Local stages (CC BY 4.0)
- **Backlink profile analysis** with toxic link detection and competitor gap analysis (free APIs: Moz, Bing Webmaster, Common Crawl, verify crawler)
- **Google SEO APIs** integration: Search Console, PageSpeed Insights, CrUX field data (25-week history), Indexing API, GA4, PDF and Excel reports
- **Topic clustering** via SERP overlap analysis with hub-and-spoke architecture and interactive cluster map (community: Lutfiya Miller)
- **SXO** Search Experience Optimization with SERP-backward analysis and persona scoring (community: Florian Schmitz)
- **SEO drift monitoring** with SQLite-backed baselines and 17 comparison rules across 3 severity levels (community: Dan Colta)
- **E-commerce SEO** with product schema validation, Google Shopping intelligence, Amazon marketplace analysis (community: Matej Marjanovic)

## Install

Works on macOS, Linux, and Windows.

### Plugin marketplace (recommended, Claude Code 1.0.33+)
```
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@AgriciDaniel-claude-seo
```

### Manual (Unix, macOS, Linux)
```bash
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
```

### Windows (PowerShell)
```powershell
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1
```

Requires Python 3.10+ and Claude Code CLI 1.0.33+ (for the plugin marketplace flow).

## Quick start

```
claude
/seo audit https://your-site.com
```

That is it. Up to 18 AI agents run in parallel. You get a 0-100 health score and a prioritized action plan.

## All commands (v2.0.0)

| Command | What it does |
|---------|-------------|
| `/seo audit <url>` | Full site audit, up to 18 parallel AI agents, 0-100 health score |
| `/seo page <url>` | Deep single-page analysis |
| `/seo technical <url>` | Technical SEO across 9 categories |
| `/seo content <url>` | E-E-A-T content quality assessment |
| `/seo schema <url>` | Schema.org detection, validation, generation |
| `/seo sitemap <url>` | XML sitemap analysis or generation |
| `/seo images <url>` | Image optimization, WebP/AVIF conversion, Google Images SERP |
| `/seo geo <url>` | GEO for AI Overviews, ChatGPT, Perplexity, Bing Copilot |
| `/seo local <url>` | Google Business Profile, citations, reviews, map pack |
| `/seo maps [command]` | Geo-grid rank tracking, GBP audit, competitor radius |
| `/seo plan <type>` | Industry-specific strategic planning |
| `/seo programmatic` | Programmatic SEO at scale with quality gates |
| `/seo competitor-pages` | "X vs Y" comparison page generation |
| `/seo hreflang <url>` | International SEO and hreflang audit with cultural profiles |
| `/seo flow [stage] <url>` | FLOW framework: 41 evidence-led AI prompts |
| `/seo backlinks <url>` | Free backlink audit, toxic detection, competitor gap |
| `/seo google [cmd] <url>` | Google APIs: GSC, PSI, CrUX, Indexing, GA4 |
| `/seo cluster <seed>` | SERP-overlap topic clustering (community) |
| `/seo drift baseline <url>` | SEO drift monitoring, git for on-page SEO (community) |
| `/seo sxo <kw> <url>` | Search Experience Optimization (community) |
| `/seo ecommerce <url>` | E-commerce SEO with Shopping and Amazon (community) |
| `/seo dataforseo [cmd]` | Live SERP, keyword, backlink data (extension) |
| `/seo image-gen <desc>` | AI image generation for SEO assets (extension) |
| `/seo firecrawl [cmd]` | Full-site crawling with JS rendering (extension) |

## Health score methodology

Weighted 0-100 score across 7 categories:

| Category | Weight |
|----------|--------|
| Content Quality | 23% |
| Technical SEO | 22% |
| On-Page SEO | 20% |
| Schema / Structured Data | 10% |
| Performance (Core Web Vitals) | 10% |
| AI Search Readiness | 10% |
| Images | 5% |

Each audit produces a prioritized action plan with Critical, High, Medium, and Low severity levels.

## Industry detection

Claude SEO auto-detects your business type from homepage signals:

- **SaaS**: pricing pages, feature lists, documentation
- **Local Service**: phone numbers, addresses, service areas
- **E-commerce**: product pages, shopping carts
- **Publisher**: blogs, articles, author pages
- **Agency**: case studies, portfolios, client logos

Recommendations adapt to your specific industry.

## Extensions

- **Firecrawl**: Full-site crawling with JavaScript rendering for SPA and CSR sites. 4 commands: crawl, map, scrape, search.
- **DataForSEO**: Live SERP data, keyword volume and difficulty, backlink profiles, AI visibility tracking, competitor analysis. 22 commands across 9 API modules. Cost guardrails built in. Requires a DataForSEO API key.
- **Banana**: AI image generation via Google Gemini (nanobanana MCP) for OG images, hero graphics, product photos, infographics, and schema images. Requires a Google AI Studio API key.

## MCP integrations

Works with official Ahrefs MCP (@ahrefs/mcp), Semrush MCP server, and community servers for Google Search Console, PageSpeed Insights, DataForSEO, and Firecrawl.

## Community contributions

Four skills landed in v1.9.0 via the AI Marketing Hub Pro Hub Challenge. See [CONTRIBUTORS.md](https://github.com/AgriciDaniel/claude-seo/blob/main/CONTRIBUTORS.md) for full credits.

| Contributor | Submission | Integrated as |
|------------|-----------|---------------|
| **Lutfiya Miller** (Winner) | Semantic Cluster Engine | `seo-cluster` |
| **Florian Schmitz** | SXO Skill | `seo-sxo` |
| **Dan Colta** | SEO Drift Monitor | `seo-drift` |
| **Matej Marjanovic** | E-commerce + Cost Config | `seo-ecommerce` + cost guardrails |
| **Chris Muller** | Multi-lingual SEO | `seo-hreflang` cultural profiles |

## Ecosystem

- [Claude SEO](https://github.com/AgriciDaniel/claude-seo) - This project. Free AI SEO audit tool.
- [Claude Blog](https://github.com/AgriciDaniel/claude-blog) - Blog engine that consumes SEO findings. 19 sub-skills, 4 agents, 17 commands.
- [Claude Banana](https://github.com/AgriciDaniel/banana-claude) - AI image generation via Google Gemini.
- [Codex SEO](https://github.com/AgriciDaniel/codex-seo) - OpenAI Codex port of this project.

## Numbers

- 7,000+ GitHub stars
- 1,091 forks
- 31,000+ YouTube demo views
- 25 sub-skills (21 core + 1 orchestrator + 1 framework + 2 extension mirrors)
- 18 subagents (up to 18 run in parallel during /seo audit)
- 50+ slash commands
- 3 extensions (Firecrawl, DataForSEO, Banana)
- MIT licensed (CC BY 4.0 for FLOW prompts)
- $0 forever

## Links

- Website: https://claude-seo.md
- Repository: https://github.com/AgriciDaniel/claude-seo
- YouTube demo: https://www.youtube.com/watch?v=COMnNlUakQk
- Author: https://github.com/AgriciDaniel
- Skool community: https://www.skool.com/ai-marketing-hub

## License

MIT for skill code. CC BY 4.0 for bundled FLOW prompts. Free forever. No paid tiers.