Screaming Frog SEO Spider MCP Server

A headless MCP (Model Context Protocol) server for Screaming Frog SEO Spider. It drives the SF command line and saved crawl database directly, so Claude (or any MCP-compatible client) can run crawls, export crawl data, and analyze the results with the Screaming Frog GUI closed: on your laptop, on a server, or inside scheduled audits and CI pipelines. Its 9 documented tools cover crawl, data.

People connecting browser automation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-06-12 · ★ 79 · #64 OF 196 MAINTAINED BROWSER AUTOMATION · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Screaming Frog SEO Spider MCP Server

before you install - you'll need

SF_CLI_PATH is optional or environment-specific per the README.

Claude Code

claude mcp add bzsasson-screaming-frog-mcp -- uvx screaming-frog-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "bzsasson-screaming-frog-mcp": {
      "command": "uvx",
      "args": [
        "screaming-frog-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package screaming-frog-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.bzsasson is GitHub-verified and matches the repo owner

03 · What Screaming Frog SEO Spider MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can start a headless background crawl (see note below), check progress of a running crawl, list all saved crawls with their Database IDs, and export crawl data as CSV files (many export options available).

Capability map

Tools grouped from the project's README - what Screaming Frog SEO Spider MCP Server lets an agent do.

Crawl

2 tools - e.g. Start a headless background crawl (see note below); Check progress of a running crawl

crawl_site · crawl_status

read & search

2 tools - e.g. List all saved crawls with their Database IDs; Read exported CSV data with pagination, filtering, and column selection

list_crawls · read_crawl_data

Check

1 tool - e.g. Verify Screaming Frog is installed, check version and license status

sf_check

Export

1 tool - e.g. Export crawl data as CSV files (many export options available)

export_crawl

Aggregate

1 tool - e.g. Counts and group-by breakdowns over exported data ("how many 404s", "status code distribution") without reading rows into context

aggregate_crawl_data

delete

1 tool - e.g. Permanently delete a crawl from the database

delete_crawl

Storage

1 tool - e.g. Show disk usage of SF's crawl storage

storage_summary

Limitations (from the README)

Screaming Frog uses an internal database that can only be accessed by one process at a time. This means: > You must close the Screaming Frog GUI before the MCP server can access crawl data.

Latest releases

v0.4.0 · 2026-06-12

New tools and parameters aimed at answering questions without flooding the model's context window, plus machine-readable safety hints. · New · aggregate_crawl_data tool. Server-side counts and group-by breakdowns over…

v0.3.4 · 2026-06-11

Documentation release. · Added TROUBLESHOOTING.md: step-by-step diagnostic guide for "Could not attach to MCP server" connection failures - manual server test, MCP handshake check, client log locations, and a symptom…

v0.3.3 · 2026-05-08

Fixed false "Crawl save failed" warning on SF 23.2. Screaming Frog 23.2 logs WARN - Crawl save failed {} even when the crawl saves successfully. The server now detects this false positive by checking for the database…

04 · Who maintains Screaming Frog SEO Spider MCP Server

Screaming Frog SEO Spider MCP Server is maintained by bzsasson. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

category
browser automation - ranked #64 of 196 actively-maintained browser automation servers as of 2026-08-25.
release cadence
2 releases in the last 90 days (latest 2026-06-12)
registry
io.github.bzsasson/screaming-frog-mcp (active, first published 2026-02-28)
packages
pypi:screaming-frog-mcp

06 · Screaming Frog SEO Spider MCP Server FAQ

Is Screaming Frog SEO Spider MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-12 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Screaming Frog SEO Spider MCP Server do?

With this server connected, an agent can start a headless background crawl (see note below), check progress of a running crawl, list all saved crawls with their Database IDs, and export crawl data as CSV files (many export options available).

How do I install Screaming Frog SEO Spider MCP Server?

Run `uvx screaming-frog-mcp`. The README documents one environment variable (SF_CLI_PATH) to set first. SF_CLI_PATH is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Screaming Frog SEO Spider MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Screaming Frog SEO Spider MCP Server