Google Search Console MCP 服务器

一个提供全面访问 Google Search Console 数据并增强分析能力的模型上下文协议（MCP）服务器。

赞助商

功能

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

先决条件

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Google Search Console：

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

手动安装

npm install mcp-server-gsc

认证设置

获取 Google Search Console API 凭证：

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

• 转到 "APIs & Services" > "Library"
• 搜索并启用 "Search Console API"

4. 创建凭证：

• 导航到 "APIs & Services" > "Credentials"
• 点击 "Create Credentials" > "Service Account"
• 填写服务账户详细信息
• 创建一个 JSON 格式的新密钥
• 凭证文件 (.json) 将自动下载

5. 授予访问权限：

• 打开 Search Console
• 将服务账户邮箱（格式：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 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: 最小点击率百分比（默认：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

贡献

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