将 Search Console 连接到任意 MCP 客户端

端点

该服务器位于应用域名下的 /mcp，使用协议版本 2025-06-18 的 Streamable HTTP 进行通信。客户端通过 POST 发送 JSON-RPC，先发送 initialize 请求，再发送 tools/list。无需安装任何组件，也无需本地代理。

• Authorization: Bearer，密钥格式为 apk_live_ 加上 32 位十六进制字符
• 密钥仅在创建时显示一次，服务器只保存其 SHA-256 哈希值
• 每次调用都会更新密钥的最后使用时间戳和请求计数器

工具

按功能分组，名称清晰，便于模型选对工具。只读密钥无法调用任何写入或消耗研究额度的工具。

• 发现类：list_properties、search_analytics
• 表现类：top_queries、top_pages、top_countries、compare_periods
• 诊断类：content_decay、cannibalization、ctr_benchmark、page_poaching、rank_changes、new_lost_rankings
• 索引类：url_inspection、sitemaps
• 时间线类：annotations，以及需要写入密钥的 create_annotation
• 分析类：ga4_overview、ga4_breakdown、ga4_key_events
• 研究：关键词、搜索结果页、反向链接、排名追踪和网站审计，会消耗研究额度
• 内容引擎：content_list_tasks、content_claim、content_get_brief、content_submit、content_publish 以及封面工具，用于从队列中撰写内容

日期为可选项

若在任意工具中省略日期范围，服务器会在考虑 Search Console 报告延迟的前提下，使用最近已结算的 28 天数据，对比窗口默认为等长的上一周期。客户端无需知道今天的日期，也能提出合理的问题。

权限范围与速率限制

密钥分为只读和读写两种。只读密钥完全无法调用写入类工具，而写入密钥的每一次变更都会记录审计日志。

• 每个密钥每分钟 60 次请求，每个账号每小时 1,000 次请求
• 超出限额将返回 HTTP 429，并附带以秒为单位的 Retry-After
• 可单独吊销某个密钥，不影响账号中的其他密钥

如果你更倾向使用 REST

Search Console 和 GA4 工具也以 GET 和 POST 路由的形式开放在 /v1 下，并附带位于 /v1/openapi.json 的自动生成的 OpenAPI 3.1 文档，该文档同时可用作函数调用规范。密钥、权限范围和限制均相同。