Google 搜索控制台 MCP 服务器

这是一个提供全面访问 Google 搜索控制台数据并具有增强分析能力的模型上下文协议（MCP）服务器。

赞助商

<a href="https://macuse.app"> <img src="https://macuse.app/logo.png" width="100" alt="Macuse"> </a>

功能

• 增强搜索分析：获取多达 25,000 行的性能数据
• 高级过滤：支持正则表达式模式和多个过滤操作符
• 快速改进检测：自动识别优化机会
• 丰富的维度：查询、页面、国家、设备和搜索外观分析
• 灵活的日期范围：可定制的报告周期，带有历史数据访问权限

预备条件

• Node.js 18 或更高版本
• 启用了搜索控制台 API 的 Google Cloud 项目
• 具有搜索控制台访问权限的服务账户凭据

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Google 搜索控制台：

npx -y @smithery/cli install mcp-server-gsc --client claude

手动安装

npm install mcp-server-gsc

认证设置

要获取 Google 搜索控制台 API 凭据：

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

• 前往 "APIs & Services" > "库"
• 搜索并启用 "搜索控制台 API"

4. 创建凭据：

• 导航到 "APIs & Services" > "凭据"
• 点击 "创建凭据" > "服务账户"
• 填写服务账户详情
• 创建一个新的 JSON 格式的密钥
• 凭据文件（.json）将自动下载

5. 授予权限：

• 打开搜索控制台
• 将服务账户电子邮件（格式：name@project.iam.gserviceaccount.com）添加为属性管理员

使用方法

Claude Desktop 配置

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

可用工具

search_analytics

从 Google 搜索控制台获取全面的搜索性能数据，并具有增强的分析能力。

必需参数：

• 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：最低点击率百分比（默认：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

贡献

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