Google Search Console MCP Server

Google Search Console MCP 服务

本项目提供一个 Model Context Protocol (MCP) 服务，允许 Claude AI（通过 Claude 桌面应用）或其他工具与 Google Search Console API 进行交互。你可以直接在你的 Claude 聊天（或其他工具）中查询性能数据、检查 URL、查看索引状态等。

你可以在 X 上关注我 @metehan777，并访问我的博客 https://metehan.ai

功能

基于本项目允许使用的 Google Search Console API 端点：

• 站点： 列出你的 Search Console 账户中可访问的站点/媒体资源。
• 搜索分析： 使用各种过滤条件和维度获取搜索性能数据（点击次数、展示次数、CTR、排名）。
• URL 检查： 检查特定 URL 在 Google 索引中的状态，查看其索引状态，并请求编入索引。
• 站点地图： 列出某个站点已提交的站点地图。
• （辅助） 获取站点整体性能摘要（派生自搜索分析数据）。

（注意：索引覆盖详情以及 URL Inspection API 之外可用的抓取错误，通常不会通过 Google Search Console API 暴露。）

在此查看 Search Console API 的功能与公告：https://developers.google.com/webmaster-tools/v1/api_reference_index

前置条件

• Python： 版本 3.11 或更高。
• pip： Python 包安装器（通常随 Python 一起提供）。
• 虚拟环境工具： venv（推荐，内置于 Python 3）。
• Google 账户： 拥有你想要查询的 Google Search Console 媒体资源的访问权限。
• Claude 桌面应用： 已安装并正在运行。

设置说明

1. 克隆或下载： 将项目文件获取到你的本地机器。如果使用 git：

   git clone https://github.com/metehan777/google-search-console-mcp.git
   cd search-console-mcp
   

2. 创建并激活虚拟环境： 强烈建议使用虚拟环境来管理依赖项。

   # Create the virtual environment (using the name 'fresh_env' as in previous steps)
   python3 -m venv fresh_env
   
   # Activate the environment
   # On macOS/Linux:
   source fresh_env/bin/activate
   # On Windows:
   # .\fresh_env\Scripts\activate
   

   （你应该会在终端提示符的开头看到 (fresh_env)）

3. 安装依赖项： 安装所需的 Python 包，包括以可编辑模式安装项目本身。

   pip install -e .
   

4. Google Cloud 设置与凭据：

   • 启用 API： 前往 Google Cloud Console 并创建一个新项目或选择一个现有项目。为你的项目启用 "Google Search Console API"。
   • 创建 OAuth 凭据：
     • 导航到 "APIs & Services" -> "Credentials"。
     • 点击 "+ CREATE CREDENTIALS" -> "OAuth client ID"。
     • 如果出现提示，请配置 "OAuth consent screen"（选择 "External" 用户类型，提供一个应用名称，如 "Claude GSC Tool"，填写你的电子邮件，然后保存）。
     • 对于 "Application type"，选择 "Desktop app"。
     • 为它命名（例如 "Claude Desktop GSC Tool"）。
     • 点击 "Create"。
   • 下载 credentials.json： 创建完成后，点击 "DOWNLOAD JSON"。将此文件直接保存到你的项目目录根目录（search-console-mcp/）中，并确保其名称完全为 credentials.json。
   • 重要： 确保 credentials.json 已列在你的 .gitignore 文件中，以免意外提交它。

5. 初始身份验证：

   • 首次运行需要身份验证的工具时（无论是手动还是通过 Claude），都会触发 Google OAuth 流程。
   • 你的网页浏览器应该会打开，要求你登录拥有 Search Console 媒体资源访问权限的 Google 账号。
   • 向你配置的应用程序（"Claude GSC Tool"）授予所请求的权限。
   • 授权成功后，会在你的项目目录中创建一个 token.json 文件。它用于存储你的访问令牌。如果你打算 fork 此仓库并再次 push/pull，请不要提交 token.json。

运行服务（开发/测试）

虽然主要用途是通过 Claude Desktop 集成，但你也可以使用 stdio 传输方式直接测试该服务： 服务将启动并在标准输入/输出上等待 JSON-RPC 消息。你可以按 Ctrl+C 来停止它。日志将打印到标准错误。

Claude Desktop 集成

要让这些工具在 Claude Desktop 应用中使用：

1. 找到配置文件： 找到 Claude Desktop 配置文件。在 macOS 上，它通常位于： ~/Library/Application Support/Claude/claude_desktop_config.json

2. 编辑配置： 在文本编辑器中打开该文件。添加或修改 mcpServers 部分，为此工具添加一个条目。使用虚拟环境中 python3 可执行文件的绝对路径。

   {
     "mcpServers": {
       "filesystem": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-filesystem",
           "/Users/username/Desktop",
           "/Users/username/Downloads"
         ]
       },
       "google-search-console": {
         "command": "/Users/username/Documents/search-console-mcp/fresh_env/bin/python3",
         "args": [
           "-m",
           "main"
         ],
         "cwd": "/Users/username/Cursor/search-console-mcp"
       }
     }
   }
   

   • 重要： 在 command 和 cwd 字段中，都将 /Users/username/Documents/search-console-mcp 替换为你系统上项目目录的实际绝对路径。
   • 如果 mcpServers 中已有其他服务，只需在它们旁边添加 "google-search-console": { ... } 块即可。

3. 重启 Claude Desktop： 关闭并重新打开 Claude Desktop 应用，使更改生效。

在 Claude 中使用

设置并集成完成后，你可以让 Claude 使用这些工具。例如：

• “列出我在 Google Search Console 中的站点。”
• “获取 example.com 过去 7 天的搜索表现，按查询细分。”
• “检查站点 example.com 上的 URL https://example.com/my-page。”
• “example.com 是否存在任何移动端可用性问题？”
• “将 https://example.com/new-article 提交到站点 example.com 进行索引。”

Claude 应识别出合适的工具，并通过 MCP 服务执行它。如果出现提示，记得在初始认证流程中授予权限。

你可以随时贡献或提出改进建议！