金大哥 - google-search-console-mcp-server-ns9 MCP 详情

article

README

🚀 Google 搜索控制台 MCP 服务器

这是一个提供 Google Search Console API 的 MCP 服务器，可无缝集成到 n8n 工作流中的 MCP 客户端节点，为您的搜索数据管理带来便利。

🚀 快速开始

本服务器可提供 Google Search Console API，用于 n8n 工作流中的 MCP 客户端节点。以下是使用该服务器的基本步骤。

✨ 主要特性

列出所有搜索控制台站点
获取搜索分析数据
查看顶级搜索词和页面
检查 URL 索引状态
查询站点地图信息

📦 安装指南

手动安装

确保服务器上已安装 Python 3.7+。

克隆仓库：

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

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

python3 -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
pip install -r requirements.txt

将脚本设置为可执行：

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

设置服务账户凭证：
```
./setup-credentials.sh
```
您可以使用现有的服务账户凭证文件，或者直接粘贴 JSON。

自动安装

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

chmod +x install.sh
./install.sh

📚 详细文档

Google API 凭证

使用现有服务账户

如果您已经拥有一个服务账户（例如用于 Google Ads），可以重复使用它来处理搜索控制台：

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

创建新服务账户

如果没有服务账户：

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

与 n8n 一起使用

基本配置

打开 n8n 并在工作流中添加一个 MCP 客户端（STDIO）节点
配置凭证：
- 命令：/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
```

示例：获取顶级搜索词

在工作流中添加一个 MCP 客户端节点
选择操作“执行工具”
选择工具：get_top_queries

参数：

{
  "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：获取站点地图信息

安全性

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

📄 许可证

本项目采用 MIT 许可证。

💡 贡献说明

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

google-search-console-mcp-server-ns9