Skip to main content
claude-seo - AI Agents | SkillsLLM
Home AI Agents claude-seo 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.
ai ai-seo claude-code claude-code-skill marketing-automation
# Add to your Claude Code skills
git clone https://github.com/AgriciDaniel/claude-seo
Claude SEO - SEO Audit Skill for Claude Code
Comprehensive SEO analysis skill for Claude Code. Covers 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, Google SEO APIs (Search Console, PageSpeed, CrUX, GA4), PDF report generation, and strategic planning.
Blog: Full breakdown of the Claude Code SEO stack | v1.7.2 release: Firecrawl backlink analysis
Table of Contents
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
open-source
seo
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
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash
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: /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 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.
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.
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.
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.5sINP (Interaction to Next Paint): Target < 200msCLS (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 signalsExpertise : Author credentials and depthAuthoritativeness : Industry recognitionTrustworthiness : 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 dataSearch Console : Top queries, URL inspection, sitemap statusIndexing API : Notify Google of new/updated/removed URLsGA4 : Organic traffic, top landing pages, device/country breakdownPDF 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 (16 + 3 extensions)
~/.claude/agents/seo-*.md # Subagents (11 + 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
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash
MCP Integr 56,706
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
An open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms
CLI Tools ai-skills antigravity
The agent that grows with you
AI Agents ai ai-agent
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
AI Agents agent-skills ai-agents
