使用说明

项目简介

本项目 'Google Search Console MCP Server (mcp-gsc)' 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Google Search Console (GSC) 的强大 SEO 数据分析能力与 Claude AI 的自然语言处理能力相结合。通过此工具，SEO 专业人员可以使用简单的对话方式，直接在 Claude 中访问和分析 GSC 数据，极大地提升了 SEO 工作的效率和便捷性。

主要功能点

属性管理: 查看和管理您的所有 Google Search Console 属性，包括权限级别和验证状态等信息。
搜索分析: 获取网站的搜索分析数据，包括关键词查询、页面效果、点击率 (CTR)、展示次数和平均排名等关键指标。支持多维度分析，如查询、页面、设备和国家/地区，并能进行数据对比和趋势分析。
URL 检查与索引: 检查特定 URL 的索引状态，诊断索引问题，并获取页面抓取、robots.txt 和规范网址等详细信息，辅助优化网站的索引覆盖率。
站点地图管理: 列出、提交、查看和删除站点地图，监控站点地图的处理状态和错误，确保 Googlebot 能够有效地抓取和索引网站内容。
数据可视化: 利用 Claude AI 的能力，将 GSC 数据以图表和图形的形式呈现，更直观地理解 SEO 表现和趋势。

安装步骤

设置 Google Search Console API 访问权限:
- 您需要在 Google Cloud Console 中创建一个服务帐户，并下载凭据 JSON 文件。
- 然后，将此服务帐户添加到您的 Google Search Console 属性中，授予其数据访问权限。
- 您可以参考提供的 YouTube 视频教程，了解详细的 API 密钥设置步骤。
安装必要的软件:
- Python (3.11 或更高版本): 用于运行 MCP 服务器的 Python 代码。
- Node.js: 某些 MCP 组件可能需要 Node.js 环境。
- Claude Desktop: 您需要安装 Claude 桌面应用，用于与 MCP 服务器进行交互。
下载 mcp-gsc 工具:
- 从 GitHub 仓库页面点击 "Code" 按钮，选择 "Download ZIP" 下载代码压缩包。
- 解压下载的 ZIP 文件到您的计算机目录中。

安装 Python 组件:

打开终端（Mac）或命令提示符（Windows），导航到您解压后的 'mcp-gsc-main' 目录。

创建并激活 Python 虚拟环境以隔离项目依赖：

python -m venv .venv
# Mac/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate

安装项目所需的 Python 依赖包：

pip install -r requirements.txt

服务器配置

要将 'mcp-gsc' 服务器连接到 Claude Desktop，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。

打开终端或命令提示符，根据您的操作系统输入以下命令打开配置文件：

Mac:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

在打开的 JSON 文件中，添加以下 'mcpServers' 配置。请务必将以下占位符路径替换为您计算机上的实际路径:
```
{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/-main/.venv/bin/python",
      "args": ["/FULL/PATH/TO/mcp-gsc-main/gsc_server.py"],
      "env": {
        "GSC_CREDENTIALS_PATH": "/FULL/PATH/TO/service_account_credentials.json"
      }
    }
  }
}
```
- 'command': Python 解释器可执行文件的完整路径。务必指向您在虚拟环境 '.venv' 中的 Python 解释器。例如：
  - Mac: '/Users/yourname/Documents/mcp-gsc/.venv/bin/python'
  - Windows: 'C:\Users\yourname\Documents\mcp-gsc\.venv\Scripts\python.exe'
- 'args': 启动 'gsc_server.py' 脚本的参数，这里是脚本文件的完整路径。例如：
  - Mac: '"/Users/yourname/Documents/mcp-gsc/gsc_server.py"'
  - Windows: '"C:\Users\yourname\Documents\mcp-gsc\gsc_server.py"'
- 'env': 环境变量配置。
  - 'GSC_CREDENTIALS_PATH': Google 服务帐户凭据 JSON 文件的完整路径。例如：
    - Mac: '"/Users/yourname/Documents/service_account_credentials.json"'
    - Windows: '"C:\Users\yourname\Documents\service_account_credentials.json"'
保存配置文件并重启 Claude Desktop 应用。

基本使用方法

配置完成后，重启 Claude Desktop。您可以在 Claude 的工具列表中看到 'GSC tools'，表示 'mcp-gsc' 服务器已成功连接。

现在，您可以直接在 Claude 中使用自然语言提问，与您的 Google Search Console 数据进行交互。例如：

询问：'List all my GSC properties' (列出我的所有 GSC 属性)
询问：'Get search analytics for mywebsite.com for the last 30 days' (获取 mywebsite.com 过去 30 天的搜索分析数据)
询问：'Inspect URL mywebsite.com/important-page for indexing issues' (检查 URL mywebsite.com/important-page 的索引问题)

您还可以通过询问 'list tools' 让 Claude 列出所有可用的 GSC 工具及其详细描述，并根据需要组合使用不同的工具进行更深入的 SEO 数据分析。

关键词