AI导哈

Google搜索控制台服务器

一个快速的单二进制MCP服务器，用于Google搜索控制台，提供搜索分析、URL检查、站点地图、索引、站点验证和属性管理等23种工具。

  • by eyupcanakman
  • Rust
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 eyupcanakman/gsc-mcp-rs

使用说明

gsc mcp rs

用于谷歌搜索控制台的快速单二进制MCP服务器。23种工具，涵盖搜索分析、URL检查、网站地图、索引、网站验证和物业管理。

特性

  • 跨9个组的23个工具：分析、发现、检查、站点地图、索引、属性、元
  • 未验证属性的端到端验证流程（DNS TXT/CNAME、HTML文件、元标记等）
  • 两种身份验证方法：OAuth 2.0（个人）和服务帐户（自动化）
  • UI错误：操作错误返回指导文本，永远不会中断对话
  • 零运行时deps：单个Rust二进制文件，不需要Node/Python/Java
  • sc域：支持：域属性从第一天起就正常工作

快速开始

安装

cargo install gsc-mcp-rs

或者从源代码构建：

git clone https://github.com/eyupcanakman/gsc-mcp-rs.git
cd gsc-mcp-rs
cargo build --release

配置身份验证

选项1:OAuth（个人使用）

  1. 首选 谷歌云控制台 >API和服务>凭据
  2. 创建OAuth 2.0客户端ID（桌面应用程序类型）
  3. 在同一项目上启用这些API：搜索控制台API、索引API、站点验证API
  4. 保存凭据：
mkdir -p ~/.config/gsc-mcp-rs
cat > ~/.config/gsc-mcp-rs/oauth_credentials.json << 'EOF'
{"client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET"}
EOF
  1. 身份验证（打开浏览器，通过localhost回调完成）：
gsc-mcp-rs auth

选项2：服务帐户（自动化）

  1. 在Google Cloud Console中创建服务帐户
  2. 授予它访问您的搜索控制台属性的权限（完全权限）
  3. 下载JSON密钥并放置：
cp your-key.json ~/.config/gsc-mcp-rs/service_account.json

或者设置环境变量：

export GSC_SERVICE_ACCOUNT_PATH=/path/to/key.json

添加到克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gsc": {
      "command": "gsc-mcp-rs",
      "args": ["stdio"]
    }
  }
}

添加到克劳德代码

claude mcp add gsc-mcp-rs -- gsc-mcp-rs stdio

工具（23）

属性和身份验证

工具 说明
list_sites 列出所有可访问的GSC属性及其权限级别
get_site_details 获取验证状态和所有权详细信息
manage_site 添加或删除属性(action: "add"|"delete"，幂等）
start_site_verification 为未验证的属性创建验证令牌（DNS TXT/CNAME、HTML文件、元标记等）
verify_site 在代币到位后，要求谷歌确认所有权
reauthenticate 清除帐户切换令牌

搜索分析

工具 说明
search_analytics 所有维度、过滤器、25K行、排序。使用 breakdown 用于设备/国家拆分
compare_periods 与三角洲同期比较
performance_overview 快速汇总汇总+每日趋势
page_query_breakdown 哪些查询将流量导向特定页面

发现与分析

工具 说明
top_pages 按点击次数/展示次数/点击率/位置排名的最佳页面
keyword_opportunities 5种模式： quick_wins （默认）， cannibalization, ctr_gaps, declining, growing
brand_query_analysis 品牌与非品牌流量分配
keyword_trend 每日跟踪单个关键字
detect_anomalies 具有严重级别的自动跌落检测

搜索外观

工具 说明
query_by_search_appearance 按丰富结果类型筛选（常见问题解答、视频等）

出口

工具 说明
export_analytics 强制导出大型数据集的CSV文件

URL 检查

工具 说明
inspect_url 检查单个URL的索引状态
batch_inspect_urls 使用可配置的并发性检查多达50个URL

站点地图

工具 说明
list_sitemaps 列出提交的站点地图及其状态
manage_sitemap 提交或删除站点地图(action: "submit"|"delete"，幂等）

API索引

工具 说明
request_indexing 请求Google抓取URL

元

工具 说明
api_reference 所有维度和指标，包括描述和值范围

环境变量

变量 默认值 描述
GSC_MCP_CONFIG_DIR ~/.config/gsc-mcp-rs/ 配置和令牌存储目录
GSC_MCP_OUTPUT_DIR 系统临时目录 CSV导出目录
GSC_SERVICE_ACCOUNT_PATH （无） 服务帐户JSON密钥的路径

CLI使用情况

gsc-mcp-rs stdio         # stdio transport (default)
gsc-mcp-rs auth          # Interactive OAuth flow
gsc-mcp-rs --version     # Show version
gsc-mcp-rs --help        # Show help

码头工人

docker build -t gsc-mcp-rs .
docker run -i --rm -v ~/.config/gsc-mcp-rs:/root/.config/gsc-mcp-rs gsc-mcp-rs

支持的最低Rust版本（MSRV）

锈 1.85 或稍后。

贡献

看 贡献.md 用于开发设置和指南。

安全

看 安全.md 用于漏洞报告过程。

许可证

MIT。看 许可证.

相关 MCP