🚀 谷歌搜索控制台MCP服务器用于Claude
本项目提供了一个模型上下文协议（MCP）服务器，可让Claude AI（通过Claude桌面应用程序）与Google Search Console API进行交互。你能直接在Claude聊天中查询性能数据、检查URL、查看索引状态等。
🚀 快速开始
此项目提供的服务器允许Claude AI与Google Search Console API交互，你可直接在Claude聊天中进行各类操作，如查询性能数据、检查URL等。
✨ 主要特性
基于此项目中Google Search Console API端点允许的功能如下：
- 站点：列出你搜索控制台账户可访问的网站/属性。
- 搜索分析：获取搜索表现数据（点击量、展现量、CTR、排名）以及各种筛选和维度。
- URL检查：检查特定URL在Google索引中的状态，查看其索引状态并请求索引。
- Sitemap：列出网站提交的Sitemap。
- (辅助) 获取站点性能摘要：基于搜索分析数据。
⚠️ 重要提示
指数覆盖详细信息和爬取错误通常不在URL检查API之外通过Google Search Console API提供。
📦 安装指南
先决条件
- Python：版本3.11或更高。
- pip：Python包安装程序（通常随Python一起提供）。
- 虚拟环境工具：
venv（推荐，内置在Python 3中）。 - Google账户：具有访问你想要查询的Google Search Console属性的权限。
- Claude桌面应用程序：已安装并运行。
设置步骤
- 克隆或下载 将项目文件获取到本地机器。如果使用git：
git clone
cd search-console-mcp
⚠️ 重要提示
将
替换为实际的仓库URL，否则直接导航到下载目录。
- 创建并激活虚拟环境 建议使用虚拟环境来管理依赖项。
# 创建虚拟环境（使用名称 'fresh_env'）
python3 -m venv fresh_env
# 激活环境
# 在macOS/Linux上：
source fresh_env/bin/activate
# 在Windows上：
# .\fresh_env\Scripts\activate
💡 使用建议
激活环境后，你应该会在终端提示符前看到
(fresh_env)。
- 安装依赖项 安装所需的Python包，包括以编辑模式安装的项目。
pip install -e .
-
Google Cloud设置及凭证
- 启用API：转到 Google Cloud Console 并创建新项目或选择现有项目。启用“Google Search Console API”。
- 创建OAuth凭证：
- 转到“API和服务” -> “凭据”。
- 点击“+ 创建凭证” -> “OAuth客户端ID”。
- 如果提示，配置“OAuth同意屏幕”（选择“外部”用户类型，提供应用程序名称如“Claude GSC Tool”，你的电子邮件并保存）。
- 对于“应用类型”，选择 “桌面应用”。
- 给它一个名称（例如，“Claude桌面GSC工具”）。
- 点击“创建”。
- 下载
credentials.json：创建后，点击“DOWNLOAD JSON”。将其保存到项目根目录 (search-console-mcp/) 中，并确保不要提交此文件。
-
运行服务器 你可以通过以下命令运行服务器：
python -m search_console_server
注意事项
⚠️ 重要提示
- 确保你安装了正确的Python版本和依赖项。
- 在设置Google API时，严格按照步骤操作以避免权限问题。
- 不要提交
credentials.json和生成的token.json到版本控制系统中。