Skip to content
Agentmart
Submit a tool

Screaming Frog SEO Spider MCP Server (headless)

Headless Screaming Frog SEO Spider via its CLI: run crawls, export and filter data, no GUI needed.

Connector by bzsasson · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 93
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/bzsasson-screaming-frog-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Headless Screaming Frog SEO Spider via its CLI: run crawls, export and filter data, no GUI needed.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
6 read · 2 write · 1 delete
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Python package

Tools by what they do 9

Read from the source code; the running server may list different tools.

Read 6 · Look things up without changing anything.

  • aggregate_crawl_data
  • crawl_status
  • list_crawls
  • read_crawl_data
  • sf_check
  • storage_summary

Write 2 · Create, change, send or run things.

  • crawl_site
  • export_crawl

Delete 1 · Delete, drop, revoke or wipe things.

  • delete_crawl

Secrets and settings it asks for

Other settings (environment variables or headers).

  • SF_CLI_PATH

Files it touches

  • Any path the agent passes to its tools

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • aggregate_crawl_dataread-only

    Aggregate CSV data from an export: row counts and group-by breakdowns. Use instead of read_crawl_data when the question needs counts or a distribution ("how many 404s", "status code breakdown") rather than the rows themselves. Args: export_id: The export_id from export_crawl file: CSV filename to aggregate (from the file list in export_crawl output) group_by: Optional column name; counts rows per distinct value of it top: Max distinct values to show, most common first (default 20, max 100) filter_column: Optional column name to filter by before aggregating filter_value…

  • crawl_site

    Start a background Screaming Frog crawl that saves to SF's internal database. Args: url: The URL to crawl (e.g. https://example.com) config_file: Optional path to a .seospiderconfig file for crawl settings. To limit the number of URLs crawled, set the limit in a config file (Configuration > Spider > Limits in the SF GUI) and pass it here. label: Optional label for identifying this crawl (e.g. 'freshgovjobs') Returns: A crawl_id to use with crawl_status to check progress. The crawl runs in the background - use crawl_status to poll.

  • crawl_statusread-only

    Check the status of a running or completed crawl. Args: crawl_id: The crawl_id returned by crawl_site

  • delete_crawlcan change or delete data

    Delete a crawl from Screaming Frog's internal database to free disk space. Args: db_id: The Database ID from list_crawls WARNING: This permanently deletes the crawl data. It cannot be undone.

  • export_crawl

    Load a saved crawl from SF's database and export data as CSV files. Args: db_id: The Database ID from list_crawls (e.g. '1234' or a crawl identifier) export_tabs: Comma-separated export tabs (default: Internal:All,Response Codes:All,Page Titles:All,Meta Description:All,H1:All,H2:All,Images:All,Canonicals:All,Directives:All). See the export-reference resource for all options. bulk_export: Optional bulk export types (e.g. 'Links:All Inlinks,Content:Soft 404 Inlinks') save_report: Optional reports to save (e.g. 'Crawl Overview') Returns: An export_id and list of generated CS…

  • list_crawlsread-only

    List all crawls saved in Screaming Frog's internal database. Returns crawl names, Database IDs, and sizes. Use the Database ID with export_crawl or delete_crawl.

  • read_crawl_dataread-only

    Read CSV data from an export. Use after export_crawl. Args: export_id: The export_id from export_crawl file: CSV filename to read (from the file list in export_crawl output) limit: Max rows to return (default 100, max 1000) offset: Number of rows to skip (for pagination) filter_column: Optional column name to filter by filter_value: Optional value to match in the filter column filter_mode: How to match filter_value: "contains" (default, case-insensitive substring), "exact" (case-insensitive exact match), or "regex" (Python regex) columns: Optional comma-separat…

  • sf_checkread-only

    Verify that Screaming Frog SEO Spider is installed and the CLI is accessible. Returns version info and license status.

  • storage_summaryread-only

    Show disk usage of Screaming Frog's internal crawl storage. Returns total size and per-crawl breakdown of ProjectInstanceData.

Signals

Stars
93
Forks
19
Open issues
0
Weekly downloads
727
Last commit
Oct 17, 2026 (11 days ago)
Last release
Oct 17, 2026 (11 days ago)
Last package publish
Oct 17, 2026 (11 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.bzsasson/screaming-frog-mcp
Version
0.4.3
Auth
No auth
Packages
pypi screaming-frog-mcp
License
MIT
Repository
github.com/bzsasson/screaming-frog-mcp
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql

More from bzsasson

Cite this page

Screaming Frog SEO Spider MCP Server (headless). Agent Mart. https://agentmart.dev/connectors/bzsasson-screaming-frog-mcp (last updated 2026-10-25)