Google Search Console

1. 在 Google Cloud Console 中，依次前往 API 和服务 → 凭据 → 创建凭据 → 服务账号。为其命名并完成创建；可以跳过可选的角色和访问权限步骤。
2. 打开服务账号，然后依次选择 密钥 → 添加密钥 → 创建新密钥 → JSON，下载密钥。
3. 在 Search Console 中，打开每个资源的 设置 → 用户和权限 → 添加用户。添加服务账号邮箱，并授予 受限 访问权限。

注意

将密钥存放在仓库之外，绝不要提交它。在下面的客户端配置中使用密钥的绝对路径。

如果 Search Console 因“Failed to add user: email not found”而拒绝该邮箱，请改为以自己的身份登录；参阅故障排除。

服务会优先检查 GOOGLE_APPLICATION_CREDENTIALS，然后再检查本地 ADC。如果改用 ADC，请从客户端配置和环境中移除旧的密钥路径设置。

git clone https://github.com/sarahpark/google-search-console-mcp.git
cd google-search-console-mcp
npm install
npm run build

在下面的客户端命令中，将 npx -y @sarahpark/[email protected] 替换为 node "/absolute/path/to/google-search-console-mcp/build/index.js"。在 Claude Desktop 中，将 command 设为 node，并将 args 设为包含该绝对路径的数组。运行 npm test 可执行离线身份验证检查。

完成身份验证后，将以下内容粘贴给你的 Agent：

将 npx -y @sarahpark/[email protected] 作为 gsc 添加到此客户端的用户级 MCP 配置中，并保留现有服务。使用我的本地应用默认凭据。完成设置后告诉我是否需要重启客户端。

若使用服务账号，请将“使用我的本地应用默认凭据”替换为“将 GOOGLE_APPLICATION_CREDENTIALS 设置为 /path/to/service-account-key.json”，并填入你实际的文件路径。

完成配置后，跳到第 5 步。

以自己的身份登录（ADC）：

codex mcp add gsc -- npx -y @sarahpark/[email protected]

使用服务账号的 npm 包：

codex mcp add gsc \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/[email protected]

如需在 ~/.codex/config.toml 中手动配置，请参阅 Codex MCP 文档。

以自己的身份登录（ADC）：

claude mcp add gsc --scope user -- npx -y @sarahpark/[email protected]

使用服务账号的 npm 包：

claude mcp add gsc --scope user \
  --env "GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/service-account-key.json" \
  -- npx -y @sarahpark/[email protected]

--scope user 会让所有项目都能使用此服务。使用 --scope project 可通过项目的 .mcp.json 共享配置。

将相应条目添加到 claude_desktop_config.json，并合并到任何现有的 mcpServers 对象中。

以自己的身份登录（ADC）：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/[email protected]"]
    }
  }
}

使用服务账号的 npm 包：

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@sarahpark/[email protected]"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

列出你在 Google Search Console 中有权访问的所有站点（资源）。

无需参数。

查询搜索分析数据，包括点击次数、展示次数、CTR 和排名。

检查网址的索引状态、抓取信息和移动设备适用性。

列出站点已提交的所有站点地图及其状态。

如果错误提示 API“需要配额项目”，请重新运行：

gcloud auth application-default set-quota-project YOUR_PROJECT_ID

你的账号需要拥有该项目的 serviceusage.services.use 权限。如果权限被拒绝，请让项目管理员授予权限，或使用你拥有该权限且已启用 Search Console API 的项目。

登录尝试会自动附加你配置的项目，但如果你没有权限，可能会跳过。明确设置项目可以让此类失败显现出来。设置命令中的 cloud-platform 范围允许附加配额项目。

已确认内置的 gcloud 客户端在 Google Cloud SDK 557.0.0 中能够授予 webmasters.readonly。如果你的版本无法正常工作，请按照 gcloud 关于其他范围的说明创建自己的 OAuth 客户端，然后使用下载的客户端文件登录：

gcloud auth application-default login \
  --client-id-file=client_id.json \
  --scopes=https://www.googleapis.com/auth/webmasters.readonly,https://www.googleapis.com/auth/cloud-platform
gcloud auth application-default set-quota-project YOUR_PROJECT_ID

请将凭据文件保存在代码仓库之外。

有人报告，在添加新创建的服务账号时会出现此问题，这也是提供 ADC 选项的原因。请使用自己的账号登录，或使用已拥有该资源访问权限的现有服务账号。

• 使用 npm 1.0.1 或更早版本： 将客户端命令更新至 1.1.0 或更高版本，以使用本地 gcloud ADC。
• 使用 ADC： 确保旧的 GOOGLE_APPLICATION_CREDENTIALS 设置没有覆盖你的登录信息。已登录的 Google 账号必须拥有该资源的访问权限。
• 使用服务账号： 将 GOOGLE_APPLICATION_CREDENTIALS 设置为密钥的绝对路径，并确认该账号的电子邮件地址已添加到你想读取的每个资源中。