🚀 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 凭证：

1. 访问 Google Cloud Console。
2. 创建新项目或选择现有项目。
3. 启用 API：
   • 转到 "APIs & Services" > "Library"。
   • 搜索并启用 "Search Console API"。
4. 创建凭证：
   • 导航到 "APIs & Services" > "Credentials"。
   • 点击 "Create Credentials" > "Service Account"。
   • 填写服务账户详细信息。
   • 创建新的 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）。
• 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 许可证。

贡献

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