AI导哈

Google搜索控制台分析服务器

一款专业的Google搜索控制台数据分析工具，提供性能分析、机会发现和SEO建议。

  • by Magdoub
  • TypeScript
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 Magdoub/awesome-gsc-mcp

使用说明

很棒的gsc mcp

最强大的谷歌搜索控制台MCP服务器——像SEO专业人员一样分析数据，提供基准、建议和可操作的见解。

演示

只需让它分析你的谷歌搜索控制台。


Ask Claude to analyze your Search Console data


Here's a sample result

特性

  • 27工具 涵盖Google Search Console各个方面的7个类别
  • 智能分析引擎 具有CTR基准、趋势检测、查询意图分类、机会评分和推荐引擎
  • 内存缓存 用于快速重复查询
  • 速率限制 （20个请求/秒，突发30个）保持在API配额内
  • 双重运输 --stdio（默认）和HTTP用于灵活集成
  • 自动检测身份验证 --服务帐户、OAuth或自动检测 credentials.json

安装和设置

1.获取谷歌凭据

  1. 首选 谷歌云控制台
  2. 创建 一个新项目 （或选择一个现有的）
3. Enable the Search Console API

启用 搜索控制台API

4. Create credentials
  • 首选 您创建的项目
  • 点击侧栏中的凭据
  • 创建服务帐户，随便命名，单击继续
  • 打开服务帐户
  • 点击 钥匙 标签
  • 点击 添加密钥>创建新密钥 并选择JSON。将其保存在熟悉的地方，并尝试将其重命名为可搜索的内容（例如。 awesome-gsc-service-account.json)
5. Grant access

2.配置您的客户端

你快做完了。现在，我们将参考您在步骤4（创建凭据）中下载的JSON文件。

克劳德代码

claude mcp add awesome-gsc -- npx -y awesome-gsc-mcp \
  -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

提示： 找不到您的密钥文件？运行此命令以定位它：

claude -p "find the path of most recently downloaded .json file in ~/Desktop, ~/Documents, and ~/Downloads"
Claude Desktop

将整个块粘贴到终端中，按Enter键，然后重新启动Claude Desktop。

cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "awesome-gsc": {
      "command": "npx",
      "args": ["-y", "awesome-gsc-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "{Path to your json file}"
      }
    }
  }
}
EOF

以下是一个示例：

"GOOGLE_APPLICATION_CREDENTIALS": "/Users/Magdoub/Desktop/mobilevitals-service.json"
Cursor

配置文件： .cursor/mcp.json 在项目根目录中（或 ~/.cursor/mcp.json 全球）

{
  "mcpServers": {
    "awesome-gsc": {
      "command": "npx",
      "args": ["-y", "awesome-gsc-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}
Windsurf

配置文件： ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "awesome-gsc": {
      "command": "npx",
      "args": ["-y", "awesome-gsc-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json"
      }
    }
  }
}
Troubleshooting
错误 修复
401 Token has been expired or revoked 删除 ~/.awesome-gsc-mcp/token.json 并重新授权
403 User does not have sufficient permission 将服务帐户电子邮件添加为 所有者 在搜索控制台> 设置>用户和权限
403 Forbidden 使用OAuth 在Google Cloud Console>OAuth同意屏幕中将自己添加为测试用户，或发布应用程序
Could not load the default credentials 检查一下 GOOGLE_APPLICATION_CREDENTIALS 指向有效的密钥文件

工具参考

All 27 tools organized by category

物业管理（4个工具）

工具 说明
list_properties 列出经过身份验证的帐户可访问的所有Search Console属性
get_property_details 获取特定房产的详细信息
add_property 将新站点添加到搜索控制台
delete_property 从Search Console中删除网站

性能和流量（6个工具）

工具 说明
get_search_analytics 使用灵活的参数（维度、过滤器、日期范围）查询原始搜索分析数据
get_performance_summary 高级性能概述，具有自动逐期比较功能
compare_periods 并排比较两个自定义日期段之间的搜索性能
get_top_queries 点击率基准分析的热门搜索查询
get_top_pages 点击率分析和建议的首页
get_traffic_by_device 按设备类型（台式机、移动设备、平板电脑）划分的流量细分，具有移动优先的见解

智能机会分析（5个工具）

工具 说明
find_quick_wins 寻找“桌面上的金钱”SEO机会：点击率差距、几乎1岁的查询、快速获得位置
find_declining_content 通过根本原因诊断查找丢失流量的页面和查询
find_ctr_opportunities 点击率明显低于基准的页面，并附有针对具体职位的建议
find_content_gaps 内容创建机会：主页排名查询、零点击查询、新兴查询
find_what_to_build_next 基于意图的内容规划：按主题集群分组的问题、比较、问题、购买信号

URL检查和索引（3个工具）

工具 说明
inspect_url 检查URL的索引状态、爬网信息、移动可用性和丰富结果
batch_inspect_urls 在一次调用中检查多个URL
check_indexing_issues 识别您网站上常见的索引问题

网站地图管理（4个工具）

工具 说明
list_sitemaps 列出为物业提交的所有站点地图
get_sitemap_details 获取特定站点地图的详细信息
submit_sitemap 向Search Console提交新的站点地图
delete_sitemap 从Search Console中删除站点地图

查询智能（3个工具）

工具 说明
analyze_query_landscape 意向分布、品牌与非品牌拆分、仓位桶分析
find_new_queries 发现时段之间出现的真正新的查询
find_cannibalization 查找竞争同一查询的多个页面

综合报告（2个工具）

工具 说明
weekly_seo_report 完整的每周SEO绩效报告，包括趋势、热门因素和建议
seo_health_check 全面的健康检查，包括字母等级和优先行动项目

用例和示例提示

一旦连接到克劳德，尝试这些自然语言提示。按原样复制其中任何一个。

入门指南

List all my Search Console properties

How is example.com doing this month?

Give me a performance summary for the last 3 months

流量与性能分析

What are my top 20 queries by clicks?

Show me traffic breakdown by device

Compare this month's performance vs last month

What are my top pages for mobile traffic?

Show me search performance for image search

寻找速赢和机会

Find quick win SEO opportunities for my site

Which pages have CTR below benchmarks?

Find pages that are almost on page 1 of Google

What queries could I get more clicks from with better titles?

内容战略与规划

What content should I create next?

What questions are people searching that I should answer?

Find content gaps — queries ranking on my homepage that need dedicated pages

Show me new and emerging queries in the last month

What comparison and "best of" queries is my site appearing for?

诊断问题

Which pages are losing traffic and why?

Find keyword cannibalization issues

Are there any indexing issues on my top pages?

Inspect the URL example.com/blog/my-post for indexing problems

Which of my pages are not indexed?

网站地图和索引

List all my submitted sitemaps

Submit my new sitemap at example.com/sitemap.xml

Check indexing status for my top 50 pages

Batch inspect these URLs: [url1, url2, url3]

报告和健康检查

Generate a weekly SEO report

Run a full SEO health check and give me a grade

What are the top 5 things I should fix on my site right now?

分析引擎

Built-in SEO analysis beyond raw data

服务器通过内置的分析引擎超越了原始数据：

  • CTR基准 --按职位将您的点击率与行业平均基准进行比较。标记表现不佳的页面，并估计您可以获得多少额外点击。
  • 趋势检测 --分析时间序列数据，以检测查询和页面中的上升、下降或稳定趋势。
  • 查询分类 --按用户意图（信息、调查、事务、导航、解决问题）和子类型（操作、比较、审查、错误/修复等）对查询进行分类。
  • 机会评分 --根据流量影响潜力、印象、点击率差距、位置接近度和交易量对每个机会进行评分。
  • 推荐引擎 --根据您的房产中发现的数据模式生成具体的、有优先级的建议。

API限制

What's not available through the API

Google搜索控制台API具有已知的局限性。以下数据为 不可用 通过API，因此不由该服务器提供：

  • 核心网页指标 --页面体验和性能指标
  • 爬行统计信息 --爬网请求、响应时间、主机状态
  • 手动操作 --处罚和安全问题
  • 链接报告 --内部和外部链接数据
  • 去除 --URL删除请求
  • 丰富的结果 --详细的丰富结果报告（基本信息可通过URL检查获得）

这些报告仅在Search Console web界面中可用。

HTTP传输

Using HTTP instead of stdio

对于更喜欢HTTP而不是stdio的环境，请使用以下命令启动服务器 --http 标志：

npx awesome-gsc-mcp --http

默认情况下，服务器在端口3000上侦听。用覆盖 PORT 环境变量：

PORT=8080 npx awesome-gsc-mcp --http

终点：

路径 方法 描述
/mcp POST MCP协议端点（可流式HTTP传输）
/health GET 健康检查--返回 {"status":"ok","auth":"..."}

常见问题解答

Common questions

GSC数据多久更新一次？ Search Console数据通常会延迟2-3天。对于已确定的最终数字，通过 dataState: 'final' 在您的搜索分析查询中。随着谷歌处理数据，最近2-3天的数据可能仍会发生变化。

利率限制是什么？ 服务器内置了每秒20个请求的速率限制，突发允许为30。谷歌搜索控制台API也有自己的每日配额-检查您的 谷歌云控制台配额页面 如果你达到了极限。

我可以使用多个网站吗？ 对。使用 list_properties 要查看所有可访问的站点，请指定 siteUrl 任何工具中的参数都可以针对特定属性。

域属性是如何工作的？ 域属性使用 sc-domain:example.com 格式。这涵盖了所有子域和协议。URL前缀属性使用完整的URL，如 https://www.example.com/.

哪些数据不能通过API获得？ 请参阅 API限制 部分。核心Web重要信息、爬网统计信息、链接、手动操作和删除仅在Search Console Web界面中可用。

发展

Build, test, and run locally 
# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Development mode (watch + rebuild)
npm run dev

# Type check
npm run lint

# Start locally (stdio)
npm start

# Start locally (HTTP)
npm start -- --http

许可证

麻省理工学院

相关 MCP