Google Search Console MCP Server

Google Search Console MCP Server

site icon
2025.04.01 1
PythonGoogle Search ConsoleAPI 集成SEO 工具搜索工具开发效率
Google Search Console MCP Server 是一个通过 MCP Client 节点在 n8n 工作流中提供 Google Search Console API 功能的服务器。它允许用户列出所有 Search Console 站点、获取搜索分析数据、查看热门搜索词和页面、检查 URL 索引状态以及查询站点地图信息。
View on GitHub

Overview

基本能力

产品定位

Google Search Console MCP Server 是一个中间件服务,旨在通过 MCP 协议将 Google Search Console API 的功能集成到 n8n 工作流中。

核心功能

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

适用场景

  • SEO 分析和优化
  • 网站性能监控
  • 内容策略制定
  • 自动化报告生成

工具列表

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

常见问题解答

  • 如何设置服务账户凭证?
  • 使用 setup-credentials.sh 脚本设置现有或新的服务账户凭证
  • 如何授权服务账户访问 Search Console 属性?
  • 在 Google Search Console 中添加服务账户电子邮件地址作为用户

使用教程

使用依赖

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

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/google-search-console-mcp.git cd google-search-console-mcp
  2. 创建虚拟环境并安装依赖: bash python3 -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt
  3. 使脚本可执行: bash chmod +x google_search_console_server.py chmod +x setup-credentials.sh
  4. 设置服务账户凭证: bash ./setup-credentials.sh

调试方式

  1. 在 n8n 中添加 MCP Client (STDIO) 节点
  2. 配置凭证:
  3. Command: /path/to/.venv/bin/python
  4. Arguments: /path/to/google_search_console_server.py
  5. Environment: SERVICE_ACCOUNT_JSON=/path/to/service_account_credentials.json
  6. 使用示例工具进行测试,如 list_sitesget_top_pages

许可证

该项目遵循 MIT 开源许可条款。