Google Search Console MCP Server

Google Search Console MCP 服务

一个 Model Context Protocol（MCP）服务，提供对 Google Search Console 数据的全面访问能力，并具备增强的分析功能。

功能

• 增强的搜索分析：最多可检索 25,000 行效果数据
• 高级筛选：支持正则表达式模式和多种筛选运算符
• 快速优化机会检测：自动识别优化机会
• 丰富的维度：分析查询、网页、国家/地区、设备和搜索外观
• 灵活的日期范围：可自定义报告周期，并访问历史数据

赞助商

macuse.app 是一款原生 macOS 应用，可将 AI 助手与 Calendar、Mail 和 Notes 等 macOS 应用集成，并提供适用于任何应用的通用 UI 控制能力，为你的 AI 注入超能力。支持 Claude Desktop、Cursor 和 Raycast，并可一键完成设置。隐私优先，在本地运行。

前提条件

• Node.js 18 或更高版本
• 已启用 Search Console API 的 Google Cloud 项目
• 具有 Search Console 访问权限的服务账号凭据

安装

npm install mcp-server-gsc

身份验证设置

获取 Google Search Console API 凭据：

1. 访问 Google Cloud 控制台
2. 创建新项目或选择现有项目
3. 启用 API：

• 前往“APIs & Services” > “Library”
• 搜索并启用 “Search Console API”

4. 创建凭据：

• 前往 “APIs & Services” > “Credentials”
• 点击“Create Credentials” > “Service Account”
• 填写服务账号详细信息
• 创建一个 JSON 格式的新密钥
• 凭据文件（.json）将自动下载

5. 授予访问权限：

• 打开 Search Console
• 将服务账号邮箱（格式：[email protected]）添加为资源管理员

使用方法

Claude Desktop 配置

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

可用工具

search_analytics

从 Google Search Console 获取全面的搜索效果数据，并提供增强的分析功能。

必需参数：

• siteUrl：网站 URL（格式：http://www.example.com/ 或 sc-domain:example.com）
• startDate：开始日期（YYYY-MM-DD）
• endDate：结束日期（YYYY-MM-DD）

可选参数：

• dimensions：逗号分隔的列表（query、page、country、device、searchAppearance、date）
• type：搜索类型（web、image、video、news、discover、googleNews）
• aggregationType：聚合方法（auto、byNewsShowcasePanel、byProperty、byPage）
• rowLimit：返回的最大行数（默认值：1000，最大值：25000）
• dataState：数据新鲜度（all 或 final，默认值：final）

筛选参数：

• pageFilter：按网页 URL 筛选（支持以 regex: 为前缀的正则表达式）
• queryFilter：按搜索查询筛选（支持以 regex: 为前缀的正则表达式）
• countryFilter：按国家/地区的 ISO 3166-1 alpha-3 代码筛选（例如：USA、CHN）
• deviceFilter：按设备类型筛选（DESKTOP、MOBILE、TABLET）
• searchAppearanceFilter：按搜索功能筛选（例如：AMP_BLUE_LINK、AMP_TOP_STORIES）
• filterOperator：筛选运算符（equals、contains、notEquals、notContains、includingRegex、excludingRegex）

快速优化机会检测：

• detectQuickWins：启用自动检测优化机会（默认值：false）
• quickWinsConfig：快速优化机会检测的配置：
  • positionRange：要考虑的排名范围（默认值：[4, 20]）
  • minImpressions：最低展示次数阈值（默认值：100）
  • minCtr：最低 CTR 百分比（默认值：1）

示例 - 基本查询：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "rowLimit": 5000
}

示例 - 使用正则表达式进行高级筛选：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "page,query",
  "queryFilter": "regex:(AI|machine learning|ML)",
  "filterOperator": "includingRegex",
  "deviceFilter": "MOBILE",
  "rowLimit": 10000
}

示例 - 快速优化机会检测：

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,page",
  "detectQuickWins": true,
  "quickWinsConfig": {
    "positionRange": [4, 15],
    "minImpressions": 500,
    "minCtr": 2
  }
}

许可证

MIT

贡献

欢迎贡献！提交拉取请求前，请阅读我们的贡献指南。