seo-mcp

An SEO MCP server — a stdio Model Context Protocol server that gives an AI host a set of SEO tools. The MVP is 100% free and keyless: on-page/technical audits, robots.txt, sitemaps, structured data, broken-link checks, and keyword ideas.

Built on the same proven scaffold as chrome-mcp: SDK Server → StdioServerTransport, a flat tool registry, and a never-throw dispatch firewall.

Tools (all free, no API key)

Install & build

npm install
npm run build      # → dist/src/cli.js

Use it as an MCP server

Add to your MCP host config (e.g. a project .mcp.json):

{
  "mcpServers": {
    "seo-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/mehmoodqureshi/Work/seo-mcp/dist/src/cli.js"]
    }
  }
}

Then ask things like "audit https://example.com for SEO" or "what does example.com's robots.txt block?".

Quick smoke test (no MCP host needed)

node -e "require('./dist/src/seo/audit').auditPage('https://example.com').then(r=>console.log(JSON.stringify(r,null,2)))"

Develop

npm run typecheck   # tsc --noEmit
npm run build       # → dist/

CI (.github/workflows/ci.yml) runs typecheck → build on Node 18/20/22.

PageSpeed (optional key)

The pagespeed tool works keyless but Google rate-limits anonymous requests. To raise the quota, grab a free PageSpeed Insights API key and set it in your MCP host config:

{
  "mcpServers": {
    "seo-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/mehmoodqureshi/Work/seo-mcp/dist/src/cli.js"],
      "env": { "PAGESPEED_API_KEY": "your-key-here" }
    }
  }
}

Roadmap (needs a key — not in the free MVP)

• serp_rank — real SERP position checks (drive a browser, or a paid SERP API)
• domain_authority — OpenPageRank (free key) for an authority score
• backlinks — real backlink profiles (paid: Ahrefs / SEMrush / DataForSEO)

License

MIT