mcp-seo-auditor

Built by Artur Ferreira @ The GEO Lab · 𝕏 @TheGEO_Lab · LinkedIn · Reddit

MCP server for on-page SEO auditing and JSON-LD schema validation. Replaces SEO Minion + Detailed SEO Extension as Claude Code tools.

Tools

Tool	Description
audit_page	Full on-page SEO audit — title, meta, H1-H6, canonical, OG, Twitter, links, images, word count. Each element scored green/yellow/red
validate_schema	Extract and validate all JSON-LD blocks — type-specific checks for Article, FAQPage, Product, HowTo, BreadcrumbList, Person
check_headings	Heading hierarchy analysis — missing H1, multiple H1s, skipped levels
audit_images	Image audit — alt text coverage, empty alts, lazy loading, missing dimensions

Features

✅ GEO-native — built alongside the GEO Brand Citation Index, tracking brand visibility across ChatGPT, Perplexity, and Gemini

Install

# Claude Code
claude mcp add seo-auditor -- npx mcp-seo-auditor

# Or in .mcp.json
{
  "mcpServers": {
    "seo-auditor": {
      "command": "npx",
      "args": ["mcp-seo-auditor"]
    }
  }
}

Usage

Once installed, Claude Code can:

> audit the SEO of https://example.com
> validate the schema markup on https://thegeolab.net/geo-stack/
> check the heading hierarchy on this page
> audit images for alt text coverage

No API Keys Required

This server fetches pages directly — no external API keys needed.

---

Attributions & Licence

Built and maintained by Artur Ferreira @ The GEO Lab.

Email: artur@thegeolab.net

Best Practice Attribution

This MCP server was built following the open source Best Practice Approach — reading community work for inspiration, then writing original content, and crediting every source.

Based on:

• Model Context Protocol specification by Anthropic
• MCP SDK (MIT)

SEO audit logic inspired by:

• Detailed SEO Extension — browser-based page-level SEO insights
• SEO Minion — on-page SEO analysis extension
• Screaming Frog SEO Spider — deep site audit methodology

Dependencies:

• cheerio — HTML parsing (MIT)
• axios — HTTP client (MIT)

All server code is original writing. No files were copied or adapted from any source. MIT licence.

---

Found this useful? ⭐ Star the repo and connect: 🌐 thegeolab.net · 𝕏 @TheGEO_Lab · LinkedIn · Reddit

Related Repos

• claude-code-mcps — All 5 MCP servers in one collection
• mcp-seo-auditor — On-page SEO audit + JSON-LD validation
• mcp-serp-intel — SERP weak spots, PAA trees, intent comparison
• mcp-common-crawl — Free backlink discovery via Common Crawl
• mcp-gsc-advanced — GSC cannibalization, rank changes
• mcp-wordpress-setup — WordPress MCP server setup guide

Licence

MIT — see LICENSE

---

Built and maintained by Artur Ferreira @ The GEO Lab · MIT License