🚀 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 许可证。
贡献
欢迎贡献！在提交拉取请求之前，请阅读我们的贡献指南。