金大哥 - google-search-console-mcp MCP 详情

article

README

🚀 谷歌搜索控制台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 <your-repository-url>
cd search-console-mcp

⚠️ 重要提示

将 <your-repository-url> 替换为实际的仓库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 到版本控制系统中。

google-search-console-mcp