Google Search Console MCP Server

Google Search Console MCP Server

一个 MCP 服务，可通过 MCP Client 节点在 n8n 工作流中使用 Google Search Console API。

功能

• 列出所有 Search Console 站点
• 获取搜索分析数据
• 查看热门搜索词和页面
• 检查 URL 编入索引状态
• 查询站点地图信息

安装

1. 确保服务器已安装 Python 3.7+

2. 克隆仓库：

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

3. 创建虚拟环境并安装依赖：

   python3 -m venv .venv
   source .venv/bin/activate  # Op Windows: .venv\Scripts\activate
   pip install -r requirements.txt
   

4. 将脚本设为可执行：

   chmod +x google_search_console_server.py
   chmod +x setup-credentials.sh
   

5. 设置服务账号凭据：

   ./setup-credentials.sh
   

   你可以使用现有的服务账号凭据文件，也可以直接粘贴 JSON。

Google API 凭据

重用现有服务账号

如果你已有服务账号（例如用于 Google Ads），可以将其用于 Search Console：

1. 运行设置脚本：./setup-credentials.sh
2. 选择选项 1 或 2，输入现有凭据
3. 授予服务账号访问 Search Console 媒体资源的权限：
   • 前往 Google Search Console
   • 选择媒体资源
   • 点击“设置”>“用户和权限”
   • 将服务账号邮箱地址添加为用户

创建新服务账号

如果你还没有服务账号：

1. 前往 Google Cloud Console
2. 创建新项目或使用现有项目
3. 启用 Google Search Console API
4. 创建服务账号
5. 下载 JSON 凭据文件
6. 使用设置脚本配置凭据：./setup-credentials.sh

在 n8n 中使用

1. 打开 n8n 并添加 MCP Client (STDIO) 节点
2. 配置凭据：
   • 命令：/pad/naar/.venv/bin/python（例如：/home/username/google-search-console-mcp/.venv/bin/python）
   • 参数：/pad/naar/google_search_console_server.py（例如：/home/username/google-search-console-mcp/google_search_console_server.py）
   • 环境：

     SERVICE_ACCOUNT_JSON=/pad/naar/service_account_credentials.json
     

示例：获取热门搜索词

1. 在工作流中添加 MCP Client 节点
2. 选择操作“Execute Tool”
3. 选择工具：“get_top_queries”
4. 参数：

   {
     "site_url": "sc-domain:example.com",
     "start_date": "2023-01-01",
     "end_date": "2023-01-31"
   }
   

可用工具

• list_sites：列出所有 Search Console 站点
• get_search_analytics：获取站点的搜索分析数据
• get_top_queries：获取站点的热门搜索词
• get_top_pages：获取站点的热门页面
• get_queries_for_url：获取特定 URL 的搜索词
• inspect_url：检查 URL 编入索引状态
• list_sitemaps：列出站点的所有站点地图

n8n 工作流示例

示例 1：获取所有站点列表

{
  "tool": "list_sites",
  "parameters": {}
}

示例 2：过去 30 天的前 10 个页面

{
  "tool": "get_top_pages",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "start_date": "2023-03-01",
    "end_date": "2023-03-31",
    "row_limit": 10
  }
}

示例 3：检查 URL 编入索引状态

{
  "tool": "inspect_url",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "url": "https://example.com/pagina"
  }
}

自动安装

如需全自动安装，也可以使用 install.sh 脚本：

chmod +x install.sh
./install.sh

安全

• 服务账号凭据保存在本地，不会推送到 Git（通过 .gitignore 实现）
• 始终将 credentials.json 文件保存在安全的位置
• 仅授予服务账号访问其所需 Search Console 媒体资源的权限

许可证

MIT

贡献

欢迎提交 Pull Request。对于较大的更改，请先创建 issue，讨论你想要更改的内容。