MCP 集成:让 AI 客户端能够访问 SEO Stack 数据
MCP 页面提供访问密钥管理、已连接应用控制、客户端配置示例,以及一份可交互的 SEO Stack 工具目录。它的作用是让获得授权的 AI 客户端能够使用你账户下可用的 SEO 数据。
本文介绍 SEO Stack 界面,以及一次成功的内置只读工具测试。外部客户端连接未经测试。预发布(staging)页面中针对具体客户端的代码片段,应先与受支持的生产环境配置核对,然后才能作为可直接复制粘贴的集成教程使用。
了解访问密钥与已连接应用
在侧边栏打开 MCP。页面会显示服务器状态,以及一份访问密钥列表,包含密钥名称、脱敏后的密钥、状态、创建日期、最后使用时间和 Revoke。页面提供 Generate Another Key。页面明确说明:密钥以你的身份进行认证,并拥有与你登录后相同的访问权限。
请妥善保管密钥,并将其与预期使用的客户端对应起来。不要把真实密钥放进知识库文章、截图、共享提示词或公开代码中。本次演示过程中没有生成、展示或撤销任何密钥。
Connected apps 与访问密钥分开列出通过 OAuth 授权的客户端。其说明指出,撤销某个应用会立即断开其连接。已连接应用列表为空,并不代表不存在任何 API 密钥。
查看连接说明
Connect a client 区域提供 Claude Desktop、Gemini 和 ChatGPT 三个标签页,以及 Copy Config。所观察到的示例使用了一个 MCP 服务器 URL 和一个 Authorization bearer 密钥占位符。请使用为你的目标环境所提供的值,并确认你所用客户端版本支持的连接方式。
本次检查的是 staging 服务器。不要把它的端点当作生产环境端点发布,也不要认为在预发布环境中显示的代码片段就证明了它与某个客户端兼容。本文有意省略了未经测试的生产环境 URL。
浏览可用工具
每一项都说明其用途,并可展开查看 Tool input (JSON) 和 Run。该目录包含以下分组:
| 需求 | 显示的工具 |
|---|---|
| 确定已授权的网站 | List My Websites。 |
| 搜索表现 | Query Search Performance;Get Search Console Min Max Date;Get Overall Metrics;Get Metrics Over Time。 |
| 维度分析 | Group By Dimension;Get Metrics Aggregated By Dimension。 |
| 周期对比 | Compare Periods;Get Search Console Data Comparison。 |
| 查询词与页面的关系 | Group By Two Dimensions;Get Search Console Metrics Aggregated By Two Dimensions。 |
| 网站板块 | Get Metrics Aggregated By URL Segment;Get Metrics Compared By URL Segment。 |
| 变化的背景信息 | Get Annotations;Get Algorithm Updates。 |
| AI 可见度 | List LLM Tracker Results;Check AI Visibility;Get AI Visibility Dashboard Data。 |
| 提示词历史 | List Prompt Trackers;List Prompt LLM Visibility History。 |
| 网站配置 | List Topics;List Website Competitors;Get Website Profile。 |
MCP 目录中的 AI visibility、提示词历史与网站上下文类工具。
部分条目的描述较为相似。不要据此认为它们拥有相同的输入结构或输出。可见的目录只是一个起点,并非完整的 API schema 参考。
测试一个只读工具
- 展开 List My Websites。
- 查看输入内容;本次演示使用页面显示的空 JSON 对象
{}。 - 选择 Run。
- 在请求任何与具体网站相关的指标之前,先检查返回结果。
本次测试返回了一个 websites 数组,包含 websiteId、name、URL 和 clickhouseTable,外加一个总数。说明文字提到的是 _id,但实际输出使用的是 websiteId;请以实际返回的字段为准。可见的响应包含 20 行,而总数为 21,因此不要假设第一次响应一定包含了所有可访问的网站。分页行为仍需确认。
目录中说明,Search Console 指标类工具使用返回的数据索引,而 AI visibility 类工具使用网站标识符。不要自行编造任何一种标识符。对于提示词历史,先确定相关的被追踪提示词,然后用其 promptTrackerId 请求历史记录。
连接验证通过后的示例请求
- “将本网站最近 28 个完整日与前 28 日作对比。列出绝对点击量下降最多的五个页面,并给出确切日期、展示量、CTR 和排名。”
- “用相同的时间周期和 URL 分段层级对比 /blog/ 与 /products/ 的表现。”
- “找到这条被追踪的提示词,按平台汇总其可用的运行历史,并将提及与引用分开统计。”
解读结果时,请核对日期覆盖范围、筛选条件和聚合方式。网站列表测试成功,只能说明这一个内置工具返回了数据;它并不能证明其他所有工具、外部客户端或 Google Analytics 连接都能正常工作。Check AI Visibility 被描述为会执行一次检查,因此请将它与单纯获取已存储结果区别对待。