SEO爬虫数据服务

Screaming Frog MCP Server是一款将Screaming Frog SEO Spider爬取数据作为工具调用暴露给任何兼容MCP的AI助手的服务。

  • by acamolese
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 acamolese/screaming-frog-mcp

使用说明

尖叫蛙MCP服务器

MCP服务器将Screaming Frog SEO Spider抓取数据作为工具公开,需要任何与MCP兼容的AI助手。

建在 尖叫流氓 Python库。

需求

  • Python 3.10+
  • Java运行时(用于 .dbseospider 带有Derby后端的文件)
  • 安装尖叫蛙SEO蜘蛛(可选,用于 .seospider 转换)

安装

git clone https://github.com/acamolese/screaming-frog-mcp.git
cd screaming-frog-mcp
pipx install -e .

或者在虚拟环境中使用pip:

pip install -e .

安装后,找到命令的完整路径:

which screaming-frog-mcp

您将需要此路径进行以下配置(通常 ~/.local/bin/screaming-frog-mcp 当通过pipx安装时)。

配置

MCP服务器需要在MCP客户端的配置文件中注册。文件位置和格式因您使用的客户端而异。

克劳德代码(CLI)

添加 ~/.claude/.mcp.json:

{
  "mcpServers": {
    "screaming-frog-seo": {
      "type": "stdio",
      "command": "/full/path/to/screaming-frog-mcp"
    }
  }
}

克劳德桌面(macOS应用程序)

添加 ~/Library/Application Support/Claude/claude_desktop_config.json,在现有 mcpServers 对象:

{
  "mcpServers": {
    "screaming-frog-seo": {
      "command": "/full/path/to/screaming-frog-mcp"
    }
  }
}

注意:Claude Desktop不使用 "type": "stdio" 现场。如果文件已经包含其他MCP服务器,只需添加 "screaming-frog-seo" 进入他们旁边。

其他MCP客户端

请参阅客户的文档。服务器使用stdio传输,命令是 screaming-frog-mcp.

重要:始终使用命令的绝对路径(from which screaming-frog-mcp)而不仅仅是名称,以避免PATH解析问题。

编辑配置后,重新启动应用程序或会话以使更改生效。

可用工具

工具 说明
load_crawl 加载爬网文件
crawl_summary 获取爬网统计信息
get_pages 带过滤器的查询页面(状态代码、可索引性、文本搜索、部分)
get_links 查询入站/出站链接
broken_links_report 断链报告
title_meta_audit 标题和元描述审核
indexability_audit 不可索引的页面
redirect_chains_report 重定向链
canonical_issues_report 规范标签问题
hreflang_issues_report Hreflang问题
orphan_pages_report 孤儿页面
security_issues_report 安全问题
redirect_issues_report 重定向问题
nofollow_inlinks_report 无关注入站链接
compare_crawls 比较两次爬网
query_tab 访问任何爬网选项卡
list_tabs 列出可用选项卡
list_crawls 发现机器上可用的爬网

Slash命令用于自动分析

一个现成的斜线命令可以一步完成完整的技术SEO审计。将命令文件复制到命令目录:

mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/analyze-crawl.md \
  https://raw.githubusercontent.com/acamolese/screaming-frog-mcp/main/commands/analyze-crawl.md

然后键入 /analyze-crawl 在新的会议上。该命令将要求您提供爬网文件,并自动运行所有审核,呈现结构化报告。

支持格式

  • .dbseospider (Derby,本机DB模式格式)
  • .seospider (Screaming Frog项目,需要安装CLI)
  • .duckdb (DuckDB缓存)
  • .db (SQLite遗留)
  • CSV导出目录

许可证

麻省理工学院