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 控制台
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

贡献

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