mcp谷歌gsc
用于Google搜索控制台的MCP服务器——通过Claude进行搜索分析、URL检查和站点管理。
特性
- 搜索分析 --使用灵活的维度过滤器（查询、页面、设备、国家、日期）查询点击次数、展示次数、点击率和位置
- URL 检查 --检查任何URL的索引状态、移动可用性和丰富结果
- 网站列表 --列出您的服务帐户可访问的所有经过验证的Search Console属性
- 多客户端支持 --使用每个目录的配置映射管理多个GSC属性
安装
来自npm
npm install mcp-google-gsc来源
git clone https://github.com/mharnett/mcp-search-console.git
cd mcp-google-gsc
npm install
npm run build配置
安全： 永远不要分享你的 .mcp.json 文件或将其提交到git——它可能包含API凭据。添加 .mcp.json 到你的 .gitignore.
服务帐户设置
- 使用搜索控制台API访问创建Google云服务帐户
- 下载JSON密钥文件
- 在Google Search Console中为每个酒店添加服务帐户电子邮件作为用户
配置文件
创建一个 config.json 在项目根目录中（请参见 config.example.json 对于整个结构）：
{
"default_credentials": "/path/to/service-account-key.json",
"clients": {
"my-project": {
"site_url": "sc-domain:example.com",
"credentials": "/path/to/service-account-key.json"
}
}
}环境变量
或者，设置 GOOGLE_APPLICATION_CREDENTIALS 转到您的服务帐户密钥文件的路径。配置文件存在时优先。
用法
添加到您的克劳德代码 .mcp.json:
{
"mcpServers": {
"gsc": {
"command": "node",
"args": ["/path/to/mcp-gsc/dist/index.js"]
}
}
}或者，如果全局安装：
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["mcp-google-gsc"]
}
}
}克劳德桌面： 添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）。
工具
| 工具 | 说明 |
|---|---|
gsc_get_client_context | 根据配置映射从工作目录中检测GSC属性 |
gsc_list_sites | 列出服务帐户可访问的所有已验证的Search Console属性 |
gsc_search_analytics | 使用维度和过滤器支持查询搜索性能数据（点击、展示、点击率、位置） |
gsc_inspection | 检查URL的索引状态、移动可用性和丰富结果 |
gsc_search_analytics
支架尺寸： query, page, device, country, date.使用以下运算符按任何维度过滤 equals, contains, notContains。日期范围默认为过去28天。
gsc检验
返回属性中特定URL的索引覆盖率、爬网状态、移动可用性判断和丰富的结果详细信息。
建筑
- 韧性 --在所有Google API调用上使用具有指数退避和断路器模式的cockatiel进行重试
- 日志记录 --通过具有可配置日志级别的pino进行结构化日志记录
- 响应处理 --响应被截断为200KB，以保持在MCP传输限制范围内
许可证
麻省理工学院——见 许可证.
______________________________________________________________________
由Mark Harnett建造/ 德雷克营销