用途
gsc-mcp 是一个 MCP（Model Context Protocol）服务器，用于连接 Google Search Console API 和 Google Indexing API。其目标是为 AI 代理或自动化工具提供对这两个 Google API 的完整访问能力。与仅封装 searchAnalytics.query 的其他 GSC MCP 服务器不同，该项目声称暴露了 Google Search Console 和 Indexing API 中所有可用端点，共包含 13 个工具。
主要能力
根据项目说明，该服务器覆盖以下功能领域：
- 搜索分析（Search Analytics）：提供搜索分析相关端点。
- 站点地图（Sitemaps）：提供站点地图相关端点。
- URL 检查（URL Inspection）：提供 URL 检查相关端点，其中 url_inspection_inspect 可用于检查索引状态。
- 批量索引（Indexing API）：提供 Indexing API 相关端点。
项目强调其与仅封装 searchAnalytics.query 的其他 GSC MCP 服务器的区别在于完整 API 覆盖。
使用方式
身份验证
项目支持两种身份验证方法：
选项 1：OAuth2 刷新令牌
所需的 OAuth2 作用域：
- https://www.googleapis.com/auth/webmasters
- https://www.googleapis.com/auth/indexing
选项 2：服务账号
对于 Search Console 读写工具，需将服务账号添加为所有者或具有足够权限的用户。对于 Indexing API 工具，Google 要求将服务账号添加为属性的委托所有者；用户级访问权限不足。
OAuth2 设置步骤
- 前往 Google Cloud Console
- 创建项目（或选择现有项目）
- 启用 Search Console API 和 Indexing API
- 创建 OAuth 2.0 凭据（桌面应用类型）
- 使用 OAuth Playground 生成刷新令牌，作用域为：https://www.googleapis.com/auth/webmasters https://www.googleapis.com/auth/indexing
服务账号设置步骤
- 创建服务账号
- 下载 JSON 密钥文件
- 在 Search Console 中，将服务账号电子邮件添加为网站的所有者
面向 AI 代理
项目提供 llms.txt 供 AI 代理读取机器可读摘要。可将 templates/CLAUDE.md 或 templates/AGENTS.md 复制到项目中，以帮助代理了解此 MCP。
适用场景
- 需要通过 AI 代理或自动化工具访问 Google Search Console 数据的场景。
- 需要执行 URL 检查以确认索引状态的场景。
- 需要向 Google Indexing API 提交索引通知的场景，但仅限于受支持的页面类型。
限制
- Indexing API 资格限制：Google 仅支持该 API 用于带有 JobPosting 结构化数据的页面，或嵌入在 VideoObject 中的 BroadcastEvent 直播页面。工具要求调用方指定 contentType，以标识适用的受支持类型。
- 索引不保证：API 成功响应仅确认收到通知，并不保证 Google 已索引该 URL。需使用 url_inspection_inspect 检查索引状态。
- 服务账号权限要求：对于 Indexing API 工具，服务账号必须被添加为属性的委托所有者，用户级访问权限不足。
其他说明
项目名称：gsc-mcp 仓库地址：https://github.com/mikusnuz/gsc-mcp
关于具体安装命令、依赖项、运行环境要求、收费模式、价格、平台支持、实际效果或详细使用步骤，当前资料暂未提供。
