SEO Audit MCP Server

Ask Claude or Cursor to audit any page or crawl your site: canonicals, noindex, redirects, robots.txt, sitemaps, broken links and duplicate titles, with no API key or credits.

SEO Audit MCP Server cover

The 5 tools

A Model Context Protocol server that gives Claude, Cursor or any MCP client five technical SEO tools. No API keys, no accounts, no paid data: it fetches the pages itself, from your machine. Python 3.9+, standard library only.

ToolWhat it checks
audit_pageStatus and redirects, title, meta description, canonical (missing, conflicting, in <body>, pointing elsewhere, http on https), meta robots and X-Robots-Tag noindex/nofollow, H1, lang, viewport, hreflang codes, self-reference and x-default, JSON-LD validity and types, image alt, internal nofollow, thin content, og:title
check_redirectsEvery hop with status; loops, chains, temporary (302/303/307) redirects, https to http downgrades, chains ending in 4xx/5xx, more than 10 hops
check_robotsFetches robots.txt and tests paths for any crawlers with Google's rules (longest match wins, Allow wins ties, Googlebot-Image falls back to Googlebot), lists Sitemap lines, lints the file (relative sitemap URLs, ignored directives, typos), 4xx/5xx meaning
check_sitemapSitemap or sitemap index (gzip too): 50,000 URL and 50 MB limits, W3C lastmod format, duplicates, relative or cross-host URLs, ignored priority/changefreq, and optional status sampling of listed URLs
crawl_siteCrawls up to 200 pages of one host, respecting robots.txt: broken internal links with the page that links to them, redirecting internal links, duplicate titles and descriptions, non-indexable pages, issue counts

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 10 tests OK on Python 3.13 and 3.10.

Real terminal output from SEO Audit MCP Server: demo and passing tests

Install

Claude Code

claude mcp add seo-audit -- python3 /absolute/path/to/seo-audit-mcp-server/server.py

Or install the folder as a Claude Code plugin: it has .claude-plugin/plugin.json, .mcp.json (uses ${CLAUDE_PLUGIN_ROOT}) and a skill (skills/seo-audit/SKILL.md) that tells Claude how to run and report an audit.

Cursor: copy examples/configs/cursor-mcp.json into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) and fix the path. Claude Desktop: merge examples/configs/claude_desktop_config.json into your claude_desktop_config.json.

Then ask: "Audit https://yoursite.com/pricing", "Crawl my site and list broken links", "Is GPTBot blocked on /blog/?", "Check my sitemap and sample 20 URLs".

Also a CLI

python3 -m seoaudit audit https://yoursite.com/
python3 -m seoaudit redirects http://yoursite.com/old-url
python3 -m seoaudit robots https://yoursite.com/ /blog/ /cart --ua Googlebot,GPTBot
python3 -m seoaudit sitemap https://yoursite.com/sitemap.xml --sample 20
python3 -m seoaudit crawl https://yoursite.com/ --max-pages 100 --json > crawl.json

Exit code 1 when there's a high-severity issue or a broken link (handy in CI after a deploy).

Safety

  • Read-only GET requests with a 15 s timeout and 5 MB page limit; http(s) only.
  • Private, loopback, link-local and cloud-metadata addresses are refused, so a prompt can't point the server at your router or 169.254.169.254. To audit a local dev site, set SEOAUDIT_ALLOW_PRIVATE=1 in the server's environment.
  • Sitemaps with DOCTYPE/ENTITY declarations are refused (XML entity attacks).
  • Every result carries a note that page text is untrusted data; the skill tells the model not to follow instructions found in pages.

Demo and tests

./demo.sh serves examples/site (a small fictional tea shop with planted problems) on 127.0.0.1, shown as https://shop.example, and runs the tools. ./run_tests.sh runs 10 tests, including a full MCP stdio session (initialize with version negotiation, tools/list, tools/call, error codes).

Honest limits

  • Reads raw HTML; it doesn't run JavaScript, so client-rendered titles or links are invisible to it (as they are to many crawlers on first pass).
  • No Core Web Vitals, rankings, backlinks or search volume; it's a technical audit.
  • Title and description lengths are guidance (Google truncates by pixel width), not rules.
  • MCP protocol versions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05 (tools only; no resources or prompts).

Format and license

Zip, 32 KB, v1.0, 28 files. You may use and modify this kit for your own work and for clients you serve, including paid client work. Not affiliated with or endorsed by Google, Anthropic or Cursor (Anysphere).

FAQ

Do I need an API key?
No. It fetches pages directly from your machine; there's nothing to sign up for.
Does it render JavaScript?
No, it reads raw HTML, so it reports what crawlers see on first fetch.
Which clients?
Any MCP client over stdio: Claude Code, Claude Desktop, Cursor, and others.
How do I get the files?
Right after payment, Stripe’s confirmation page shows your download link.
Refunds?
Email hello@youraitools.co within 14 days if it doesn’t work and we can’t fix it.
Can I pay with crypto?
Yes. Pay the same price in USDC or USDT on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana from the "Pay with crypto" button, with no account or KYC. We check the payment on-chain and show your download links as soon as it confirms.

Get SEO Audit MCP Server

SEO MCP server for Claude Code, Cursor and Claude Desktop: page audits, redirect chains, robots.txt, sitemaps and site crawls. No API keys or credits. $29 once.

Save with a bundle

Pairs well with

Download$12

Cursor Rules for Laravel

8 Cursor rules for Laravel, written against current docs. Installs in one command, exports AGENTS.md for Claude Code and Codex. $12 once.

View Cursor Rules for Laravel
DownloadFree

Laravel Cursor Rules Starter (Free)

Free Laravel Cursor rules in .mdc format, checked against current Laravel docs, plus a linter that shows why a rule isn't applying.

View Laravel Cursor Rules Starter (Free)
Download$12

Cursor Rules for FastAPI

7 Cursor rules for FastAPI, written against current docs. Installs in one command, exports AGENTS.md for Claude Code and Codex. $12 once.

View Cursor Rules for FastAPI

Related