AI导哈

搜索控制台数据分析服务器

提供对Google搜索控制台数据的全面访问，并具备增强的分析功能。

  • by ahonn
  • TypeScript
  • 本地部署
  • 281 星标
  • 更新于
在 GitHub 查看 ahonn/mcp-server-gsc

使用说明

谷歌搜索控制台MCP服务器

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

特性

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

赞助

macuse.app 是一个原生macOS应用程序，通过将AI助手与macOS应用程序（如日历、邮件和笔记）集成，以及任何应用程序的通用UI控制，为您的AI提供超能力。一键设置支持Claude Desktop、Cursor和Raycast。隐私第一，在本地运行。

先决条件

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

安装

npm install mcp-server-gsc

身份验证设置

要获取Google Search Console API凭据：

  1. 访问 谷歌云控制台
  2. 创建新项目或选择现有项目
  3. 启用API：
  1. 创建凭据：
  • 引导到 “API和服务”>“凭据”
  • 点击“创建凭据”>“服务帐户”
  • 填写服务帐户详细信息
  • 以JSON格式创建新密钥
  • 凭据文件（.json）将自动下载
  1. 授予访问权限：
  • 打开搜索控制台
  • 添加服务帐户电子邮件（格式：name@project.iam.gserviceaccount.com)作为物业管理人

用法

Claude桌面配置

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

可用工具

搜索分析

通过增强的分析功能从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
}

示例-使用Regex进行高级过滤：

{
  "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
  }
}

许可证

麻省理工学院

贡献

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

相关 MCP