快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

python --version

详细介绍

谷歌搜索控制台MCP服务器

🚀 简介：设置MCP服务器

在本教程中，我们将引导您完成设置自己的MCP的过程模型上下文协议服务器，将其添加到Claude Desktop，并将其与谷歌搜索控制台（GSC）数据集成。这将使您能够比较时间段以确定SEO改进，生成条形图和折线图等可视化报告，并通过分析点击率、印象和排名变化来发现优化机会。

让我们开始吧！ 🚀

🔹 我们将涵盖的内容：

生成Google Cloud凭据 –创建并下载服务帐户JSON密钥以验证API访问。
安装所需工具 确保您的系统上安装了Python、pip、uv和Git（可选）。
设置MCP服务器 –克隆存储库，配置您的环境，并安装MCP服务器。
启用搜索控制台洞察 –验证MCP服务器在Claude Desktop中是否正常运行，并开始使用高级搜索分析工具。

在本指南结束时， Claude将自动连接到MCP服务器 您将能够轻松运行查询、可视化数据并优化网站的搜索性能。让我们开始吧！ 🚀

🔹 你需要知道的

本教程旨在适合初学者，您不需要任何高级技术技能。但是，您应该可以在命令行（也称为终端或命令提示符）中轻松运行命令。

在本指南中，您将输入以下命令：

python --version
git clone

如果你以前从未使用过命令行，别担心！只要一步一步地按照指示去做，你就可以走了。

这就是你所需要的——让我们开始吧！ 🚀

🎯 第1部分-生成JSON凭据文件

按照以下步骤创建和下载 服务帐户JSON密钥 从谷歌云控制台。如果你已经有一个JSON凭据文件，你可以跳过这部分。

📌 1.转到谷歌云控制台

🔗 访问谷歌云控制台

📌 2.选择您的项目

点击 项目选择器 在顶部。\

选择一个 现有项目 或创建新的.

如果要创建新项目：

启用搜索控制台API

确保您的新项目已被选中

点击 API和服务:

查找Google搜索控制台API（您可能需要在顶部搜索）

点击 “启用”

返回仪表板（单击 “谷歌云” 图标）

📌 3.打开IAM和管理部分

在左侧菜单中，转到 “IAM和管理员”>“服务帐户”.

📌 4.创建新服务帐户

点击 “创建服务帐户”.
输入a 名字（例如。， my-app-service-account).
点击 “创建并继续”.

📌 5.分配权限

选择一个角色（例如。，编辑, 所有者).
点击 “继续”.

📌 6.跳过授予用户访问权限（可选）

点击 “完成” （无需添加用户）。

📌 7.生成JSON密钥

找到你的 服务帐户 在列表中。
点击 3个点（⋮） 在右侧，然后选择 “管理密钥”.
点击 “添加密钥”>“创建新密钥”.
选择 “JSON” 格式化并单击 “创建”.
✅ JSON文件将自动下载。
复制JSON文件的路径（右键单击+“复制为路径”）

📌 8.将服务帐户添加到谷歌搜索控制台

打开谷歌搜索控制台.
选择网站属性。
点击设置（左下）。
在...之下 用户和权限，单击 添加用户.
输入服务帐户电子邮件（从步骤4开始）。
分配权限：

- 受限（仅查看数据）。 - 完整（查看和管理物业）。

点击添加.

______________________________________________________________________

🎯 第2部分-安装所需工具

在开始使用该项目之前，请确保安装了必要的工具。按照以下步骤检查是否一切就绪。

📌 1.检查是否安装了Python

通过运行以下命令检查您的系统上是否安装了Python：

在…上视窗:

python --version

在…上 Linux/macOS:

python3 --version

如果安装了Python，您将看到版本号。如果没有，请从下载并安装🔗 下载Python

📌 2.检查管道是否安装

pip是Python的包管理器。要检查是否已安装，请运行以下命令：

在…上视窗:

pip --version

在…上 Linux/macOS:

pip3 --version

如果未安装pip，请按照官方安装指南进行操作🔗 下载pip

📌 3.检查是否安装了紫外线

uv是一个Python包和项目管理器。要检查是否已安装，请运行以下命令：

在…上 Linux/macOS/Windows:

uv --version

如果未安装uv，请按照官方安装指南进行操作🔗 下载uv

📌 4.检查是否安装了Claude Desktop

如果未安装Claude Desktop，请按照官方安装指南进行操作🔗 下载克劳德桌面 .

📌 5.检查Git是否已安装（可选）

通过运行以下命令检查您的系统上是否安装了Git：

在…上 Linux/macOS/Windows:

git --version

如果安装了Git，您将看到版本号。如果没有，你仍然可以下载程序文件，或者你可以从下载并安装Git🔗 下载Git

______________________________________________________________________

🎯 第3部分-将MCP服务器添加到Claude Desktop

安装说明

1.克隆存储库

在下载文件的文件夹中打开一个新的终端。运行以下命令：

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

如果你没有安装Git：

下载ZIP文件：

2.创建和激活虚拟环境

# Windows
uv venv
.venv\Scripts\activate

# macOS/Linux
uv venv
source .venv/bin/activate

3.安装依赖项

# Windows/macOS/Linux
uv sync

4.安装MCP服务器

将路径添加到JSON凭据文件并运行以下命令：

mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=

确保更换带有JSON凭据文件的路径，例如。 C:\Users\Me\Downloads\credentials.json .

5.重新启动克劳德桌面

您可能需要在任务管理器中结束Claude任务。

______________________________________________________________________

🎯 第4部分-获取搜索控制台见解

打开克劳德桌面。如果MCP服务器配置正确，您应该能够在聊天框中看到5个其他可用工具：

您可以通过让Claude执行各种搜索控制台分析任务来使用这些工具。在调用工具之前，Claude会征求许可。您应该单击其中一个“允许”选项来使用MCP服务器：

入门提示

“在谷歌搜索控制台中列出我所有经过验证的网站”
“显示example.com在2025年1月1日至1月31日期间的搜索分析”
“比较上月和上月example.com的搜索性能”
“过去30天我点击量最高的10个页面是什么？”
“按周显示过去3个月的搜索趋势”

数据可视化提示

“生成过去一个月点击量最高的5个页面的条形图”
“创建一个折线图，显示过去90天的印象趋势”
“可视化我网站的移动和桌面流量之间的CTR比较”
“按国家绘制搜索性能热图，例如.com”
“创建按设备类型显示流量分布的饼图”
“生成一个散点图，比较我前50个查询的点击率与位置”
按搜索类型（网络、图像、视频）显示流量源的视觉细分
“创建一个堆叠面积图，显示随时间推移的点击和印象”
“使用比较图表可视化每周搜索性能的变化”
“用多个图表生成我网站SEO性能的可视化报告”

搜索控制台分析提示

“确定我可以优化的印象高但点击率低的关键字”
“显示上个月排名下降的页面”
“查找我的网站在过去30天内开始排名的新关键字”
“分析与桌面相比，哪些移动页面的性能差距最大”
“显示我在第2页（位置11-20）上排名的查询，我可以推送到第1页”
“确定过去一年我的搜索流量的季节性趋势”
“比较3月1日网站重新设计前后的自然流量”
“根据印象与点击量，告诉我哪些国家具有最高的增长潜力”
“分析我前100个查询的平均位置和点击率之间的相关性”
“根据潜在的流量收益生成优化机会的优先级列表”

可用工具

list_网站

列出您的Google Search Console帐户中所有经过验证的网站。

查询搜索分析

Parameters:
- site_url: Full URL of your website (e.g., https://www.example.com/)
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- dimensions: List of dimensions (query, page, device, country, date)
- search_type: Type of search results (web, image, video, news, discover, googleNews)
- row_limit: Number of rows to return (max 25000)

比较时间周期

Parameters:
- site_url: Full URL of your website
- current_start_date: Start date for current period in YYYY-MM-DD format
- current_end_date: End date for current period in YYYY-MM-DD format
- previous_start_date: Start date for previous period in YYYY-MM-DD format
- previous_end_date: End date for previous period in YYYY-MM-DD format
- dimensions: List of dimensions (query, page, device, country, date)
- search_type: Type of search results
- row_limit: Number of rows to return

get_top_performing_content

Parameters:
- site_url: Full URL of your website
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- metric: Metric to sort by (clicks, impressions, ctr, position)
- limit: Number of results to return

get_search_trends

Parameters:
- site_url: Full URL of your website
- start_date: Start date in YYYY-MM-DD format
- end_date: End date in YYYY-MM-DD format
- interval: Time interval for grouping (day, week, month)

🛠 故障排除

如果在设置或使用MCP服务器时遇到任何问题，请尝试以下解决方案：

1.️⃣ 重新启动克劳德桌面

有时，工具不会立即出现。重新启动Claude Desktop并重试。在重新启动之前，您可能需要在任务管理器（Windows）或活动监视器（Mac）中结束Claude进程。

2.️⃣ 等几分钟

设置MCP服务器后，加载新工具可能需要几分钟的时间。如果它们没有立即出现，请等待几分钟，然后重试。

3.️⃣ 检查JSON凭据文件

确保服务帐户JSON文件位于可访问的文件夹中。避免将其放置在受限或仅限管理员的文件夹中（例如，Windows上的C:\\Program Files\\或macOS上的~/Library/）。如有必要，将其移动到更容易访问的位置，如“文档”或“桌面”文件夹。

：4:检查Claude配置

首选 文件=>设置 然后单击 开发者 选项卡。当您单击时 搜索控制台分析，它应该显示“正在运行”的状态。如果没有，可能会出现一条错误消息，提供导致连接问题的详细信息。如果您无法看到下图所示的设置，请确保您拥有最新版本的Claude Desktop：🔗 下载克劳德桌面.

点击 编辑配置 并打开 'claude_desktop_config.json' 在文本编辑器中。它应该包含：

{
  "mcpServers": {
    "Search Console Analytics": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth",
        "--with",
        "mcp[cli]",
        "--with",
        "pandas",
        "mcp",
        "run",
        "C:\\Documents\\gsc-mcp-server\\server.py"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:\\Users\\Path\\To\\Credentials\\gscaccess-credentials.json"
      }
    }
  }
}

如果它包含其他内容，请将此数据粘贴到文件中，并确保更新server.py文件和凭据文件的文件路径。确保转义反斜杠字符（如图所示）。重启克劳德。

Mac用户：修复“spawn uv ENOENT”错误

如果你看到错误 “Spawn UV ENOENT” 打开Claude Desktop时，这意味着uv未安装或在系统路径中找不到。如果安装了uv，您可以尝试将完整路径添加到claude配置中。

1.️⃣ 更新Claude桌面配置

打开 克劳德桌面 并前往 文件>设置>开发人员. 点击 “搜索控制台分析”，然后选择 编辑配置. 找到 "command": "uv" 报关进口 claude_desktop_config json. 将“uv”替换为uv的完整路径，通常为： /Users/YOURUSERPROFILENAME/.local/bin/uv

运行以下命令获取uv的安装路径：

which -a uv

此命令将显示您拥有的uv安装的所有路径。如果你能看到的唯一路径是 /Library/Frameworks/Python.framework/Versions/3.**/bin/uv ，你需要🔗 下载uv 回到第3部分。

保存文件并重新启动Claude Desktop。

2.️⃣ 尝试另一种紫外线安装方法

如果上述方法不起作用，则uv可能安装不正确。尝试使用Homebrew安装它：

brew install uv

如果你仍然有问题，请回溯你的步骤，确保一切设置正确。 🚀

目录标签

数据可视化PythonClaudeSEO分析本地部署搜索控制台网站优化搜索引擎

支持客户端

Claude DesktopClaude

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

5

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/1536f0da4e9548a51f2a11aa7449b190

Google Search Console MCP Server是一个用于集成Google搜索控制台数据、进行SEO分析和可视化的服务器工具，适用于网站管理员和SEO优化师。

AIBase MCP

mcp.aibase.com

/zh/server/1916355371886157825

全面解析Gsc MCP ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Gsc MCP Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

继续浏览同类 MCP

更多搜索检索 MCP（7,303）返回 MCP 目录

上一个 MCP

gsc MCP

提供Google搜索控制台和索引API的全面覆盖服务，支持站点管理、站点地图提交、搜索分析查询和URL检查等功能。

下一个 MCP

Gsc MCP Server 31816c60

一个将Google Search Console与Claude AI Desktop连接的工具，通过自然语言对话分析SEO数据，提供资产管理、搜索分析、网址检查和网站地图管理功能。

Gsc MCP Server

快速接入

详细介绍

谷歌搜索控制台MCP服务器

🚀 简介：设置MCP服务器

🔹 我们将涵盖的内容：

🔹 你需要知道的

这就是你所需要的——让我们开始吧！ 🚀

🎯 第1部分-生成JSON凭据文件

📌 1.转到谷歌云控制台

📌 2.选择您的项目

如果要创建新项目：

启用搜索控制台API

📌 3.打开IAM和管理部分

📌 4.创建新服务帐户

📌 5.分配权限

📌 6.跳过授予用户访问权限（可选）

📌 7.生成JSON密钥

📌 8.将服务帐户添加到谷歌搜索控制台

🎯 第2部分-安装所需工具

📌 1.检查是否安装了Python

在…上 视窗:

在…上 Linux/macOS:

📌 2.检查管道是否安装

在…上 视窗:

在…上 Linux/macOS:

📌 3.检查是否安装了紫外线

在…上 Linux/macOS/Windows:

📌 4.检查是否安装了Claude Desktop

📌 5.检查Git是否已安装（可选）

在…上 Linux/macOS/Windows:

🎯 第3部分-将MCP服务器添加到Claude Desktop

安装说明

1.克隆存储库

如果你没有安装Git：

2.创建和激活虚拟环境

3.安装依赖项

4.安装MCP服务器

5.重新启动克劳德桌面

🎯 第4部分-获取搜索控制台见解

入门提示

数据可视化提示

搜索控制台分析提示

可用工具

list_网站

查询搜索分析

比较时间周期

get_top_performing_content

get_search_trends

🛠 故障排除

1.️⃣ 重新启动克劳德桌面

2.️⃣ 等几分钟

3.️⃣ 检查JSON凭据文件

：4:检查Claude配置

Mac用户：修复“spawn uv ENOENT”错误

1.️⃣ 更新Claude桌面配置

2.️⃣ 尝试另一种紫外线安装方法

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

在…上视窗:

在…上视窗: