JinDaGe - mcp-server-gsc MCP Details

article

README

🚀 Google搜索控制台 MCP 服务器

本项目是一个模型上下文协议（MCP）服务器，它能够提供Google搜索控制台的访问权限，助力用户获取和分析搜索相关数据。

🚀 快速开始

本服务器可提供Google搜索控制台的访问权限，能帮助用户进行维度分析数据检索和丰富的数据分析。

✨ 主要特性

支持维度的分析数据检索。
具备丰富的数据分析功能，支持自定义报告周期。

📦 安装指南

先决条件

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

安装步骤

使用 Smithery 安装

通过 Smithery 自动安装 Claude Desktop 中的Google搜索控制台：

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

手动安装

npm install mcp-server-gsc

📚 详细文档

认证设置

获取 Google 搜索控制台 API 凭证：

访问 Google Cloud Console。
创建新项目或选择现有项目。
启用 API：
- 转到 "APIs & Services" > "Library"。
- 搜索并启用 "Search Console API"。
创建凭证：
- 导航到 "APIs & Services" > "Credentials"。
- 点击 "Create Credentials" > "Service Account"。
- 填写服务账户详细信息。
- 创建新的 JSON 格式密钥。
- 凭证文件（.json）会自动下载。
授予访问权限：
- 打开搜索控制台。
- 将服务账户电子邮件（格式：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）。
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
}

📄 许可证

本项目采用 MIT 许可证。

贡献

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

mcp-server-gsc