Google Search Console MCP Server

基本能力

产品定位

gsc-mcp-server 是一个用于 SEO 分析和数据可视化的工具，通过与 Google Search Console 集成，帮助用户优化网站搜索性能。

核心功能

1. 数据查询与分析：支持查询搜索控制台数据，包括点击率、展示次数、排名变化等。
2. 时间周期对比：允许用户比较不同时间段的搜索性能。
3. 数据可视化：生成条形图、折线图、热力图等多种图表。
4. 自动化报告：自动生成 SEO 性能报告，识别优化机会。
5. 工具集成：与 Claude Desktop 无缝集成，提供便捷的操作界面。

适用场景

1. SEO 优化：分析关键词表现，识别高潜力优化机会。
2. 性能监控：监控网站搜索性能随时间的变化。
3. 数据可视化：通过图表直观展示搜索数据趋势。
4. 自动化报告：定期生成 SEO 报告，节省手动分析时间。

工具列表

1. list_sites：列出 Google Search Console 中已验证的所有网站。
2. query_search_analytics：查询搜索分析数据，支持多维度筛选。
3. compare_time_periods：比较两个时间段的搜索性能。
4. get_top_performing_content：获取按指定指标排序的顶级内容。
5. get_search_trends：获取搜索趋势数据，支持按时间间隔分组。

常见问题解答

1. 工具未显示：重启 Claude Desktop 或等待几分钟。
2. JSON 凭证文件问题：确保文件路径正确且可访问。
3. uv 未找到错误：更新 Claude Desktop 配置或重新安装 uv。
4. Mac 用户问题：修复 "spawn uv ENOENT" 错误，更新 uv 路径。

使用教程

使用依赖

1. Python：确保已安装 Python。 sh python --version # Windows python3 --version # Linux/macOS
2. pip：确保已安装 pip。 sh pip --version # Windows pip3 --version # Linux/macOS
3. uv：确保已安装 uv。 sh uv --version
4. Git（可选）：用于克隆仓库。 sh git --version

安装教程

1. 克隆仓库： bash git clone https://github.com/seotesting-com/gsc-mcp-server.git cd gsc-mcp-server
2. 创建虚拟环境： ```bash # Windows uv venv .venv\Scripts\activate

# macOS/Linux uv venv source .venv/bin/activate 3. **安装依赖**：bash uv sync 4. **安装 MCP Server**：bash mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS= ``` 5. 重启 Claude Desktop：确保服务生效。

调试方式

1. 检查服务状态：在 Claude Desktop 的开发者设置中查看服务状态。
2. 验证工具可用性：在 Claude Desktop 中尝试使用工具，如： "List all my verified sites in Google Search Console"
3. 查看错误日志：根据错误信息调整配置或重新安装依赖。

许可证

None