crawlseo 接入 AI Agent:10 个 MCP 工具与 Claude Code / Cursor 集成完整教程
【免费下载链接】crawlseoOpen-source SEO monitoring. GSC Site Crawler Core Web Vitals in one dashboard.项目地址https://gitcode.com/gh_mirrors/cr/crawlseo点击查看免费下载crawlseo 是一款开源的 SEO 监控工具内置 MCPModel 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 数据库因此前置条件很简单已 clone 并成功部署 crawlseo本地或 Dockergit clone https://gitcode.com/gh_mirrors/cr/crawlseo cd crawlseo cp .env.example .env.local确认 .env或.env.local中已设置DATABASE_URL指向你的 PostgreSQL 实例至少添加了 1 个站点并完成过 GSC 同步或爬取这样 MCP 工具才有数据可查 服务器通过 stdio 传输stdin/stdout与 AI 客户端通信日志输出到 stderr无需额外开放端口。一键配置连接 Claude Code第 1 步安装运行 TypeScript 所需的 tsxnpm 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工具即刻可用。连接 CursorCursor 同样支持 MCP步骤打开 Cursor 设置Cmd/Ctrl ,搜索 MCP添加上面同一段服务器配置 JSON替换cwd为你的项目路径重启 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工具说明关键参数list_sites列出所有监控站点的域名与基础信息无get_site_overview站点 KPI点击、展示、排名、CTR 健康分 最新 VitalssiteId2️⃣ 关键词与页面类Keywords Pages工具说明关键参数get_keywords按点击量排序的 Top 关键词含排名与 CTRsiteId、limit默认 25、days默认 28get_pages按点击量排序的 Top 页面同上get_traffic逐日点击量与展示量趋势siteId、days默认 903️⃣ 爬取与审计类Crawl Audit工具说明关键参数run_crawl发起后台站点爬取立即返回 job IDsiteId、maxPages默认 200上限受CRAWL_MAX_PAGES控制get_crawl_status查询爬取进度、发现的问题数与健康分crawlIdjob ID 或 crawl IDget_crawl_issues按严重程度筛选爬取发现的问题crawlId、severityCRITICAL / WARNING / INFO4️⃣ 性能与机会类Performance SEO工具说明关键参数get_vitalsCore Web Vitals 报告LCP、CLS、INP、TTFB 与性能分siteId、limit默认 10get_opportunitiesSEO 机会挖掘临近首页关键词、低 CTR、内容衰退、关键词内耗siteId实战让 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 类别的关键词有哪些帮我按优先级排序常见问题FAQQ连接后 Agent 说找不到 crawlseo 工具确认.env中有DATABASE_URLcwd指向项目根目录的绝对路径并且重启了 AI 客户端。可以手动运行npx tsx mcp/server.ts验证服务器能否正常启动。Qrun_crawl返回 job ID 之后要等多久爬取由 crawlseo 主应用或 worker 在后台执行两者都未运行时 MCP 服务器会兜底执行。用get_crawl_status传入 job ID 轮询状态看到SUCCEEDED后再查询问题列表即可。Qcrawlseo 计划支持远程连接 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工具定义与参数 Schemamcp/tools.ts结果格式化mcp/formatters.ts完整文档mcp/README.md爬取兜底逻辑mcp/crawl.ts赞分享【免费下载链接】crawlseoOpen-source SEO monitoring. GSC Site Crawler Core Web Vitals in one dashboard.项目地址https://gitcode.com/gh_mirrors/cr/crawlseo点击查看免费下载相关推荐Prismer Cloud MCP Server 集成指南58 个工具一键接入 Claude Code 与 CursorPrismer Cloud MCP Server 集成指南58 个工具一键接入 Claude Code 与 Cursor Prismer Cloud MCP把 Vibe AStock 接入 Claude Code 和 Cursor8个 MCP 工具取数与发起研究教程把 Vibe AStock 接入 Claude Code 和 Cursor8个 MCP 工具取数与发起研究教程 Vibe AStock 是一个 A 股短线复盘金融科技AI 应用前端后端数据可视化数据分析人工智能QuantDinger MCP 接入实战指南为 Cursor / Claude Code / Codex 等 Agent 客户端接入 Agent Gateway 工具面QuantDinger MCP 接入实战指南为 Cursor / Claude Code / Codex 等 Agent 客户端接入 Agent Gatewa金融科技AI 应用后端人工智能MCP 服务AI Agent上一篇从入门到精通kube-lego环境变量配置完全指南下一篇dumpall工具完整指南快速检测和利用4种常见信息泄漏漏洞创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考