claude-seo MCP — Use Cases, Install & Live Demo

Why use it

Key features

19 sub-skills covering technical SEO, E-E-A-T, schema, images, sitemaps, backlinks, hreflang, programmatic SEO, e-commerce
12 specialist subagents run analysis in parallel for faster audits
GEO sub-skill specifically for Generative Engine Optimization (AI Overviews, Perplexity, ChatGPT citations)
Google APIs integration: Search Console, PageSpeed, CrUX, GA4
Exports PDF and Excel reports for client deliverables

Live Demo

What it looks like in practice

claude-seo-skill.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-seo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-seo",
        "~/.claude/skills/claude-seo"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-seo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-seo",
        "~/.claude/skills/claude-seo"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-seo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-seo",
        "~/.claude/skills/claude-seo"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-seo-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-seo",
        "~/.claude/skills/claude-seo"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-seo-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-seo",
        "~/.claude/skills/claude-seo"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-seo-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-seo",
          "~/.claude/skills/claude-seo"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add claude-seo-skill -- git clone https://github.com/AgriciDaniel/claude-seo ~/.claude/skills/claude-seo

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use claude-seo

Run a full technical SEO audit and deliver a client-ready report

👤 SEO consultants and agencies ⏱ ~45 min intermediate

When to use: Onboarding a new client; need a baseline audit in hours, not days.

Prerequisites

Target site URL — The client's canonical domain
Optional: Search Console + PageSpeed API keys — For the /seo google commands — free Google Cloud APIs

Flow

Run the audit

/seo audit https://client.example.com — full technical + E-E-A-T, output PDF.✓ Copied

→ Subagents kick off in parallel; progress logged per category
Review findings

Summarize the top 10 highest-impact issues by priority and effort.✓ Copied

→ Prioritized list with concrete fixes
Generate remediation plan

Draft a 90-day remediation roadmap with weekly milestones.✓ Copied

→ Dated plan the client can sign off on

Outcome: A deliverable-quality audit report plus an actionable roadmap.

Pitfalls

Audit runs on a staging site blocked by robots.txt — Confirm crawlability up-front; the skill respects robots.txt by default

Combine with: firecrawl

Optimize a page for Google AI Overviews and ChatGPT citations

👤 Content marketers chasing AI citations ⏱ ~30 min intermediate

When to use: A key page is losing organic clicks to AI summaries and you want to be the cited source.

Flow

Run the GEO sub-skill on the page

/seo geo https://example.com/post — what needs to change for AI Overview citation?✓ Copied

→ Concrete recommendations on entity clarity, snippet-friendly structure, schema
Apply and re-test

Apply the changes, then re-score using the same sub-skill.✓ Copied

→ Score improves; specific deltas called out

Outcome: A page rewritten to maximize AI-answer citation probability.

Pitfalls

Over-optimizing for AI hurts human readability — Balance — the skill has an E-E-A-T check that catches robotic-sounding edits

Combine with: firecrawl

Generate and validate Schema.org markup for 50 product pages

👤 E-commerce SEO managers ⏱ ~40 min intermediate

When to use: Launching a new category and need Product + Offer + AggregateRating markup everywhere.

Flow

Point the schema sub-skill at the category

/seo schema https://shop.example.com/cat/widgets — generate Product schema for all 50 items.✓ Copied

→ JSON-LD blobs per URL, validated against Schema.org
Verify with Google's Rich Results Test

For each URL, run the Rich Results Test and flag any warnings.✓ Copied

→ Per-URL pass/fail with actionable warnings

Outcome: Valid schema ready to deploy, pre-tested.

Pitfalls

Schema out of sync with visible content (spam signal) — The skill cross-checks markup values against scraped page content

Combine with: firecrawl

Combinations

Pair with other MCPs for X10 leverage

claude-seo-skill + firecrawl

Competitor content analysis — scrape their top-ranking pages and reverse-engineer the pattern

Scrape the top 5 ranking pages for 'best widgets' with firecrawl, then use /seo audit to compare them structurally to our page.✓ Copied

claude-seo-skill + brave-search

Use Brave Search to find competitors, then audit their pages

Brave-search the top 10 results for my target keyword, then run /seo audit on each.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call	Cost
SEO audit (/seo audit)	URL	Baseline or quarterly review	Tokens only
Schema generation (/seo schema)	URL	Adding or fixing structured data	Tokens only
GEO optimization (/seo geo)	URL	Targeting AI Overviews / ChatGPT citations	Tokens only
Local SEO (/seo local)	URL or GMB name	Brick-and-mortar or multi-location	Tokens only
Google APIs (/seo google)	property + date range	Any data-backed analysis	Free API calls

Cost & Limits

What this costs to run

API quota: None for the skill; Google APIs have generous free tiers
Tokens per call: Full audit: 10-30k tokens. Single sub-skill: 2-5k.
Monetary: Free — skill is local. DataForSEO/Firecrawl pairings cost their own credits.
Tip: Run one sub-skill at a time for small jobs; save the full /seo audit for client deliverables.

Security

Permissions, secrets, blast radius

Credential storage: Google API keys in env vars if using /seo google; no credentials in the skill itself

Data egress: Only to sites you audit and the Google APIs you authenticate with

Don't run audits on sites you don't own or have permission to crawl.

Troubleshooting

Common errors and fixes

Slash command /seo not recognized

Make sure the skill's commands/ folder is in place after clone; restart Claude Code.

Verify: ls ~/.claude/skills/claude-seo/commands/

Subagents fail or time out

Reduce parallelism; run sub-skills sequentially for large sites.

Google APIs return 403

Enable the specific API (Search Console, PageSpeed, etc.) in your GCP project and re-auth.

Alternatives

claude-seo vs others

Alternative	When to use it instead	Tradeoff
seo-geo-claude-skill	You want a lighter 20-skill bundle without subagent orchestration	Simpler but fewer enterprise reporting features
agentic-seo-skill	You're on Antigravity/Codex, not just Claude Code	Broader agent support; similar feature set
claude-blog-skill	You only need content SEO, not full technical audits	Narrower scope, faster to learn

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills