Claude SEO: Open‑Source AI Site Audit and Optimization Tool

Claude SEO

Claude SEO is an open‑source skill for Claude Code that turns the chatbot into a full‑blown AI‑powered SEO engine. It lets you:

  • Run a complete site audit that covers technical SEO, content E‑E‑A‑T, on‑page signals, and core‑web‑vitals.
  • Drill down into a single page for deep content and schema analysis.
  • Validate and automatically generate Schema.org markup for pages, products, videos, and more.
  • Build or review XML sitemaps, including new programmatic sitemap generation.
  • Check and optimize for AI‑search (Geospatial Optimisation, Google AI Overviews, ChatGPT web search, etc.).
  • Plan and execute programmatic SEO and competitor comparison pages.
  • Validate and create hreflang tags for multilingual sites.

The whole skill is packaged as a single skill bundle that can be installed on any machine that has Python 3.8+ and Claude Code.


Quick Install

All we need is a single line of shell or PowerShell and you have the skill ready.

Unix / macOS / Linux

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.ps1 | iex

Manual Install (clone repo)

git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
./install.sh

After installation you’ll see a new skill folder under ~/.claude/skills/seo/.


Getting Started with Claude Code

# Launch Claude Code
claude

Once inside the CLI, you can start any /seo command. The cheat‑sheet below shows the most common ones.


Core Commands

Command Purpose Example
/seo audit <url> Full site audit (parallel sub‑agents) /seo audit https://example.com
/seo page <url> Deep single‑page analysis /seo page https://example.com/about
/seo sitemap <url> Analyse existing XML sitemap /seo sitemap https://example.com/
/seo sitemap generate Build new sitemap with industry templates /seo sitemap generate
/seo schema <url> Detect, validate, and generate Schema.org markup /seo schema https://example.com/
/seo images <url> Image optimisation audit /seo images https://example.com/
/seo technical <url> 8‑category technical SEO audit /seo technical https://example.com/
/seo content <url> E‑E‑A‑T and content quality check /seo content https://example.com/
/seo geo <url> AI‑search optimisation /seo geo https://example.com/
/seo plan <type> Strategic SEO plan (e.g. saas, ecommerce) /seo plan ecommerce
/seo programmatic <url> Programmatic SEO analysis & planning /seo programmatic https://example.com/
/seo competitor‑pages <url> Build “X vs Y” comparison pages /seo competitor‑pages https://example.com/competitor
/seo hreflang <url> i18n hreflang audit and generation /seo hreflang https://example.com/

Inside the Skill

The skill folder structure mirrors the CLI commands:

~/.claude/skills/seo/
 ├── agents/        # sub‑agents for each command
 ├── hooks/         # hooks for schema and other extensions
 ├── scripts/       # helper scripts (install.sh, uninstall.sh)
 ├── agents/seo-*.md
 └── seo/*.md       # command definitions

The skills/seo/ directory contains all documentation and code that powers the skill. Contributions are welcome—open a PR or file an issue on GitHub.


Real‑World Use Cases

1. Quick Site Health Check

Run: /seo audit https://mywebsite.com and get a concise summary:

  • Core Web Vitals (LCP, INP, CLS)
  • Broken internal links
  • Missing or deprecated schema
  • Keyword‑gap analysis

The output is JSON‑structured and can be piped into CI tools or stored in issue trackers.

2. Programmatic SEO Blueprint

If you maintain a data‑driven site (e.g., recipe aggregation), use /seo programmatic https://myrecipes.com to:

  • Detect thin content clusters
  • Suggest URL patterns
  • Auto‑generate canonical tags
  • Create internal linking suggestions

The skill even warns once you hit 30–50 location or category pages, so you can stop before hitting Google’s quality gates.

3. Competitor Comparison Page

Running /seo competitor‑pages https://mywebsite.com/competitor automatically outputs a Markdown table, embeds AggregateRating schema, and includes CTA‑optimized layout. Perfect for building “X vs Y” pages that rank on comparison‑intent queries.

4. Multilingual Sites

A simple /seo hreflang https://mywebsite.com/ validates existing tags, creates missing ones, and outputs a ready‑to‑publish sitemap snippet.


Integrations

Claude SEO can tap live data via MCP (Meta‑Cohort‑Platform) servers. With official integrations from Ahrefs, Semrush, Google Search Console, and PageSpeed Insights, the skill can pull real‑time metrics. Read more in the

MCP Integration Guide included in the repo.


Contributing

  • Fork the repo → clone → make your changes → submit a PR.
  • The repo follows a 12‑hour security hardening cycle; please merge quickly.
  • Documentation is in docs/.

License

MIT – see LICENSE.


Final Thought

Claude SEO turns Claude Code into the Swiss‑Army knife of web‑SEO. Whether you’re building a personal blog, an enterprise e‑commerce site, or a programmatic micro‑site, this tool gives you instant, AI‑driven insights that go from analysis to action in a single terminal.

Original Article: View Original

Share this article