Docs

MCP server

Let an AI agent run a full audit and act on it — no human in the loop.

crawlie ships a Model Context Protocol server so an LLM agent can crawl a site, read structured issues, and turn them into fixes. This is the part most SEO tools don’t have.

Connect it

After npm i -g crawlie, crawlie-mcp is on your PATH.

Claude Code:

claude mcp add crawlie crawlie-mcp

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "crawlie": {
      "command": "crawlie-mcp"
    }
  }
}

Any MCP-compatible client works — Cursor, Cline, or your own agent. It speaks JSON-RPC over stdio. Built from source? Use the absolute path to target/release/crawlie-mcp.

Prefer one-step setup? The Claude Code plugin bundles this MCP server (auto-run via npx) together with ready-made audit skills.

Tools exposed

ToolPurpose
crawl_siteCrawl + audit a whole site (SEO + GEO); returns scores, issues, per-page data.
audit_urlAudit a single page.
audit_urlsAudit an explicit list of pages.
explain_issueWhy a rule matters + how to fix it.
list_rulesThe full catalogue of checks.
list_reports / get_reportRead saved crawl history.

Example agent prompts

“Crawl example.com, then give me the top 5 fixes that would most improve my GEO score, with the exact change for each.”

“Audit these three landing pages and tell me which is least ready to be cited by AI search, and why.”

“Run a crawl with --fail-on error semantics — are there any broken links or 5xx pages blocking launch?”

The agent calls crawl_site, reads the structured issues, and uses explain_issue to turn findings into a prioritized, actionable plan.