Google Search Console MCP 服务器

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

功能

• 列出所有 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  # 在 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. 配置凭据：
   • Command: /path/to/.venv/bin/python (例如 /home/username/google-search-console-mcp/.venv/bin/python)
   • Arguments: /path/to/google_search_console_server.py (例如 /home/username/google-search-console-mcp/google_search_console_server.py)
   • Environment:

     SERVICE_ACCOUNT_JSON=/path/to/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 来讨论你想要更改的内容。