Claude SEO: The Open-Source Universal SEO Skill That Turns Claude Code Into a Full SEO Agency

Claude SEO (also known by the domain claude-seo.md) is an open-source universal SEO skill for Claude Code built by AgriciDaniel. With over 5,300 GitHub stars and an MIT license, it is the most popular SEO skill in the Claude ecosystem — turning your terminal into a full SEO agency with 17 slash commands, 7 parallel subagents, and deep integration with Google SEO APIs, DataForSEO, and GEO (Generative Engine Optimization).

Latest version: v1.7.0 (March 28, 2026) — Free and open source under MIT License

Table of Contents

1. What Is Claude SEO and Why Does It Matter?
2. The 17 Slash Commands
3. GEO: The Flagship 2026 Feature
4. Google SEO API Integration
5. Architecture: Three-Layer Pyramid
6. DataForSEO MCP Extension
7. EEAT Analysis and Quality Gates
8. Installation Guide
9. Frequently Asked Questions

What Is Claude SEO and Why Does It Matter?

Claude SEO is not a SaaS platform or a browser extension. It is a Skill — a packaged set of instructions and subagents that runs inside Claude Code, Anthropic’s command-line AI assistant. Once installed, you can run any of 17 specialized SEO commands directly from your terminal.

? Claude Code (via Claude SEO skill)
  --> /seo audit https://yoursite.com
  --> /seo geo https://yoursite.com
  --> /seo google report core-web-vitals

The skill is designed for SEO professionals, content marketers, agency owners, and developers who need fast, repeatable, automated SEO analysis without juggling a dozen different tools. Everything runs through Claude Code’s terminal interface, and results come back as structured reports, charts, or even enterprise-grade PDFs.

Who Built It?

AgriciDaniel, the creator, designed Claude SEO as a universal layer that sits on top of Claude Code’s agentic capabilities. Rather than building separate tools for each SEO discipline — technical audits, content analysis, schema generation, local SEO — the skill unifies them into a single command set backed by a sophisticated multi-agent orchestration system.

The 17 Slash Commands

Claude SEO ships with 17 slash commands, each covering a distinct SEO discipline. Here is the complete list:

Command Walkthrough

Full Site Audit (/seo audit) is the flagship command. When you run it, Claude SEO dispatches multiple subagents in parallel — one for technical analysis, one for content quality, one for schema detection, one for page speed, and so on. Each subagent runs in its own isolated context and reports back. The main agent then consolidates everything into a single prioritized report.

Single Page Analysis (/seo page) is the lightweight counterpart — a deep dive into one URL covering title tags, meta descriptions, heading structure, content length, internal links, image optimization, and Core Web Vitals where available.

Schema Detection (/seo schema) scans a page for all three schema formats: JSON-LD, Microdata, and RDFa. It validates each detected schema against Schema.org standards and can generate missing markup on the fly — including Article, Product, FAQ, LocalBusiness, VideoObject, BroadcastEvent, and more.

Strategic Planning (/seo plan) is designed for SEO strategy development. It supports five site types: SaaS, local business, ecommerce, publisher, and agency. For each type, it generates a prioritized action plan based on industry best practices.

GEO: The Flagship 2026 Feature

GEO — Generative Engine Optimization — is the most important SEO development of 2026. Traditional SEO optimizes for Google’s classic blue-link search results. GEO optimizes for AI-generated answers produced by large language models embedded in search engines.

Why GEO Matters

Google AI Overviews, ChatGPT Search, Perplexity, and other AI-powered search engines now serve a significant share of search queries. When a user asks “What is the best CRM for small businesses?” an AI search engine may generate a synthesized answer drawing from multiple sources — and only cite a handful of them. GEO is about becoming one of those cited sources.

How Claude SEO Handles GEO

The /seo geo <url> command performs a comprehensive GEO audit:

• AI citability analysis — Evaluates whether your content is structured in a way that AI models can easily extract and cite. Optimal passages are typically 134–167 words, fact-rich, and clearly scoped.
• llms.txt support — Checks for the presence and quality of llms.txt, the emerging standard for telling AI crawlers how to interpret your site (similar to robots.txt but for LLMs).
• Entity clarity — Analyzes whether key entities (people, products, concepts) are clearly defined with unambiguous language.
• Authority signals — Measures brand authority indicators that AI models weigh when deciding whether to cite a source.
• Structured data for AI — Verifies that schema markup is complete enough for AI systems to parse and understand your content programmatically.

Claude SEO also includes quality gates specific to GEO campaigns — a warning triggers at 30+ location pages and a hard stop at 50+ pages without prior audit, preventing thin content from being mass-optimized for AI search.

Google SEO API Integration

Version 1.7.0 introduced direct integration with five Google APIs, giving Claude SEO the ability to pull live Google data without leaving the terminal.

API Credential Tiers

The skill implements a 4-tier credential system:

What You Can Do

• PageSpeed Insights + CrUX — Lab and field Core Web Vitals data: Largest Contentful Paint (LCP), Interaction to Next Paint (INP), Cumulative Layout Shift (CLS). Targets: LCP < 2.5s, INP < 200ms, CLS < 0.1.
• Search Console — Top queries, URL inspection, sitemap submission status, click-through rate analysis.
• Indexing API — Programmatically notify Google when pages are added, updated, or removed.
• GA4 — Organic traffic trends, top landing pages, device breakdown, country breakdown.
• PDF/HTML Reports — Generate A4-format enterprise reports with embedded charts (powered by WeasyPrint and matplotlib).

Architecture: Three-Layer Pyramid

Claude SEO is built on a three-layer pyramid model designed for efficiency and scalability.

              ┌─────────────────────┐
              │   Instruction Layer  │   SKILL.md (progressive disclosure)
              │     (~60 tokens)     │
              ├─────────────────────┤
              │  Orchestration Layer │   7+ parallel subagents
              │  (isolated contexts) │   dispatches tasks to workers
              ├─────────────────────┤
              │    Execution Layer   │   MCP servers, APIs, tools
              │ (Firecrawl, Google,  │
              │  DataForSEO, etc.)   │
              └─────────────────────┘

Layer 1: Instruction Layer

A lightweight SKILL.md file with YAML frontmatter that defines the 17 commands. Progressive disclosure means each command loads only its full instructions when invoked, keeping the base token cost around 60 tokens at rest.

Layer 2: Orchestration Layer

Seven parallel subagents running in isolated contexts. When you run /seo audit, the orchestrator dispatches dedicated agents for technical SEO, content quality, schema analysis, page speed, internal linking, image optimization, and security. Each agent operates independently and returns only its findings — no context pollution between agents.

Layer 3: Execution Layer

The actual tool calls — MCP servers for live data (Firecrawl for crawling, DataForSEO for SERP data, Google APIs for performance metrics), local scripts for parsing and analysis, and report generation pipelines.

DataForSEO MCP Extension

Beyond the built-in Google integrations, Claude SEO supports an extension system with DataForSEO MCP as its flagship add-on.

The DataForSEO extension adds 22 commands across 9 API modules:

• Live SERP data (Google, Bing, YouTube, etc.)
• Keyword research and suggestions
• Backlink analysis
• On-page API analysis
• Business listings and citations
• AI visibility checks and LLM mention tracking

Install it with the included install script:

./extensions/dataforseo/install.sh

After installation, you can run commands like:

/seo dataforseo serp best coffee shops
/seo dataforseo keywords "SEO tools"
/seo dataforseo backlinks https://example.com

There is also a Banana AI image generation extension that creates SEO-optimized visuals (OG images, hero images, infographics) using a creative director pipeline with Gemini image generation.

E-E-A-T Analysis and Quality Gates

E-E-A-T Framework

Claude SEO evaluates content against Google’s E-E-A-T framework (Experience, Expertise, Authoritativeness, Trustworthiness), updated to the September 2025 Quality Rater Guidelines. The analysis examines:

• Experience — Does the content demonstrate first-hand or real-world experience?
• Expertise — Are author credentials, qualifications, or relevant background shown?
• Authoritativeness — Is the site or author recognized as a trusted source in the field? Are there quality backlinks from authoritative domains?
• Trustworthiness — Is the site secure (HTTPS), transparent about its business, free of deceptive practices?

Quality Gates

Claude SEO implements hard guardrails to prevent low-quality mass generation:

These gates are designed to prevent SEO spam and align with Google’s quality guidelines. If you hit a hard stop, Claude SEO will refuse to proceed until you run a full audit or adjust the scope.

Other Technical Capabilities

• Core Web Vitals monitoring (LCP < 2.5s, INP < 200ms, CLS < 0.1)
• Schema markup detection across JSON-LD, Microdata, and RDFa formats
• Hreflang/i18n auditing for multilingual sites
• Image optimization analysis (alt text, dimensions, compression, lazy loading)
• Maps intelligence via /seo maps — geo-grid rank tracking, Google Business Profile audits, review sentiment analysis, competitor radius mapping

Installation Guide

Plugin Install (Recommended for Claude Code 1.0.33+)

/plugin marketplace add AgriciDaniel/claude-seo
/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

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

# Optimize for AI search
/seo geo https://example.com

# Get Google performance data
/seo google psi https://example.com

Frequently Asked Questions

Is Claude SEO completely free?

Yes. Claude SEO is released under the MIT License and is entirely free to use. The only potential costs are Claude Code usage fees (token consumption) and optional paid API keys for Google APIs or DataForSEO if you enable those integrations.

Does Claude SEO work with other AI coding tools?

The original claude-seo is designed for Claude Code, but the creator has also published codex-seo — a port adapted for Codex with 26 workflows and 24 TOML-based agents.

Do I need Google API keys?

For basic SEO analysis (audit, page, schema), no keys are needed. Google APIs are optional and can be configured incrementally using the 4-tier credential system.

What types of sites does Claude SEO support?

Claude SEO works with any publicly accessible website. The /seo plan command specifically supports five verticals: SaaS, local business, ecommerce, publisher, and agency.

Can Claude SEO generate reports?

Yes. Since v1.7.0, the /seo google report [type] command generates A4-format PDF reports with embedded charts, suitable for client deliverables or internal documentation.

How does Claude SEO compare to traditional SEO tools?

Traditional SEO tools like Ahrefs, Semrush, and Moz provide broad dashboards and historical data. Claude SEO focuses on actionable, AI-driven analysis delivered through a terminal interface — particularly strong at GEO, schema generation, and multi-agent parallel audits. Many users combine both: use Claude SEO for deep analysis and automated workflows, and traditional tools for rank tracking and backlink monitoring.

Summary

Claude SEO represents a new category of SEO tooling — agentic SEO powered by AI orchestration rather than traditional dashboards. With 17 commands, 7 parallel subagents, GEO optimization for AI search engines, direct Google API integration, and an extension system that connects to DataForSEO and image generation pipelines, it delivers capabilities that would otherwise require a team of specialists and a stack of paid subscriptions.

The 2026 edition (v1.7.0+) is the most capable release to date, bringing Google SEO APIs, GEO analysis, PDF reporting, and enhanced security hardening. For SEO professionals ready to work from the command line and embrace AI-native workflows, Claude SEO is an essential addition to the toolkit.

mindmap
  root((Claude SEO\n2026))
    Audits
      Full site audit
      Single page analysis
      Technical SEO
      Content quality
    AI Search (GEO)
      AI Overviews
      ChatGPT Search
      Perplexity
      llms.txt
    Google APIs
      PageSpeed + CrUX
      Search Console
      Indexing API
      GA4
      PDF Reports
    Schema & Data
      JSON-LD
      Microdata
      RDFa
      VideoSchema
    Local & Maps
      GBP Audit
      Geo-grid tracking
      Review analysis
      Citations
    Extensions
      DataForSEO (22 commands)
      Banana AI images
      Firecrawl backlinks

This article is based on research of the AgriciDaniel/claude-seo repository, claude-seo.md documentation, and community analysis. All technical details are current as of May 2026.