适合谁
- 需要经常分析 GSC 搜索表现数据的 SEO 从业者
- 使用 Claude Desktop、Cursor、Codex CLI、Gemini CLI 或 Antigravity 等 MCP 客户端的用户
- 希望通过自然语言对话而非手动导出报表来获取洞察的个人或小团队
- 愿意自行配置 Google Cloud 凭据并本地运行服务器的用户
G
63FMRS · C
这是一个由社区作者维护、以 MIT 许可发布的非官方 MCP 服务器，把 Google Search Console 接入支持 MCP 的 AI 客户端。它的优势是覆盖站点属性、搜索分析、URL 检查与站点地图管理等完整流程，支持 uvx 免安装运行，OAuth 与服务账号两种认证方式，并可通过 sse 传输远程部署。代价是用户需要自行创建 Google Cloud 凭据，凭据与账号权限由用户自己管理，克隆安装还要求 Python 3.11+。适合愿意自己动手配置的 SEO 用户，不适合只想用网页版或不愿管理凭据的人。
这是一个 Model Context Protocol (MCP) 服务器，将 Google Search Console (GSC) 连接到 AI 助手，让你通过自然语言对话分析 SEO 数据。它覆盖站点属性管理、搜索分析报告、URL 检查和索引状态、以及站点地图管理，并支持可视化图表输出。服务器以本地方式运行，支持 OAuth 浏览器登录（推荐，使用自己的 Google 账号）或服务账号（适合自动化或团队使用）两种认证方式。客户端配置示例中需要提供凭据文件的绝对路径；首次使用时 OAuth 会打开浏览器窗口登录，之后令牌会被缓存。可通过 uvx 免安装运行，也可克隆仓库本地运行（需要 Python 3.11+）。此外还支持 MCP_TRANSPORT=sse 的远程/网络部署与 Docker 容器运行。提供的工具包括属性列表、站点详情、搜索分析、性能概览、时段对比、按页面查询、带筛选的高级分析、URL 检查、批量 URL 检查、索引问题检查、站点地图查看与管理、重新认证以及 get_capabilities 能力查询。
工具能力
get_capabilities
列出所有可用工具并显示当前认证状态，不确定时先调用它
list_properties
显示你所有的 GSC 站点属性
get_site_details
查看特定站点的详情
get_search_analytics
返回热门查询和页面及其点击、展示、CTR 和排名
get_performance_overview
给出站点表现的总体摘要
compare_search_periods
对比两个时间段的性能表现
get_search_by_page_query
查看为某个特定页面带来流量的搜索词
get_advanced_search_analytics
支持按国家、设备、查询、页面筛选的分析
inspect_url_enhanced
获取某个 URL 的详细抓取与索引状态
batch_url_inspection
一次检查最多 10 个 URL
check_indexing_issues
检查多个 URL 是否存在索引问题
get_sitemaps
列出某个站点的所有站点地图
list_sitemaps_enhanced
更详细的站点地图信息，包括错误和警告
manage_sitemaps
提交或删除站点地图
reauthenticate
重新运行 OAuth 浏览器登录（用于切换账号）
安装接入
- 准备 Google API 凭据：在 Google Cloud Console 创建项目，启用 Search Console API，然后选择 OAuth 客户端 ID（桌面应用，下载 JSON 保存到固定位置）或创建服务账号并下载 JSON 密钥（服务账号邮箱需在 GSC 设置中加为完全权限用户）。2. 安装 uv 并依次执行三条命令：curl -LsSf https://astral.sh/uv/install.sh | sh；source $HOME/.local/bin/env；echo 'source $HOME/.local/bin/env' >> ~/.zshrc，然后用 uv --version 验证。3. 在 AI 客户端配置文件中添加 mcpServers 配置，command 填 uvx 的绝对路径（macOS/Linux 用 which uvx 查询），args 为 ["mcp-search-console"]，并在 env 中设置 GSC_OAUTH_CLIENT_SECRETS_FILE 或 GSC_CREDENTIALS_PATH 与 GSC_SKIP_OAUTH。Claude Desktop 配置文件为 ~/Library/Application Support/Claude/claude_desktop_config.json，Cursor 为 ~/.cursor/mcp.json，Codex CLI 为 ~/.codex/config.toml。4. 保存后完全退出应用（Cmd+Q）再重开。5. 向 AI 助手提问“列出我的 GSC 属性”进行测试，若失败可让它“调用 get_capabilities”查看认证状态。克隆安装方式需要 Python 3.11+，使用 uv venv .venv 和 uv pip install -r requirements.txt。
claude_desktop_config.json
{
"mcpServers": {
"gscServer": {
"command": "/FULL/PATH/TO/uvx",
"args": ["mcp-search-console"],
"env": {
"GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
}
}
}
}
选型与风险
不适合谁
- 只想在 claude.ai 网页版中使用而不安装桌面应用的用户（MCP 服务器仅在本地运行）
- 不愿创建 Google Cloud 项目和 API 凭据的用户
- 需要托管式一键登录与 GA4 工具的用户（源码提示有单独的托管版本，仅 100 个席位）
- 使用 Python 3.10 或更旧版本运行克隆安装的用户
所需权限
- Google Search Console API 访问权限（读取搜索分析与站点数据）
- OAuth 方式需要 Google 账号授权，令牌缓存在本地
- 服务账号方式需要将服务账号邮箱以完全权限用户身份添加到 GSC 属性
- 凭据 JSON 文件路径由用户在客户端配置的 env 中提供
- 默认禁用破坏性操作（add_site、delete_site、delete_sitemap），需显式设置 GSC_ALLOW_DESTRUCTIVE=true 才启用
风险与副作用
- 凭据 JSON 文件包含敏感密钥，需妥善保管并避免提交到版本库
- 若启用 GSC_ALLOW_DESTRUCTIVE，AI 助手可执行添加/删除站点和删除站点地图等破坏性操作
- 使用 sse 传输并绑定 0.0.0.0 进行远程部署时，服务暴露在网络上，需自行评估访问控制风险
- OAuth 令牌缓存在本地用户配置目录中，多用户机器上可能存在访问边界问题
- 服务账号密钥长期有效，泄露后影响范围较大
常见排障
- 出现 spawn uvx ENOENT 或 command not found: uvx：在配置中使用 uvx 的完整绝对路径（macOS/Linux 用 which uvx，Windows 用 Get-Command uvx | Select-Object -ExpandProperty Source）
- uv --version 报 command not found：执行 source $HOME/.local/bin/env，并把该命令追加到 ~/.zshrc
- 认证失败或找不到凭据文件：确认使用绝对路径而非相对路径或 ~/ 形式
- MCP 只在 Claude 桌面应用中生效、网页版不生效：这是预期行为，需从 claude.ai/download 下载桌面应用
- 修改配置后仍不生效：完全退出应用（Cmd+Q）再重开，仅关闭窗口不够
- 克隆安装启动失败且无日志：确认 Python 版本为 3.11 或更高，否则重建虚拟环境
- 不确定可用工具或认证状态：让助手调用 get_capabilities
- uvx 全新安装因 mcp 2.0 崩溃（ModuleNotFoundError: No module named 'mcp.server.fastmcp'）：0.3.3 已通过固定 mcp[cli]<2.0.0 修复
- macOS 上 uvx 运行时不弹出 OAuth 浏览器窗口：0.3.2 已修复该问题
使用场景
用自然语言查询哪些搜索词带来流量以及点击、展示、CTR 和排名
对比两个时间段的表现，找出提升最多的查询
检查具体页面是否存在索引问题，以及 Google 最近抓取的时间
批量检查多个 URL 以发现规律性问题
查看、提交或删除站点地图并检查错误与警告
按国家、设备、查询或页面筛选进行高级搜索分析
让 AI 助手生成性能趋势图表和标题优化建议
支持客户端
Claude Desktop完整支持
Cursor完整支持
Codex CLI完整支持
Gemini CLI部分支持
Antigravity部分支持