JinDaGe - mcp-gsc MCP Details

article

README

🚀 如何使用Claude连接Google Search Console

本项目主要解决了使用Claude连接Google Search Console以获取和分析SEO数据的问题。通过一系列的安装、配置和脚本编写步骤，能够自动化地完成数据的获取和分析，提升工作效率，优化网站在搜索引擎中的表现。

🚀 快速开始

要使用Claude连接Google Search Console，需要依次完成Node.js和npm的安装、Google Search Console API的安装与配置、Claude连接的配置，最后进行连接验证和数据分析。

📦 安装指南

安装Node.js和npm

访问 Node.js官方下载页面，根据你的操作系统选择正确的版本进行下载并安装。
安装完成后，打开终端（macOS）或命令提示符（Windows），输入以下命令检查是否安装成功：

node --version
npm --version

如果显示类似 v18.x.x 和 6.x.x 的版本号，则表示安装成功。

安装和配置Google Search Console API

创建项目并启用API

打开 Google Cloud Platform控制台，创建一个新的项目或选择已有的项目。
在项目中，导航到“库”部分，搜索并启用 Google Search Console API 和 Cloud Storage JSON API。

创建服务账号

返回到项目概览页面，点击“创建服务账号”。
填写服务账号的名称，选择角色为 Project Viewer ，然后点击“创建”。
下载生成的JSON密钥文件，并保存在安全的位置。

配置Claude连接Google Search Console

安装必要的包

打开终端或命令提示符，运行以下命令安装所需的Node.js包：

npm install google-search-console@latest @google-cloud/searchConsole@latest

创建配置文件

在项目目录下创建一个新文件 config.js ，添加以下内容（将括号内的信息替换为你的实际信息）：

const config = {
  projectId: 'YOUR_PROJECT_ID',
  keyFilename: './path/to/your/service-account-key.json'
};

module.exports = config;

编写连接脚本

创建另一个文件 search-console-connector.js ，添加以下代码：

const { GoogleSearchConsole } = require('@google-cloud/searchConsole');
const config = require('./config');

async function main() {
  const searchConsole = new GoogleSearchConsole({
    projectId: config.projectId,
    keyFilename: config.keyFilename
  });

  // 示例：获取关联的网站列表
  const sites = await searchConsole.sites.list();
  console.log('Associated websites:', sites.data);

  // 添加更多功能，如获取性能数据或验证站点
}

main().catch(console.error);

💻 使用示例

基础用法

验证连接

在终端中运行以下命令执行脚本：

node search-console-connector.js

如果一切正常，你应该会看到“关联的网站”以及其他相关信息输出。如果有错误，请检查配置文件和API权限。

高级用法

使用Claude进行数据分析

Claude 可以帮助你分析从Google Search Console获取的数据，并提供深入见解。以下是一些你可以让Claude执行的任务：

获取排名数据：使用 get_advanced_search_analytics 工具查看关键词的排名情况。
比较时间段表现：通过 compare_search_periods 分析不同时间区间内的性能变化。
检查索引状态：利用 list_sitemaps_enhanced 工具查看网站的索引状态，识别潜在问题。

数据可视化

Claude 不仅能获取数据，还能以多种方式呈现：

趋势图表：观察各项指标随时间的变化趋势。
比较图形：对比不同维度或时间段的数据表现。
分布图：分析内容在不同位置上的性能情况。例如，你可以让 Claude 生成“过去3个月的点击率变化趋势图”，以直观了解流量波动。

🔧 技术细节

本项目涉及到Node.js和npm的安装，以及Google Search Console API的配置和使用。通过Node.js的包管理工具npm安装必要的包，利用Google Search Console API获取和分析数据。在配置过程中，需要创建Google Cloud Platform项目、启用相关API、创建服务账号并下载JSON密钥文件。在Claude连接配置中，通过编写Node.js脚本实现与Google Search Console的连接和数据交互。

📚 详细文档

解决问题

遇到Python命令未找到的问题？

在 macOS 系统中，默认情况下 Python 的调用命令是 python3 ，而非 python。这可能导致某些依赖 Python 的工具无法正常运行。 解决方法：

更新符号链接：

sudo ln -mfs /usr/bin/python3 /usr/bin/python

验证是否成功：

python --version

其他常见问题

权限问题：确保你的服务账号拥有足够的 API 权限，并且 Google Search Console 中已关联了相应的网站。
网络问题：检查你的互联网连接，确保能够访问 Google 的 API 服务。
代码错误：仔细查看控制台输出的错误信息，针对具体问题进行调整和修复。

📄 结论

通过以上步骤，你可以成功配置并使用 Claude 连接 Google Search Console ，从而自动化地获取和分析 SEO 数据。这将大大提升你的工作效率，并帮助你更好地优化网站在搜索引擎中的表现。

mcp-gsc