← 返回目录

CrawlSEO MCP Server

社区

开源 SEO 监控：Google Search Console + 站点爬虫 + Core Web Vitals + MCP 服务器，一体化自托管仪表盘。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 158 / 438
Stars: ★ 628 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 5 天前
工具数: 10

静态评测 · 未实际运行收录于 2026-08-07

FMRS 57/100 · C · 最弱项可靠性 8/20 — 查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js 20+ · Docker

DATABASE_URL 必填密钥 PostgreSQL 连接字符串，指向自建的数据库实例。

NEXTAUTH_SECRET 必填密钥会话加密密钥，可用 openssl rand -hex 32 生成。

GOOGLE_CLIENT_ID 必填 Google OAuth 客户端 ID，在 Google Cloud Console 凭据页创建。

GOOGLE_CLIENT_SECRET 必填密钥 Google OAuth 客户端密钥，与客户端 ID 一同创建。

其他可选配置项（2 个）

NEXTAUTH_URL 可选应用基础 URL，多数环境可自动检测。

CRAWLSEO_IMAGE 可选可选，指定 Docker Compose 使用的镜像标签（如固定版本或本地构建镜像）。

克隆仓库：git clone https://github.com/crawlseo/crawlseo.git 并进入目录。
安装依赖：npm install。
配置环境变量：复制 .env.example 为 .env.local，设置 DATABASE_URL、NEXTAUTH_SECRET、GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET。
启动数据库（如 Docker）：docker compose up -d db。
运行数据库迁移：npx prisma migrate dev --name init。
启动应用：npm run dev。
在支持的客户端（如 Claude Desktop）中配置 MCP 服务器，添加上述 install_config 中的 JSON。

claude_desktop_config.json

{
  "mcpServers": {
    "crawlseo": {
      "command": "npx",
      "args": [
        "tsx",
        "mcp/server.ts"
      ],
      "cwd": "/path/to/crawlseo"
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "crawlseo": {
      "command": "npx",
      "args": [
        "tsx",
        "mcp/server.ts"
      ],
      "cwd": "/path/to/crawlseo"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add crawlseo -- npx tsx mcp/server.ts

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 10 个 crawlseo 工具（如 list_sites、run_crawl）；调用 list_sites 若能返回已添加的站点即说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我在 CrawlSEO 中的所有站点
运行一次爬取并告诉我最大的问题有哪些
过去 28 天我的热门关键词是哪些？
有哪些接近首页排名的关键词机会？

工具能力 10

list_sites 只读

列出所有已添加的站点

get_site_overview 只读

获取指定站点的概览数据（如整体表现）

get_keywords 只读

获取关键词排名和表现数据

get_pages 只读

获取页面表现数据

get_traffic 只读

获取流量统计数据

run_crawl 写入

触发对站点的爬虫扫描

get_crawl_status 只读

获取最近爬虫任务的状态

get_crawl_issues 只读

获取爬虫扫描发现的问题列表

展开其余 2 个工具

get_vitals 只读

获取核心网页指标（LCP, CLS, INP等）

get_opportunities 只读

获取 SEO 机会（如低 CTR、内容衰减等）

使用场景

在终端中用自然语言查询 SEO 数据，无需打开仪表盘。

让 AI 代理自动分析关键词表现、页面问题，并生成优化建议。

将 SEO 监控集成到现有 AI 工作流中，实现自动化报告。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

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