← 返回目录
C

CrawlSEO MCP Server

社区
开源 SEO 监控:Google Search Console + 站点爬虫 + Core Web Vitals + MCP 服务器,一体化自托管仪表盘。
GitHub 源仓库 ↗
★ 560 Stars 分类 · 开发工具 非常热门 源版本 8c22b5306b4d
57FMRS · C
可靠性
8/20
安全与权限
12/20
维护活跃度
15/20
文档质量
12/20
安装易用性
10/20
查看 FMRS 评分方法 →

CrawlSEO MCP 服务器是 CrawlSEO 平台的一部分,允许 AI 代理(如 Claude Code、Claude Desktop、Cursor)直接查询你的 SEO 数据。它提供 10 个工具,涵盖站点列表、概览、关键词与页面数据、流量统计、抓取与审核、核心网页指标以及 SEO 机会等。该服务器通过 stdio 传输运行,需要本地运行 CrawlSEO 实例并配置相关环境变量。

工具能力

list_sites
列出所有已添加的站点
get_site_overview
获取指定站点的概览数据(如整体表现)
get_keywords
获取关键词排名和表现数据
get_pages
获取页面表现数据
get_traffic
获取流量统计数据
run_crawl
触发对站点的爬虫扫描
get_crawl_status
获取最近爬虫任务的状态
get_crawl_issues
获取爬虫扫描发现的问题列表
get_vitals
获取核心网页指标(LCP, CLS, INP等)
get_opportunities
获取 SEO 机会(如低 CTR、内容衰减等)

安装接入

  1. 克隆仓库:git clone https://github.com/crawlseo/crawlseo.git 并进入目录。
  2. 安装依赖:npm install
  3. 配置环境变量:复制 .env.example.env.local,设置 DATABASE_URLNEXTAUTH_SECRETGOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRET
  4. 启动数据库(如 Docker):docker compose up -d db
  5. 运行数据库迁移:npx prisma migrate dev --name init
  6. 启动应用:npm run dev
  7. 在支持的客户端(如 Claude Desktop)中配置 MCP 服务器,添加上述 install_config 中的 JSON。
claude_desktop_config.json
{
  "mcpServers": {
    "crawlseo": {
      "command": "npx",
      "args": [
        "tsx",
        "mcp/server.ts"
      ],
      "cwd": "/path/to/crawlseo"
    }
  }
}

选型与风险

适合谁

  • 创始人、独立开发者和小型团队
  • 自己托管 SEO 工具且注重数据隐私的用户
  • 希望利用 AI 助手快速获取 SEO 洞察的用户

不适合谁

  • 需要高级企业级 SEO 功能的用户(如大规模关键词研究、付费数据)
  • 非技术用户,因为需要自行托管和配置
  • 需要官方支持的用户(这是一个开源社区项目)

所需权限

  • 需要访问本地运行的服务器的数据库(PostgreSQL)
  • 需要 Google OAuth 凭据以访问 Google Search Console 数据
  • 需要网络访问以运行爬虫和获取核心网页指标(如 PageSpeed Insights)

风险与副作用

  • 数据安全风险:如果自托管实例暴露在公网,且未正确保护,可能导致数据泄露。
  • 依赖第三方服务(Google、PageSpeed Insights、DataForSEO)的可用性和配额限制。
  • 开源软件可能包含未知漏洞,需自行维护和更新。
  • 配置不当可能无法正常工作,如环境变量缺失或数据库未启动。

常见排障

  1. 确保 `.env.local` 文件已配置且所有必需环境变量已设置。
  2. 确保 PostgreSQL 数据库已启动并可访问,`DATABASE_URL` 正确。
  3. 运行 `npx prisma migrate dev` 以初始化数据库 schema。
  4. 检查应用日志以获取错误信息;确保所有依赖已安装。
  5. 在客户端中检查 MCP 配置文件路径和命令是否正确。

使用场景

在终端中用自然语言查询 SEO 数据,无需打开仪表盘。
让 AI 代理自动分析关键词表现、页面问题,并生成优化建议。
将 SEO 监控集成到现有 AI 工作流中,实现自动化报告。

支持客户端

Claude Desktop完整支持