Google 搜索控制台 MCP 服务器

一个提供 Google Search Console API 的 MCP 服务器，可用于 n8n 工作流中的 MCP 客户端节点。

功能

• 列出所有搜索控制台站点
• 获取搜索分析数据
• 查看顶级搜索词和页面
• 检查 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  # 在 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），可以重复使用它来处理搜索控制台：

1. 运行设置脚本：./setup-credentials.sh
2. 选择选项 1 或 2 来输入现有的凭证
3. 将服务账户电子邮件地址添加到您的 Search Console 属性的用户中：
   • 转到 Google 搜索控制台
   • 选择属性
   • 点击设置 > 用户和权限
   • 添加服务账户电子邮件地址作为用户

创建新服务账户

如果没有服务账户：

1. 转到 Google Cloud Console
2. 创建新项目或使用现有项目
3. 启用 Google Search Console API
4. 创建一个服务账户
5. 下载 JSON 凭证文件
6. 使用设置脚本来配置凭证：./setup-credentials.sh

与 n8n 一起使用

1. 打开 n8n 并在工作流中添加一个 MCP 客户端（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 客户端节点
2. 选择操作“执行工具”
3. 选择工具：get_top_queries
4. 参数：

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

可用工具

• list_sites：列出所有搜索控制台站点
• get_search_analytics：获取搜索分析数据
• get_top_queries：获取顶级搜索词
• inspect_url：检查 URL 索引状态
• get_sitemap_info：获取站点地图信息

自动安装

要进行完全自动安装，也可以使用 install.sh 脚本：

chmod +x install.sh
./install.sh

安全性

• 服务账户凭证在本地保存并避免推送到 Git（通过 .gitignore）
• 总是将 credentials.json 文件放在安全的位置
• 只给需要的服务账户授与搜索控制台属性的访问权限

许可证

MIT

贡献

欢迎提交拉取请求。对于较大的更改，请先打开问题讨论您想要更改的内容。