Comprehensive SEO analysis skill for Claude Code. 21 core sub-skills covering technical SEO, on-page analysis, content quality (E-E-A-T), schema markup, image optimization, sitemap architecture, AI search optimization (GEO), local SEO, maps intelligence, semantic topic clustering, search experience optimization (SXO), SEO drift monitoring, e-commerce SEO, international SEO with cultural profiles, FLOW framework integration, Google SEO APIs (Search Console, PageSpeed, CrUX, GA4), PDF report generation, and strategic planning.
Using Codex instead of Claude Code? Use Codex SEO, the Codex-first port of this project with Codex skills, TOML agents, plugin packaging, deterministic runners, and the same SEO workflow surface.
- Installation
- Quick Start
- Commands
- Features
- Architecture
- Extensions
- Showcase
- Ecosystem
- Documentation
- Requirements
- Uninstall
- Contributing
# Add marketplace (one-time)
/plugin marketplace add AgriciDaniel/claude-seo
# Install plugin
/plugin install claude-seo@AgriciDaniel-claude-seogit clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.shOne-liner (curl)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bashOr via install.cat:
curl -fsSL install.cat/AgriciDaniel/claude-seo | bashPrefer to review the script before running?
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh # review
bash install.sh # run when satisfied
rm install.shgit clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1Why git clone instead of
irm | iex? Claude Code's own security guardrails flagirm ... | iexas a supply chain risk (downloading and executing remote code with no verification). The git clone approach lets you inspect the script atclaude-seo\install.ps1before running it.
# Start Claude Code
claude
# Run a full site audit
/seo audit https://example.com
# Analyze a single page
/seo page https://example.com/about
# Check schema markup
/seo schema https://example.com
# Generate a sitemap
/seo sitemap generate
# Optimize for AI search
/seo geo https://example.comWatch the full demo on YouTube
/seo audit: full site audit with parallel subagents:
| Command | Description |
|---|---|
/seo audit <url> |
Full website audit with parallel subagent delegation |
/seo page <url> |
Deep single-page analysis |
/seo sitemap <url> |
Analyze existing XML sitemap |
/seo sitemap generate |
Generate new sitemap with industry templates |
/seo schema <url> |
Detect, validate, and generate Schema.org markup |
/seo images <url> |
Image optimization analysis |
/seo technical <url> |
Technical SEO audit (9 categories) |
/seo content <url> |
E-E-A-T and content quality analysis |
/seo geo <url> |
AI Overviews / Generative Engine Optimization |
/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] [url] |
Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |
/seo google report [type] |
Generate PDF/HTML report with charts (cwv-audit, gsc-performance, full) |
/seo backlinks <url> |
Backlink profile analysis (free: Moz, Bing, Common Crawl) |
/seo cluster <seed-keyword> |
SERP-based semantic clustering and content architecture |
/seo sxo <url> |
Search Experience Optimization: page-type, user stories, personas |
/seo drift baseline <url> |
Capture SEO baseline for change monitoring |
/seo drift compare <url> |
Compare current state to stored baseline |
/seo drift history <url> |
Show drift history over time |
/seo ecommerce <url> |
E-commerce SEO: product schema, marketplace intelligence |
/seo firecrawl [command] <url> |
Full-site crawling and site mapping (extension) |
/seo dataforseo [command] |
Live SEO data via DataForSEO (extension) |
/seo image-gen [use-case] <desc> |
AI image generation for SEO assets (extension) |
Programmatic SEO Analysis & Planning
Build SEO pages at scale from data sources with quality safeguards.
Capabilities:
- Analyze existing programmatic pages for thin content and cannibalization
- Plan URL patterns and template structures for data-driven pages
- Internal linking automation between generated pages
- Canonical strategy and index bloat prevention
- Quality gates: WARNING at 100+ pages, HARD STOP at 500+ without audit
Competitor Comparison Page Generator
Create high-converting "X vs Y" and "alternatives to X" pages.
Capabilities:
- Structured comparison tables with feature matrices
- Product schema markup with AggregateRating
- Conversion-optimized layouts with CTA placement
- Keyword targeting for comparison intent queries
- Fairness guidelines for accurate competitor representation
Hreflang / i18n SEO Audit & Generation
Validate and generate hreflang tags for multi-language sites.
Capabilities:
- Generate hreflang tags (HTML, HTTP headers, or XML sitemap)
- Validate self-referencing tags, return tags, x-default
- Detect common mistakes (missing returns, invalid codes, HTTP/HTTPS mismatch)
- Cross-domain hreflang support
- Language/region code validation (ISO 639-1 + ISO 3166-1)
- LCP (Largest Contentful Paint): Target < 2.5s
- INP (Interaction to Next Paint): Target < 200ms
- CLS (Cumulative Layout Shift): Target < 0.1
Note: INP replaced FID on March 12, 2024. FID was fully removed from all Chrome tools on September 9, 2024.
Updated to September 2025 Quality Rater Guidelines:
- Experience: First-hand knowledge signals
- Expertise: Author credentials and depth
- Authoritativeness: Industry recognition
- Trustworthiness: Contact info, security, transparency
- Detection: JSON-LD (preferred), Microdata, RDFa
- Validation against Google's supported types
- Generation with templates
- Deprecation awareness:
- HowTo: Deprecated (Sept 2023)
- FAQ: Restricted to gov/health sites (Aug 2023)
- SpecialAnnouncement: Deprecated (July 2025)
New for 2026 - optimize for:
- Google AI Overviews
- ChatGPT web search
- Perplexity
- Other AI-powered search
Direct integration with Google's SEO data:
- PageSpeed Insights + CrUX: Lab and field Core Web Vitals data
- Search Console: Top queries, URL inspection, sitemap status
- Indexing API: Notify Google of new/updated/removed URLs
- GA4: Organic traffic, top landing pages, device/country breakdown
- PDF Reports: Enterprise A4 reports with charts via WeasyPrint + matplotlib
4-tier credential system — get value at every level:
| Tier | Auth | APIs |
|---|---|---|
| 0 | API key | PSI, CrUX, CrUX History |
| 1 | + OAuth/SA | + GSC, URL Inspection, Indexing |
| 2 | + GA4 config | + GA4 organic traffic |
| 3 | + Ads token | + Keyword Planner |
- Google Business Profile optimization
- NAP consistency auditing
- Citation and review analysis
- Geo-grid rank tracking and competitor radius mapping
- Warning at 30+ location pages
- Hard stop at 50+ location pages
- Thin content detection per page type
- Doorway page prevention
~/.claude/skills/seo/ # Main orchestrator skill
~/.claude/skills/seo-*/ # Sub-skills (21 + 3 extensions)
~/.claude/agents/seo-*.md # Subagents (15 + 2 extensions)
Additional schema types for video content, live streaming, and key moments:
- VideoObject: Video page markup with thumbnails, duration, upload date
- BroadcastEvent: LIVE badge support for live streaming content
- Clip: Key moments / chapters within videos
- SeekToAction: Enable seek functionality in video rich results
- SoftwareSourceCode: Open source and code repository pages
See schema/templates.json for ready-to-use JSON-LD snippets.
- Programmatic SEO skill (
/seo programmatic) - Competitor comparison pages skill (
/seo competitor-pages) - Multi-language hreflang validation (
/seo hreflang) - Video & Live schema types (VideoObject, BroadcastEvent, Clip, SeekToAction)
- Google SEO quick-reference guide
- Python 3.10+
- Claude Code CLI
- Optional: Playwright for screenshots
- Optional: Google API credentials for enriched data (see
/seo google setup)
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.shOne-liner (curl)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bashIntegrates with MCP servers for live SEO data, including official servers from Ahrefs (@ahrefs/mcp) and Semrush, plus community servers for Google Search Console, PageSpeed Insights, and DataForSEO. See MCP Integration Guide for setup.
Optional add-ons that integrate external data sources via MCP servers.
Live SERP data, keyword research, backlinks, on-page analysis, content analysis, business listings, AI visibility checking, and LLM mention tracking. 22 commands across 9 API modules.
# Install (requires DataForSEO account)
./extensions/dataforseo/install.sh# Example commands
/seo dataforseo serp best coffee shops
/seo dataforseo keywords seo tools
/seo dataforseo backlinks example.com
/seo dataforseo ai-mentions your brand
/seo dataforseo ai-scrape your brand nameSee DataForSEO Extension for full documentation.
Generate SEO images (OG previews, blog heroes, product photos, infographics) using the Claude Banana Creative Director pipeline.
# Install extension
./extensions/banana/install.sh# Example commands
/seo image-gen og "Professional SaaS dashboard"
/seo image-gen hero "AI-powered content creation"
/seo image-gen batch "Product photography" 3See Banana Extension for full documentation. Already using standalone Claude Banana? The extension reuses your existing nanobanana-mcp setup.
Full-site crawling and URL discovery using the Firecrawl MCP server.
# Install extension
./extensions/firecrawl/install.sh# Example commands
/seo firecrawl crawl https://example.com
/seo firecrawl map https://example.comSee Firecrawl Extension for full documentation.
Community projects built on top of Claude SEO:
|
Claude SEO Dungeon -- a 16-bit gamified dungeon crawler that turns SEO audits into boss battles. Built on Claude SEO v1.9.0 with Phaser 3, every detected issue becomes a demon and every fix becomes a real commit to your codebase. The Guild Ledger streams Claude's tool calls in real time as you fight. Built by @avalonreset -- live at seodungeon.com. |
Want your project featured here? Open an issue with a link.
Claude SEO is part of a family of Claude Code skills that work together:
| Skill | What it does | How it connects |
|---|---|---|
| Claude SEO | SEO analysis, audits, schema, GEO | Core -- analyzes sites, generates action plans |
| Claude Blog | Blog writing, optimization, scoring | Companion -- write content optimized by SEO findings |
| Claude Banana | AI image generation via Gemini | Shared -- generates images for SEO assets and blog posts |
| Codex SEO | Codex-first SEO skill suite | Port -- same SEO system adapted for Codex skills, TOML agents, plugins, and deterministic runners |
| AI Marketing Claude | Copywriting, emails, social, ads, funnels, CRO | Community -- post-audit marketing action from SEO findings |
| FLOW | Evidence-led SEO framework (41 AI prompts, CC BY 4.0) | Knowledge base — powers seo-flow prompts |
Workflow example:
/seo audit https://example.com-- identify content gaps and technical issues/seo backlinks https://example.com-- analyze link profile and competitor gaps/blog write "target keyword"-- create SEO-optimized blog posts/seo image-gen hero "blog topic"-- generate hero images (banana extension)/seo geo https://example.com/blog/post-- optimize for AI citations
v1.9.0 includes contributions from the AI Marketing Hub Pro Hub Challenge:
| Contributor | Contribution |
|---|---|
| Lutfiya Miller (Winner) | Semantic Cluster Engine → seo-cluster |
| Florian Schmitz | SXO Skill → seo-sxo |
| Dan Colta | SEO Drift Monitor → seo-drift |
| Chris Muller | Multi-lingual SEO → seo-hreflang enhancements |
| Matej Marjanovic | E-commerce + DataForSEO Cost Config → seo-ecommerce + cost guardrails |
See CONTRIBUTORS.md for full details and original repo links.
MIT License - see LICENSE for details.
Contributions welcome! Please read CONTRIBUTING.md before submitting PRs.
Built for Claude Code by @AgriciDaniel
For a full GUI-based publishing workflow from SEO research to published content, see Rankenstein - the AI content engine built on the same SEO principles.
Built by Agrici Daniel - AI Workflow Architect.
- Blog - Deep dives on AI marketing automation
- AI Marketing Hub - Free community, 2,800+ members
- YouTube - Tutorials and demos
- All open-source tools