Sitewalk: technical SEO audit MCP server

Ask your AI assistant to audit a website. Get the technical SEO problems back, ranked by impact, with a plain fix for each.

---

This repository is the Sitewalk MCP server and nothing else: a Python server that drives the open-source LibreCrawl crawler, runs 30+ technical SEO checks, and hands your AI assistant a ranked report plus a zip of PDF and CSVs. It runs on your own machine, with no account, no sign-in and no page cap. Nothing leaves your machine except the requests the crawler makes to the site you audit.

Prefer not to host anything? The same audit is available as an app inside ChatGPT.

Set it up on your machine

You need Docker running. Then:

git clone https://github.com/adityaarsharma/sitewalk.git
cd sitewalk
./setup.sh

The script checks your machine, asks one optional question (a Google PageSpeed key), builds and starts the stack, waits until the MCP server answers, and prints exactly how to connect your assistant. The first build takes a few minutes.

Command	What it does
./setup.sh	Guided setup
./setup.sh --yes	Same, no questions
./setup.sh --check	Only check that your machine can run it
./setup.sh --update	Pull the newest release and rebuild
./setup.sh --stop	Stop it (your reports are kept)

Without Docker, see the manual route in docs/GETTING-STARTED.md.

Connect an assistant

The server listens on http://127.0.0.1:5081/mcp (streamable HTTP).

• ChatGPT and Grok reach servers over the internet, so they need a public https address that forwards to your machine. The server has no sign-in of its own, so put it behind a tunnel that adds access control. Steps in docs/GETTING-STARTED.md.
• Clients on your computer (Codex, Windsurf, any stdio-only client) connect through mcp-remote:

{
  "mcpServers": {
    "sitewalk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://127.0.0.1:5081/mcp"]
    }
  }
}

Then ask: Audit https://yoursite.com for technical SEO problems.

What you get

• 30+ checks per audit (broken links, redirects, canonicals, titles and descriptions, headings, schema, images, hreflang, sitemap gaps, and more). Full list and the nine report files: docs/CHECKS.md.
• A branded PDF, a Markdown copy and CSVs, zipped in ./reports.
• Chunked crawling that does not time out, WAF challenge detection, and a crawl delay that adapts to the site.
• 38 MCP tools: docs/TOOLS.md.

Docs

Guide	What is inside
Getting started	Docker and manual setup, connecting clients, your first audit
Configuration	Every environment variable, HTTP and stdio transport
Tools	All 38 MCP tools
Checks	The 30+ checks and the report files
Architecture	How the pieces fit
Troubleshooting	Common errors and fixes

Releases

Every change to the code that lands on main is tested and published as a new GitHub release automatically. Update with ./setup.sh --update.

Licence and credits

Code is MIT: see LICENSE and NOTICE.md. Built on LibreCrawl (MIT), FastMCP and WeasyPrint. No telemetry.

Built by Aditya Sharma.