crawlseo 是一款开源的 SEO 监控工具，内置 MCP（Model Context Protocol）服务器，让你可以在 Claude Code、Cursor、Claude Desktop 中直接调用 10 个 SEO 工具：查询关键词排名、流量趋势、发起站点爬取、查看 Core Web Vitals 性能报告，还能自动挖掘 SEO 机会点。这篇教程带你从零完成 crawlseo 接入 AI Agent 的全过程。

为什么要把 crawlseo 接入 AI Agent？

传统使用方式下，你需要打开浏览器 → 登录面板 → 逐个页面查看数据 → 手动整理结论。

接入 MCP 之后，AI Agent 变成了你的"SEO 数据助理"，你在终端或编辑器里直接问：

• "我上个月哪些关键词排名下滑最严重？"
• "帮我跑一次全站爬取，只列出 CRITICAL 级别的问题"
• "LCP 和 INP 最近表现如何？给我性能诊断"

Agent 会自动调用 crawlseo 的 MCP 工具拿到真实数据，再基于数据给出分析和建议。

准备工作：部署 crawlseo 并配置数据库

MCP 服务器与主应用共用同一个 PostgreSQL 数据库，因此前置条件很简单：

1. 已 clone 并成功部署 crawlseo（本地或 Docker）：

git clone https://gitcode.com/gh_mirrors/cr/crawlseo cd crawlseo cp .env.example .env.local

2. 确认 .env（或.env.local）中已设置DATABASE_URL，指向你的 PostgreSQL 实例
3. 至少添加了 1 个站点并完成过 GSC 同步或爬取，这样 MCP 工具才有数据可查

💡 服务器通过 stdio 传输（stdin/stdout）与 AI 客户端通信，日志输出到 stderr，无需额外开放端口。

一键配置：连接 Claude Code

第 1 步：安装运行 TypeScript 所需的 tsx：

npm install -D tsx

第 2 步：在项目根目录的.claude/settings.json中添加：

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

把/path/to/crawlseo替换为你项目的绝对路径，然后重启 Claude Code，工具即刻可用。

连接 Cursor

Cursor 同样支持 MCP，步骤：

1. 打开 Cursor 设置（Cmd/Ctrl + ,）
2. 搜索 "MCP"
3. 添加上面同一段服务器配置 JSON
4. 替换cwd为你的项目路径
5. 重启 Cursor

连接 Claude Desktop

在 Claude Desktop 设置中进入Developer > MCP Servers，添加配置 JSON，替换路径后重启即可。

📍 提示：crawlseo 应用内建了 "AI & MCP" 页面（components/mcp/mcp-page-content.tsx），内置了可直接复制的配置 JSON 和 Claude Code / Claude Desktop / Cursor 三套图文指南，配置时对照着做即可。

10 个 MCP 工具全解：4 大类别

工具定义在 mcp/tools.ts，实现在 mcp/server.ts，完整清单可参考 mcp/README.md。

1️⃣ 站点管理类（Sites）

2️⃣ 关键词与页面类（Keywords & Pages）

3️⃣ 爬取与审计类（Crawl & Audit）

4️⃣ 性能与机会类（Performance & SEO）

实战：让 AI Agent 帮你做 SEO 诊断

配置完成后，在 Claude Code 中直接输入自然语言即可：

先 list_sites 看一下我的站点，然后对第一个站点： 1. get_site_overview 看整体健康度 2. run_crawl 发起一次爬取，完成后用 get_crawl_issues 只看 CRITICAL 问题 3. 最后 get_opportunities 找出值得优先优化的关键词机会

Agent 会按顺序调用工具、解析返回的文本结果，并汇总成一份"问题清单 + 修复建议"。你甚至可以让它直接生成待办事项或改写建议。

几个好用的提问模板：

• 周度复盘："对比 get_traffic 最近 90 天数据，指出流量下滑最明显的日期区间，并用 get_keywords 找出对应下跌的关键词"
• 性能体检："get_vitals 拉最近的 LCP 报告，如果 LCP 超过 2.5 秒，列出最可能的原因"
• 机会挖掘："get_opportunities 里 striking distance 类别的关键词有哪些？帮我按优先级排序"

常见问题（FAQ）

Q：连接后 Agent 说找不到 crawlseo 工具？确认.env中有DATABASE_URL，cwd指向项目根目录的绝对路径，并且重启了 AI 客户端。可以手动运行npx tsx mcp/server.ts验证服务器能否正常启动。

Q：run_crawl返回 job ID 之后要等多久？爬取由 crawlseo 主应用或 worker 在后台执行（两者都未运行时 MCP 服务器会兜底执行）。用get_crawl_status传入 job ID 轮询状态，看到SUCCEEDED后再查询问题列表即可。

Q：crawlseo 计划支持远程连接 MCP 吗？目前 MCP 通过本地 stdio 传输。路线图（见 components/mcp/mcp-page-content.tsx 中的 ROADMAP）规划了 OAuth2 远程传输、关键词研究工具、外链分析工具和 AI 对话助手，方便托管型 AI Agent 直接接入。

总结

crawlseo 把 GSC 数据、站点爬取、Core Web Vitals 和机会挖掘封装成了 10 个 MCP 工具，一次配置即可在 Claude Code、Cursor、Claude Desktop 中"用嘴查数据"。对于个人站长、独立开发者和小团队来说，这是把 SEO 监控从"看报表"升级为"问 Agent"的免费且自托管方案——数据始终留在你自己的数据库里。

核心文件速查：

• 服务器实现：mcp/server.ts
• 工具定义与参数 Schema：mcp/tools.ts
• 结果格式化：mcp/formatters.ts
• 完整文档：mcp/README.md
• 爬取兜底逻辑：mcp/crawl.ts