AI导哈

Google Search Console API服务器

一个通过MCP客户端节点在n8n工作流中提供Google Search Console API功能的服务器。

  • by LeonardSEO
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 LeonardSEO/google-search-console-mcp

使用说明

谷歌搜索控制台MCP服务器

通过 MCP 客户端节点提供 Google Search Console API 用于 n8n 工作流的 MCP 服务器。

功能

  • 列出所有 Search Console 网站
  • Ophalen van搜索分析数据
  • 查看热门搜索词和页面
  • 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. 设置je服务帐户凭据：

    ./setup-credentials.sh

    您可以使用现有的服务帐户凭据文件或直接粘贴JSON。

Google API证书

重新使用现有服务帐户

如果您已经拥有服务帐户（例如 Google Ads），则可以将其用于 Search Console：

  1. 运行设置脚本： ./setup-credentials.sh
  2. 选择选项 1 或 2 以输入您现有的凭据
  3. 让服务帐户访问您的 Search Console 属性：
    • 转到 谷歌搜索控制台
    • 选择属性
    • 点击“设置”>“用户和权限”
    • 向用户添加服务帐户电子邮件地址

创建新服务帐户

如果您还没有服务帐户：

  1. 转到 谷歌云控制台
  2. 创建新项目或使用现有项目
  3. Activeer de Google搜索控制台API
  4. 创建服务账户
  5. 下载 JSON credentials 文件
  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. Kies工具：“get_top_queries”
  4. 参数：
    {
  "site_url": "sc-domain:example.com",
  "start_date": "2023-01-01",
  "end_date": "2023-01-31"
}

可用工具

  • list_网站列出所有 Search Console 网站
  • get_search_analytics获取网站的搜索分析数据
  • get_top_查询获取网站的顶级搜索词
  • 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 属性

许可证

麻省理工学院

贡献

Pull Requests 欢迎。对于重大更改，首先打开一个问题来讨论您想要更改的内容。

相关 MCP