# Claude SEO

> Claude SEO is a free, open-source SEO toolkit that runs inside Claude Code. It combines deterministic checks, specialist review, and implementation guidance in a local terminal workflow. - @AgriciDaniel, February 2026

## The idea

Give Claude Code a comprehensive SEO analysis skill and let it coordinate the work. The v2.3.1 toolkit contains 18 specialist agents and can run up to 15 concurrently, subject to the selected workflow. It produces evidence, a vendor health-score heuristic, and a prioritized action plan. The score is not a Google metric or a promise of rankings, traffic, or citations.

## What it covers (v2.3.1)

- **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), eligible Indexing API workflows, 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 setup
/seo doctor
/seo audit https://your-site.com
```

Setup provisions the managed runtime, doctor checks it without changing state, and audit coordinates the applicable specialists. You get supporting findings, a 0-100 vendor heuristic, and a prioritized action plan.

## What changed in v2.3.1

Three releases shipped on September 10, 2026 from one review of every open pull request (46) and issue (17), each pull request tested at its exact head:

- v2.2.6: moved the launcher from `bin/` to `scripts/` so the claude.ai-hosted marketplace accepts the plugin; closed a cache-path traversal and a WHOIS referral SSRF; refused the RFC 6598 range; raised WeasyPrint to 70.0 and requests to 2.34.2; locked the cost ledgers; added Windows, macOS and pip-audit CI
- v2.3.0: refreshed Google Search guidance through September 10, 2026; added the `CLAUDE_SEO_LOCAL_TARGETS` allowlist and proxy validation to the SSRF guard; hardened the JSON-LD hook; corrected AI crawler guidance (ClaudeBot trains, Claude-SearchBot searches); landed thirteen community pull requests with review fixes
- v2.3.1: five judgment-heavy agents run on Opus; Keywords Everywhere joins as a free backlinks fallback; setup failures show the failing stage's output; every extension installer writes `~/.claude.json` atomically
- Passed 763 automated tests plus strict consistency, portability, secret, dependency-vulnerability and plugin-manifest checks

## All commands (v2.3.1)

| Command | What it does |
|---------|-------------|
| `/seo [command] [url]` | Routes a selected goal to the relevant specialist workflows and synthesizes the result |
| `/seo audit <url>` | Full site audit with up to 15 concurrent specialists and a vendor health-score heuristic |
| `/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 <url> [keyword]` | 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) |
| `/seo content-brief [url-or-keyword] [page-type]` | Research-backed brief with intent, competitive coverage, gaps, evidence, outline, and internal links |

## 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. The aggregate score organizes Claude SEO findings; it is not a Google metric and should not replace the evidence behind each finding.

## 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. 23 data commands across 9 API modules. Cost guardrails built in. Requires a DataForSEO API login and generated API password.
- **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.
- **Ahrefs**: Live backlink, keyword, and competitor data through the Ahrefs MCP integration.
- **SE Ranking**: Rank tracking and competitive research through the SE Ranking integration.
- **Profound**: AI visibility research and citation monitoring through the Profound integration.
- **Bing Webmaster**: Bing search performance and URL submission workflows.
- **Unlighthouse**: Site-wide Lighthouse auditing for performance and quality checks.

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

- 16,704 GitHub stars (checked 2026-09-10)
- 2,448 forks (checked 2026-09-10)
- Demo: https://www.youtube.com/watch?v=COMnNlUakQk
- 25 sub-skills (21 core + 1 orchestrator + 1 framework + 2 extension mirrors)
- 18 specialist agents (up to 15 run concurrently during applicable audits)
- 32 user-invocable `/seo` commands
- 8 extensions (Firecrawl, DataForSEO, Banana, Ahrefs, SE Ranking, Profound, Bing Webmaster, Unlighthouse)
- 763 automated tests passed for the v2.3.1 release
- 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.