使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 Claude Desktop 等 MCP 客户端提供访问和分析 Google Search Console (GSC) 数据的能力。通过此 MCP 服务器，用户可以在 Claude 中直接查询网站的搜索表现数据，进行多维度分析，并生成可视化报告，从而更好地进行网站 SEO 优化。

主要功能点

列出已验证站点: 获取并列出用户 Google Search Console 账户中已验证的所有网站。
查询搜索分析数据: 根据指定的网站、日期范围、维度（如查询词、页面、设备、国家等）和搜索类型（网页、图片、视频等）查询详细的搜索分析数据。
比较时间段数据: 对比两个不同时间段的搜索指标，帮助用户快速识别网站性能的变化和趋势。
获取最佳表现内容: 找出在指定时间段内，根据点击量、展示次数、点击率或平均排名等指标表现最佳的网页内容。
获取搜索趋势: 展示网站在指定日期范围内，按天、周或月分组的搜索指标变化趋势，帮助用户了解流量波动规律。

安装步骤

生成 Google Cloud 凭据 JSON 文件:
- 访问 Google Cloud Console 并创建一个项目或选择现有项目。
- 启用 Google Search Console API。
- 创建服务账户并生成 JSON 格式的凭据文件，下载到本地。
- 将服务账户邮箱添加到 Google Search Console 网站的“用户和权限”设置中，授予至少“查看数据”权限。
安装必要的工具:
- 确保已安装 Python (3.7+), pip, uv, 和 Git (可选)。
- 按照教程检查并安装或更新这些工具。

设置 MCP 服务器:

克隆或下载仓库代码：

git clone https://github.com/seotesting-com/gsc-mcp-server.git
cd gsc-mcp-server

创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate  # Windows

安装依赖：
```
uv sync
```

安装 MCP 服务器，替换 '<path to credentials file>' 为您下载的 JSON 凭据文件路径：

mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=<path to credentials file>

重启 Claude Desktop:
- 关闭并重新启动 Claude Desktop 客户端，可能需要在任务管理器中结束 Claude 进程。

服务器配置

要将此 MCP 服务器添加到 Claude Desktop 客户端，您需要配置 'claude_desktop_config.json' 文件。通常，Claude Desktop 会自动完成配置，但如果需要手动配置或检查配置，请按照以下步骤操作：

打开 Claude Desktop，进入 File => Settings => Developer。
在 “Developer” 选项卡中，您应该能看到 “Search Console Analytics” 条目，状态应为 “running”。
点击 “Edit Config”，打开 'claude_desktop_config.json' 文件。

配置文件应包含类似以下 JSON 结构的内容：

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"
      }
    }
  }
}

配置参数说明:

'"Search Console Analytics"': 服务器名称，在 Claude Desktop 中显示。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 包管理器。
'"args"': 传递给 'uv run' 命令的参数列表。
- '"run"': 'uv' 命令的子命令，用于运行 Python 脚本。
- '"--with", "google-api-python-client"', '"--with", "google-auth"', '"--with", "mcp[cli]"', '"--with", "pandas"': 指定运行 'server.py' 前需要确保安装的 Python 依赖包。
- '"mcp", "run", "server.py"': 实际执行的命令，使用 'mcp' 命令行工具运行 'server.py' 脚本。
'"env"': 环境变量设置。
- '"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"': 重要参数，指定 Google Cloud 凭据 JSON 文件的绝对路径。请务必替换为您的实际文件路径。

注意: 请确保 '"GOOGLE_APPLICATION_CREDENTIALS"' 的路径正确，并且 Claude Desktop 进程有权限访问该文件。

基本使用方法

打开 Claude Desktop，开始新的对话。
在对话框中，您应该能看到额外的工具图标，例如 “Search Console Analytics”。
您可以直接向 Claude 提出关于 Google Search Console 数据的问题，例如：
- "列出我在 Google Search Console 中验证的所有网站"
- "显示 example.com 网站 2024年1月1日至1月31日的搜索分析数据"
- "比较 example.com 网站上个月和前一个月的搜索表现"
- "过去 30 天内，点击次数最多的 10 个页面是什么？"
- "展示过去 3 个月的每周搜索趋势"
Claude 在调用工具前会请求您的许可，请选择 “允许” 以授权 Claude 使用 MCP 服务器获取数据。

通过使用这些工具，您可以方便地在 Claude 中分析和利用 Google Search Console 数据，优化您的网站 SEO 策略。

关键词