第 1 章 · 02 接入 OpenSEO MCP

第 1 章 · 02 接入 OpenSEO MCP

本节摘要:本节带你把 OpenSEO 的 MCP server 接入你的 AI 客户端(Claude Code / Claude Desktop / Cursor),接入后,你的 agent 就能用自然语言调用 OpenSEO 的全部 SEO 工具——关键词研究、SERP 检查、本地商家研究、竞争情报、域名研究、反向链接概览、已保存关键词、排名追踪,以及 Google Search Console 的性能与 URL 检查。我们走三个客户端的具体配置,并说明授权流程。读完本节,你能在任意一个主流 AI 客户端里,用一句话驱动 OpenSEO 做 SEO 研究。

内容来源:原项目英文文档 web/content/docs/mcp.md,汉化并套用体系化模板。

学习目标

阅读完本节,你应当能够:

1. 说清 OpenSEO MCP 能做什么(暴露哪些 SEO 工具给 AI 客户端)。
2. 把 MCP 接入 Claude Code(命令行)、Claude Desktop(图形端)、Cursor 三种客户端之一。
3. 完成 OpenSEO 登录授权,让 agent 能以你的项目上下文与账号权限调用工具。

一、OpenSEO MCP 是什么

OpenSEO MCP(Model Context Protocol,模型上下文协议)server 让兼容的 AI 客户端能调用 OpenSEO 的 SEO 工具,覆盖:

• 关键词研究、SERP 检查
• 本地商家研究、竞争搜索情报
• 域名研究、反向链接概览
• 已保存关键词、排名追踪
• Google Search Console 的性能与 URL 检查

托管的 MCP server 地址是:

https://app.openseo.so/mcp
​

第一次连接会跳转到 OpenSEO 登录;授权后,你的 MCP 客户端就能按你批准的项目上下文与账号权限调用 OpenSEO 工具。

💡 要最新的配置 UI 与可复制的端点:打开 OpenSEO 的「AI & MCP」页面(app.openseo.so/ai),那里有交互式引导。

二、接入 Claude Code

用 user scope 让 OpenSEO 在所有项目可用;用 local scope 只在当前仓库可用。

claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp
​

添加后,按提示批准 OpenSEO 登录即可。

💡 scope 怎么选:个人开发者跨项目用 SEO,选 user;只想在某个项目里临时用,选 local,避免污染全局配置。

三、接入 Claude Desktop

1. 打开 Settings → Connectors。
2. 点击 Add custom connector。
3. 粘贴 https://app.openseo.so/mcp。
4. 按提示批准 OpenSEO 登录。

⚠️ 前提:Claude Desktop 的自定义 connector 需要一个支持自定义 connector 的 Claude 订阅计划,免费版可能没有这个能力。

四、接入 Cursor

1. 打开 Cursor Settings → Tools & Integrations → MCP Tools。
2. 点击 New MCP Server,Cursor 会打开 mcp.json。
3. 添加配置:

{
  "mcpServers": {
    "openseo": {
      "url": "https://app.openseo.so/mcp"
    }
  }
}
​

保存后,Cursor 就能识别 openseo 这个 MCP server。

五、验证与首次调用

接入后,在你的 AI 客户端里用一句话测试:

用 openseo 查一下「开源 SEO 工具」这个关键词的搜索量和竞争度
​

如果 agent 成功调用了 OpenSEO 的关键词研究工具并返回数据,说明接入成功。

⚠️ 常见问题:① 提示找不到 openseo server → 检查 scope 与配置文件路径;② 调用报 401/403 → 重新走一遍 OpenSEO 登录授权;③ 工具列表为空 → 确认你的 OpenSEO 账号已批准对应的项目上下文与权限范围。

本节要点回顾

1. MCP 是桥:OpenSEO MCP server(app.openseo.so/mcp)把全部 SEO 工具暴露给 AI 客户端。
2. 能力范围:关键词、SERP、本地商家、竞争情报、域名、反链、排名追踪、GSC。
3. Claude Code:claude mcp add --transport http --scope user openseo <url>,user 跨项目/local 单项目。
4. Claude Desktop:Settings → Connectors → 粘贴 URL(需支持自定义 connector 的计划)。
5. Cursor:在 mcp.json 里加 mcpServers.openseo.url。
6. 授权:首次连接走 OpenSEO 登录,按批准的权限范围调用。
7. 验证:用一句话让 agent 调关键词研究工具,返回数据即成功。

下一章,我们将进入 Agent Skills 实战——MCP 是「能不能调」,Skills 是「怎么把一整套 SEO 工作流封装成 agent 可用的能力包」。