使用说明
尖叫蛙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导出目录
许可证
麻省理工学院