Claude Seo
Universal SEO skill for Claude Code. 13 sub-skills, 7 subagents, extensions system with DataForSEO MCP integration. Technical SEO, E-E-A-T, schema, GEO/AEO, and strategic planning.
Ask AI about Claude Seo
Powered by Claude · Grounded in docs
I know everything about Claude Seo. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Claude SEO - SEO Audit Skill for Claude Code
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.
Table of Contents
- Installation
- Quick Start
- Commands
- Features
- Architecture
- Extensions
- Showcase
- Ecosystem
- Documentation
- Requirements
- Uninstall
- Contributing
Installation
Plugin Install (Claude Code 1.0.33+)
# Add marketplace (one-time)
/plugin marketplace add AgriciDaniel/claude-seo
# Install plugin
/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
One-liner (curl)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash
Or via install.cat:
curl -fsSL install.cat/AgriciDaniel/claude-seo | bash
Prefer 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.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 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.
Quick Start
# 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.com
Demo:
Watch the full demo on YouTube
/seo audit: full site audit with parallel subagents:
Commands
| 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) |
/seo programmatic [url|plan]
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
/seo competitor-pages [url|generate]
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
/seo hreflang [url]
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)
Features
Core Web Vitals (Current Metrics)
- 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.
E-E-A-T Analysis
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
Schema Markup
- 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)
AI Search Optimization (GEO)
New for 2026 - optimize for:
- Google AI Overviews
- ChatGPT web search
- Perplexity
- Other AI-powered search
Google SEO APIs (New in v1.7.0)
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 |
Local SEO & Maps Intelligence (New in v1.6.0)
- Google Business Profile optimization
- NAP consistency auditing
- Citation and review analysis
- Geo-grid rank tracking and competitor radius mapping
Quality Gates
- Warning at 30+ location pages
- Hard stop at 50+ location pages
- Thin content detection per page type
- Doorway page prevention
Architecture
~/.claude/skills/seo/ # Main orchestrator skill
~/.claude/skills/seo-*/ # Sub-skills (21 + 3 extensions)
~/.claude/agents/seo-*.md # Subagents (15 + 2 extensions)
Video & Live Schema (New)
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.
Recently Added
- 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
Requirements
- Python 3.10+
- Claude Code CLI
- Optional: Playwright for screenshots
- Optional: Google API credentials for enriched data (see
/seo google setup)
Uninstall
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh
One-liner (curl)
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash
MCP Integrations
Integrates 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.
Extensions
Optional add-ons that integrate external data sources via MCP servers.
DataForSEO
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 name
See DataForSEO Extension for full documentation.
Banana (AI Image Generation)
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" 3
See Banana Extension for full documentation. Already using standalone Claude Banana? The extension reuses your existing nanobanana-mcp setup.
Firecrawl (Site Crawling)
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.com
See Firecrawl Extension for full documentation.
Showcase
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.
Ecosystem
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
Documentation
Community Contributors
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.
License
MIT License - see LICENSE for details.
Contributing
Contributions welcome! Please read CONTRIBUTING.md before submitting PRs.
Built for Claude Code by @AgriciDaniel
Publishing Pipeline
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.
Author
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