Claude SEO: SEO 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 testable recommendations grounded in primary-source guidance from Google.
Two versions of this skill.
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.
Real results
Google Search Console for a site started 23 March 2026 and run on this workflow: total clicks and impressions across its first three months, through 12 June 2026.
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.
Run a full audit and watch parallel agents fan out across the site:
Watch the full demo on YouTube
Table of Contents
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
/seo setup
The explicit setup step creates an isolated Python environment in Claude's
persistent plugin data and installs Playwright Chromium. Check it at any time
with /seo doctor. No global Python packages or PATH shims are created.
Manual Install (Unix / macOS / Linux)
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh
One-liner (curl, review then run)
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
32 user-invocable /seo commands across the orchestrator, its sub-skills, and 8 MCP extensions. Full reference in docs/COMMANDS.md.
| Command |
Description |
/seo setup |
Create or refresh the isolated Python runtime and Chromium |
/seo doctor |
Check runtime readiness without changing the system |
/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 content-brief <topic> |
Detailed content brief: target keywords, outline, internal links |
/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) |
/seo ahrefs [command] <url> |
Backlinks, organic keywords, and content data via the official Ahrefs MCP (extension) |
/seo seranking [command] |
AI Share-of-Voice across ChatGPT, Gemini, Perplexity, AI Overviews, AI Mode (extension) |
/seo profound [command] |
LLM citation tracking with time-series data (extension) |
/seo bing [command] <url> |
Bing Webmaster Tools + IndexNow URL submission (extension) |
/seo unlighthouse <url> |
Multi-page Lighthouse runner, runs locally (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 Chrome's field-data tools (CrUX API, PageSpeed Insights) on September 9, 2024 (Lighthouse is a lab tool and never reported FID), 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. Mobile and desktop are measured separately. CrUX History (25-week trend) is included in the Tier 0 free credential set.
How does Claude SEO assess E-E-A-T?
E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) is evaluated against the Search Quality Rater Guidelines, last updated September 2025 with YMYL expanded to include political and social topics. Experience signals: original research, case studies, first-hand photos. Expertise: author credentials and topical depth. Authoritativeness: external citations and brand mentions. Trustworthiness, the most heavily weighted of the four: contact info, secure HTTPS, transparent corrections, date stamps. Before scoring sub-factors, Claude SEO applies Google's own Who / How / Why heuristic from the helpful-content guide. Generative AI content is fine if it meets Search Essentials; it crosses into spam when used to scale low-value pages, which seo-content humanize and seo-content verify are designed to detect.
What Schema.org types does Claude SEO support?
JSON-LD is the preferred format (Google's stated preference). Claude SEO detects, validates, and generates the active Schema.org types documented in skills/seo/references/schema-types.md, including organization, article, product, local, event, job, course, software/application, service, Q&A, and video patterns. FAQPage: Google stopped showing FAQ rich results for all sites on May 7, 2026; it has no Google rich-result benefit. Keep it only for non-Google or internal semantics if needed. Deprecated and never recommended: HowTo (rich results removed September 2023), SpecialAnnouncement (July 2025), ClaimReview, VehicleListing, EstimatedSalary, LearningVideo, CourseInfo carousel (all retired June 2025). Replacement guidance: skills/seo-schema/references/deprecated-types-2024-2026.md.
How does Claude SEO optimize for AI search?
Aligned with Google's AI Optimization Guide, which states that "AEO" and "GEO" are rebranded labels for SEO. AI Overviews and AI Mode are grounded in the same ranking systems as classic Search; pages must be indexed and eligible for snippet display to appear in any AI feature. Claude SEO scores passage citability (optimal 134-167 word self-contained answer blocks), question-based heading hierarchy, attribution density, structured data coverage, and entity presence across Wikipedia, Reddit, YouTube, and LinkedIn. The seo-geo skill includes evidence-based reframes of three popular myths: llms.txt is not currently a citation lever (primary-source evidence), content chunking is not required, and AI-specific keyword rewriting is unnecessary because synonym understanding is sufficient.
Which Google SEO APIs does Claude SEO integrate with?
A 4-tier credential system lets you start with zero keys and add data as needed. Every tier delivers real value at its level:
| Tier |
Credentials |
APIs Unlocked |
| 0 |
API key |
PageSpeed Insights, CrUX, CrUX History (25-week trends) |
| 1 |
+ OAuth or Service Account |
+ Search Console (queries, URL Inspection, sitemap status), Indexing API |
| 2 |
+ GA4 property config |
+ GA4 organic traffic, top landing pages, device / country breakdown |
| 3 |
+ Ads developer token |
+ Keyword Planner search volume and competition data |
PDF reports are generated via WeasyPrint (A4 layout) with matplotlib charts at 200 DPI. Run /seo google setup for the credential wizard. All credentials live under ~/.config/claude-seo/ with 0o600 permissions; nothing is checked into the repo.
How does Claude SEO handle local SEO?
Three layers. Google Business Profile signals: categories, hours, photos, posts, products, attributes. NAP consistency across citations: name, address, phone matched against major directories with deviation flagging. Review intelligence: rating trends, sentiment, response coverage. For multi-location businesses, Claude SEO enforces a 30-page warning threshold and a 50-page hard stop to prevent doorway-page violations (configurable). The /seo maps workflow adds geo-grid rank tracking, GBP profile auditing, and competitor radius mapping. Local schema generation covers LocalBusiness with all required and recommended properties (geo coordinates, opening hours, areaServed). Phase F (v2) added a GBP deprecation linter that detects retired chat-field references and .business.site URLs.
|
Manual audit |
Agency engagement |
Commercial SEO audit tool |
Claude SEO |
| Time per audit |
4-8 hrs senior SEO time |
1-3 weeks turnaround |
10-45 min crawl + report |
10-15 min |
| Cost |
High (billable hours) |
$2k-$15k+ project |
$99-$999/mo subscription |
Free skill + Claude Code subscription |
| Repeatable |
Inconsistent across analysts |
Inconsistent across engagements |
Yes |
Yes, deterministic + scriptable |
| Output format |
Wall-of-findings PDF |
Branded slide deck |
Web dashboard, CSV exports |
Markdown + PDF + JSON, local files |
| Custom benchmarks |
Manual per analyst |
Agency-specific frameworks |
Vendor-fixed |
Edit local SKILL.md |
| Data leaves machine? |
No (your spreadsheet) |
Yes (sent to agency) |
Yes (uploaded to vendor) |
No, fully local by default |
| Lock-in |
None |
High |
High (data-exit friction) |
None. MIT, your files. |
| AI search awareness |
Depends on analyst |
Depends on agency seniority |
Lagging (typically 6-12 mo behind) |
Google AI Optimization Guide (May 2026), Sept 2025 QRG, INP-not-FID, GEO/AEO=SEO reframe, llms.txt evidence-based posture |
| Falsifiability per finding |
No |
No |
No |
Yes. Every recommendation carries a "how would we know this failed?" check + leading indicator |
Cost benchmarks: manual audit assumes a senior SEO consultant at typical agency billable rates; agency engagement based on common discovery/audit deliverable scopes; commercial-tool subscriptions reflect published mid-tier pricing across the SEO audit category (Ahrefs, Semrush, Sitebulb, Screaming Frog). Your numbers may differ.
Use cases
SEO agency lead running 10 client sites. Replaces the quarterly "deep audit" ritual with a weekly Monday-morning /seo audit run per site. Time to deliver a client health-score email drops from 4 hours to 12 minutes; coverage goes from quarterly to weekly without billing more hours. The drift baseline catches regressions between audits so the client conversation moves from "look at this snapshot" to "here is what changed this week."
In-house SEO lead at a 50-person SaaS company. Runs /seo audit 24 hours before each quarterly business review. Catches the items the platform UI buries (broken canonical chains on programmatic pages, schema deprecation after Google's June 2025 retirement wave, AI-citability gaps that erode SERP-to-AI-Overview pickup, expired-domain heritage on acquired blog assets) before the CMO asks why organic traffic is down in front of the board.
Freelance SEO consultant onboarding a new client. Runs /seo audit on the discovery call. Anchors the engagement scope with a real 0-100 score, 3 prioritized critical findings, and a falsifiability check on each recommendation, instead of a vague "I'll take a look and get back to you." Closes more retainers because the proof of value happens during the call, not after the proposal.
Sample Output
Claude SEO writes real markdown reports as its primary deliverable. Below is the first ~50 lines of a /seo schema https://rankenstein.pro/about audit verbatim. The actual structure, headers, and grading format the plugin produces follows.
SCHEMA-REPORT.md: first 50 lines of a real audit
# Schema Markup Report: rankenstein.pro/about
**URL:** https://rankenstein.pro/about
**Date:** 2026-02-09
**Format Detected:** JSON-LD (3 blocks) | No Microdata | No RDFa
---
## Summary
| Metric | Value |
|--------|-------|
| **JSON-LD Blocks** | 3 |
| **Schema Types** | Organization, WebSite, SoftwareApplication |
| **Critical Issues** | 2 |
| **Warnings** | 5 |
| **Passed Checks** | 18 |
| **Overall Grade** | B+ (solid foundation, actionable gaps) |
---
##
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, E-E-A-T content quality, Schema.org markup, AI search (GEO), local, e-commerce, and international SEO, and every audit ends in a prioritized action plan.