Grok
从 Grok 读取真实的 Search Console 数据：在聊天中、通过持久化 Bot，或在终端里使用 Grok Build。
含设置截图和示例提示的逐步操作指南，请参阅 将 Google Search Console 连接到 Grok。本页是参考文档：各入口分别支持什么、身份验证如何工作，以及连接不上时该检查什么。
集成如何工作
Grok 支持 自定义 MCP 连接器：任何可从公网访问的 Model Context Protocol 服务器都可以挂载，并在对话中使用其工具。AutoPSEO 正是如此 — 托管在 {{MCP_URL}} 的 MCP 服务器 — 因此并不涉及新的 Search Console 集成。Grok 复用 Claude 和 ChatGPT 所用的同一端点、同一 Google 授权和同一数据仓库。Grok 的内置连接器目录中没有 Search Console 磁贴，所以目前的路径就是自定义连接器 — 而且自定义连接器在所有 Grok 套餐上都可用，包括试用版，因此连接失败只可能出在端点或登录，绝不是订阅。
Grok 聊天
在 grok.com/connectors 添加一个自定义连接器后，即可即兴提问。
Grok Bot
具有固定指令和定时例程的持久化 SEO 分析师。
Grok Build
在终端中读取 Search Console 数据，就在你正在修改的代码旁边。
xAI API
通过原生 SDK 或 OpenAI 兼容 Responses API 中的远程 MCP 工具，驱动你自己的智能体。
无论使用哪一种，分析都在服务端运行。排名变化、衰减、蚕食、CTR 曲线和机会分数都是在 Grok 看到之前，基于完整数据集计算完成的，因此模型解读的是成品结果，而不是对原始行做算术。
添加连接器
- 在 AutoPSEO 中，于 Account → API keys 下创建密钥。除非你希望 Grok 能够写入，否则选择 read only。
- 打开
grok.com/connectors，选择 New Connector，然后选择 Custom。 - 将
{{MCP_URL}}填为 MCP 服务器 URL。 - 完成身份验证步骤，然后用自然语言询问某个资源。
Grok 在连接时会发现服务器上的工具。先问「列出我可以访问的 Search Console 资源」，以确认连接器背后的账号就是你期望的那个。
身份验证与权限范围
AutoPSEO 接受两种身份验证模式，MCP 客户端使用其支持的那一种。
OAuth 2.1
适用于走浏览器登录流程的客户端。服务器会发布受保护资源元数据，并支持动态客户端注册，因此无需预先安排，访问令牌绑定到此资源。撤销授权会立即切断该客户端。
Bearer API key
适用于发送静态请求头的客户端：Authorization: Bearer apseo_live_…。完整密钥仅在创建时显示一次，之后以哈希形式存储；每把密钥可单独撤销，调用按账号限流。
为代你浏览的助手优先使用 read-only 密钥。只读密钥在物理上无法调用写入工具，因此无论多少提示 — 来自你本人，还是来自 Grok 碰巧读到的网页 — 都无法让它提交 URL、删除聚类或更改设置。写入权限用于有意为之的自动化，且每次变更都会记入审计日志。
连接后 Grok 能做什么
服务器暴露一百多个工具，但大多数 SEO 问题只需其中一小部分。在提示中点明你要的分析，能显著改善工具选择。
Discovery
list_sites, get_account_info — 已连接账号可以读取哪些资源。
效果
get_site_summary, query_top_queries, query_top_pages, get_query_performance, get_page_performance — 总计、细分，以及带自动时段对比的每日序列。
诊断
get_ranking_changes, find_decaying_content, analyze_cannibalization, analyze_ctr_curve, score_opportunities, breakdown_by_path, detect_anomalies, detect_change_points。
报告与编入索引
generate_seo_report, get_cross_site_summary, inspect_url, bulk_inspect_urls — 同一连接上还有 GA4 和 Bing Webmaster 数据。
每个工具的日期范围都是可选的。省略时，服务器使用最近 28 个已结算日（已计入报告延迟），对比窗口默认为此前同等长度的时段 — 因此 Grok 不必知道今天的日期也能提出合理的问题。完整目录见 GSC MCP 页面。
SEO 分析师 Bot
Grok Bot 是具有固定职责、自有指令和自有例程的持久化智能体。将 AutoPSEO 连接器挂到 Bot 上，可把让 SEO 分析可信的规则固定下来，而不必每次会话都重述。
值得设置的指令，是那些点明模型在 SEO 数据上常犯错误的规则：优先使用服务端分析工具而非原始行，始终说明分析时段与对比时段，把事实与解读和建议分开，不要把相关当成因果，按影响而非排名变动来排优先级，把数值更小的排名视为更好，没有明确意图时绝不调用写入工具。
例程把已经验证过的工作流变成日程：每日异常监控（未超过阈值则保持沉默）、每周报告、每月高管摘要，以及每月对照你的标注检查「上个月的改动是否奏效」。只有同一分析在交互中站得住之后再添加 — 定时报告悄悄说错，比没有报告更糟。
按数据安排，而不是按日历。 Search Console 有两到三天的结算延迟，因此周一运行的「上周」周报会悄悄丢掉周六和周日，并且每一周都显示下降。周任务放在周中运行，月任务放在进入该月几天之后。
Bot 可通过链接分享。接收方得到的是配置副本，绝不是你的凭据或对话历史，并连接他们自己的 AutoPSEO 账号。完整配置与指令文本见 连接指南。
Grok Build
Grok Build 是 xAI 的终端编码智能体，支持远程 MCP 服务器。在其中注册 AutoPSEO，可让智能体读取它即将修改的页面的效果数据。
{
"mcpServers": {
"autopseo": {
"type": "http",
"url": "{{MCP_URL}}"
}
}
}对使用 OAuth 的 MCP 服务器，Grok Build 会走浏览器登录流程，因此密钥不必进入配置文件。如果改用静态请求头，把密钥放在环境变量里，不要写入源代码管理。请对照你安装的版本核对确切语法；Grok Build 迭代很快。
插件把 MCP 服务器与技能、斜杠命令和智能体打包在一起，因此一次命令即可跑完整分析：周报、排名变化、衰减、蚕食或机会评分。
xAI API
远程 MCP 工具在 xAI 的原生 SDK 及其 OpenAI 兼容 Responses API 中均受支持，因此你构建的智能体只需传入服务器 URL 和身份验证请求头，即可直接调用 AutoPSEO 工具。
请注意，OpenAI 版参数中的 require_approval 和 connector_id 在 xAI 上不受支持 — 请用只读密钥限制写入权限，而不是靠审批回调。
如果你完全不想接触 MCP，同一套密钥、权限范围和速率限制也支撑 {{APP_URL}}/api/v1 上的 REST 接口，并在 /v1/openapi.json 提供生成的 OpenAPI 3.1 文档，可用作函数调用规范。参见 代码示例。
故障排除
Grok 拒绝该 URL
xAI 的服务器会自行调用 MCP 服务器，因此 localhost 和私网地址会被拒绝。请原样使用托管端点，包括 /mcp 路径。
连接器已挂上但没有出现任何资源
请求 get_account_info，查看连接解析到了哪个 AutoPSEO 账号。如果不对，说明密钥或登录属于另一个账号。如果账号正确但为空，请先连接你的 Search Console 资源 — 参见 连接 Search Console。
写入操作被拒绝
在只读密钥上这是预期行为。若自动化确实需要写入，请创建 read & write 密钥，日常聊天仍使用只读密钥。
数字与 Search Console 界面不一致
通常是日期窗口的问题。仓库读取大约滞后两天，每条响应都会报告已结算至哪一天，因此 Grok 中的「最近 7 天」与 GSC 界面可能覆盖不同的日期。请让 Grok 明确说明其时段。
Grok 为该问题选了奇怪的工具
目录很大时，点明任务能大幅改善选择。说「使用蚕食分析」而不是「检查关键词重叠」，或使用指令会把问题映射到工具的 Bot。