谷歌搜索控制台MCP服务器
模型上下文协议(MCP)服务器,提供对Google Search Console数据的全面访问,并具有增强的分析功能。
特性
- 增强搜索分析:检索多达25000行性能数据
- 高级过滤:支持正则表达式模式和多个过滤运算符
- 速赢检测:自动识别优化机会
- 丰富的维度:查询、页面、国家、设备和搜索外观分析
- 灵活的日期范围:可定制的报告期,可访问历史数据
赞助
macuse.app 是一个原生macOS应用程序,通过将AI助手与macOS应用程序(如日历、邮件和笔记)集成,以及任何应用程序的通用UI控制,为您的AI提供超能力。一键设置支持Claude Desktop、Cursor和Raycast。隐私第一,在本地运行。
先决条件
- Node.js 18或更高版本
- 启用搜索控制台API的谷歌云项目
- 具有搜索控制台访问权限的服务帐户凭据
安装
npm install mcp-server-gsc身份验证设置
要获取Google Search Console API凭据:
- 访问 谷歌云控制台
- 创建新项目或选择现有项目
- 启用API:
- 转到“API和服务”>“库”
- 搜索并启用 “搜索控制台API”
- 创建凭据:
- 引导到 “API和服务”>“凭据”
- 点击“创建凭据”>“服务帐户”
- 填写服务帐户详细信息
- 以JSON格式创建新密钥
- 凭据文件(.json)将自动下载
- 授予访问权限:
- 打开搜索控制台
- 添加服务帐户电子邮件(格式:name@project.iam.gserviceaccount.com)作为物业管理人
用法
Claude桌面配置
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}可用工具
搜索分析
通过增强的分析功能从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,date)type:搜索类型(web,image,video,news,discover,googleNews)aggregationType:聚合方法(auto,byNewsShowcasePanel,byProperty,byPage)rowLimit:要返回的最大行数(默认值:1000,最大值:25000)dataState:数据新鲜度(all或final,默认值:final)
过滤器参数:
pageFilter:按页面URL筛选(支持正则表达式regex:前缀)queryFilter:按搜索查询筛选(支持正则表达式regex:前缀)countryFilter:按国家ISO 3166-1 alpha-3代码过滤(例如。,USA,CHN)deviceFilter:按设备类型筛选(DESKTOP,MOBILE,TABLET)searchAppearanceFilter:按搜索特征过滤(例如。,AMP_BLUE_LINK,AMP_TOP_STORIES)filterOperator:过滤器操作员(equals,contains,notEquals,notContains,includingRegex,excludingRegex)
速赢检测:
detectQuickWins:启用优化机会的自动检测(默认值:false)quickWinsConfig:速赢检测配置:
- positionRange:要考虑的位置范围(默认值: [4, 20]) - minImpressions:最小展示阈值(默认值: 100) - minCtr:最小CTR百分比(默认值: 1)
示例-基本查询:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"rowLimit": 5000
}示例-使用Regex进行高级过滤:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "page,query",
"queryFilter": "regex:(AI|machine learning|ML)",
"filterOperator": "includingRegex",
"deviceFilter": "MOBILE",
"rowLimit": 10000
}示例-速赢检测:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"detectQuickWins": true,
"quickWinsConfig": {
"positionRange": [4, 15],
"minImpressions": 500,
"minCtr": 2
}
}许可证
麻省理工学院
贡献
欢迎投稿!在提交pull请求之前,请阅读我们的贡献指南。
