Google Search Console MCP 服务器

一个提供对 Google Search Console 访问的 Model Context Protocol (MCP) 服务器。

功能

• 支持维度的搜索分析数据检索
• 通过可定制的报告周期进行丰富的数据分析

前提条件

• 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：

• 转到“API 和服务”>“库”
• 搜索并启用 "Search Console API"

4. 创建凭据：

• 导航到 "API 和服务" > "凭据"
• 点击“创建凭据”>“服务帐户”
• 填写服务帐户详细信息
• 创建 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)
• 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

贡献

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