搜索控制台数据服务

提供Google搜索控制台数据访问的模型上下文协议服务器,支持搜索分析数据检索和自定义报告周期。

  • by fandungptit
  • 本地部署
  • 更新于
在 GitHub 查看 fandungptit/mcp-server-gsc

使用说明

谷歌搜索控制台MCP服务器

提供对Google搜索控制台访问的模型上下文协议(MCP)服务器。

特性

  • 支持维度的搜索分析数据检索
  • 丰富的数据分析,可定制报告期

先决条件

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版谷歌搜索控制台 史密瑟里:

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

手动安装

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)
  • type:搜索类型(web, image, video, news)
  • aggregationType:聚合方法(auto, byNewsShowcasePanel, byProperty, byPage)
  • rowLimit:要返回的最大行数(默认值:1000)

例子:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

许可证

麻省理工学院

贡献

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