# seo-audit-mcp

**Fast SEO & GEO checks for any URL — from your AI agent.**

An [MCP](https://modelcontextprotocol.io) server that gives Claude Code, Claude Desktop, Cursor or any MCP client a set of instant, no-key SEO audits. Point it at a URL and ask "is this page's SEO healthy?" or "can ChatGPT crawl this site?" — get a structured answer in a second.

## Tools

| Tool | Checks |
|---|---|
| `audit_page(url)` | Title, meta description, canonical, Open Graph, H1/H2, word count — with a prioritized issue list |
| `check_robots(url)` | robots.txt user-agents, disallow rules, declared sitemaps |
| `check_sitemap(sitemap_url)` | URL count, lastmod freshness, http-vs-https, size limits |
| `check_ai_crawler_access(url)` | **GEO check** — are GPTBot, ClaudeBot, PerplexityBot, Google-Extended et al. allowed? If blocked, AI engines can't cite you |

No API keys, no crawl budgets, no dependencies beyond the MCP SDK. All read-only.

## Why GEO matters

Traditional SEO gets you into Google's blue links. **GEO (Generative Engine Optimization)** gets you cited inside ChatGPT, Claude, Perplexity and Google AI Overviews. The single fastest way to lose AI visibility is to accidentally block AI crawlers in robots.txt — `check_ai_crawler_access` catches exactly that.

## Quick start

```bash
pip install mcp
git clone https://github.com/cyber-kani/seo-audit-mcp
```

**Claude Code:**
```bash
claude mcp add seo-audit -- python3 /path/to/seo-audit-mcp/server.py
```

**Claude Desktop / Cursor:**
```json
{
  "mcpServers": {
    "seo-audit": { "command": "python3", "args": ["/path/to/seo-audit-mcp/server.py"] }
  }
}
```

Then ask your agent:

> *"Audit the SEO of example.com/pricing"*
>
> *"Can AI search crawlers access example.com?"*
>
> *"Check example.com/sitemap.xml for problems"*

## Pairs well with

[indexnow-mcp](https://github.com/cyber-kani/indexnow-mcp) — once this tool tells you a page is healthy, indexnow-mcp pushes it to search engines instantly.

## License

MIT

---

Built by [Cloudcoder](https://cloudcoder.dev) — a software development company in Sri Lanka specializing in [AI, SEO and GEO](https://cloudcoder.dev/services/seo-optimization-services). See our guide: [What is MCP?](https://cloudcoder.dev/blog/model-context-protocol-explained)