Agent Skills

seo-page

Universal SEO skill for Claude Code. 19 sub-skills, 12 subagents, 3 extensions (DataForSEO, Firecrawl, Banana). Technical SEO, E-E-A-T, schema, GEO/AEO, backlinks, local SEO, maps intelligence, Google APIs, and PDF/Excel reporting.

Installation
CLI
npx skills add https://github.com/agricidaniel/claude-seo --skill seo-page

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 5/9/2026

Claude SEO

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.

SEO Command Demo

CI
Claude Code Skill
License: MIT
Version

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

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 flag irm ... | iex as a supply chain risk (downloading and executing remote code with no verification). The git clone approach lets you inspect the script at claude-seo\install.ps1 before 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:

SEO Audit Demo

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 - turn-based SEO battle scene with Guild Ledger

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:

  1. /seo audit https://example.com -- identify content gaps and technical issues
  2. /seo backlinks https://example.com -- analyze link profile and competitor gaps
  3. /blog write "target keyword" -- create SEO-optimized blog posts
  4. /seo image-gen hero "blog topic" -- generate hero images (banana extension)
  5. /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.