Untapped Search Console

io.github.CTF-Max由 GitHub 账号 CTF-Max 发布v0.2.0更新于 Oct 30, 2026

What people search to find you, and what's close

已验证STDIO仅桌面网页搜索与抓取数据与分析

概览

AI 生成的概览

只读的 Google Search Console 插件，让助手查看哪些搜索词和页面带来点击、哪些接近首页，以及相比上个月的变化。

可以做什么
  • 以只读方式登录 Google，并查看或清除共享的 Untapped 登录状态
  • 列出账号可访问的 Search Console 资源
  • 给出指定时间窗口内真实的点击与展示次数
  • 按查询词、页面、国家、设备或日期拆分表现，并支持筛选
  • 把查询词归类为正在获益、接近首页、排名前三但无点击、以及不可见
  • 对比当前窗口与上一窗口，找出上升、下降、新增和流失的查询词
适用场景
适合 SEO 与内容运营场景：希望助手直接读取你自己的 Search Console 数据，指出可快速见效的机会、标题或摘要需要修改的页面，以及月度变化，而无需手工导出报表。
运行要求
以 Claude Code 或 Codex 插件形式在本机运行，需要 PATH 中有 Python 3.10 及以上版本（命令名为 python，仅用标准库）。需要一个已启用 Search Console API 的 Google Cloud 桌面应用 OAuth 客户端，以客户端密钥文件形式提供（Codex 通过 UNTAPPED_GOOGLE_CLIENT_SECRET 变量指定），然后调用 google_login。需要访问 Google 登录与 Search Console 接口的网络。
安装前请注意
需要提供 Google OAuth 客户端密钥文件，并授权对你的 Google 账号进行只读的 Search Console 访问；该登录会与其他 Untapped Google 插件共用。数据仅发往 Google 接口，无遥测。由于 Google 会隐藏稀有查询，查询词数据不完整，排名位置仅为方向性平均值。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Untapped Search Console，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Untapped Search Console

What people search to find your site, which searches are close to page one, and what moved since last month, read from your own Search Console. Free and read-only. Built by Find Untapped Growth.

Tools

ToolAnswers
google_login / google_login_status / google_logoutOne read-only Google sign-in, shared with every Untapped Google plugin
gsc_sitesYour Search Console properties
gsc_totalsThe site's true clicks and impressions for a window
gsc_performanceRows by query / page / country / device / date (up to 3 at once), with filters
gsc_whats_workingearning (protect) · close, position 4–20 with no clicks (where work pays) · top3_no_clicks (fix the title/snippet) · invisible (past 20)
gsc_compareThis window vs the previous one: gainers, losers, new, lost, and both windows' true totals

Windows end 3 days back by default, because Search Console's last ~2 days aren't final and a window ending today shows a fake dip.

Install

  • Claude Code: /plugin install untapped-search-console --marketplace CTF-Max/untapped-plugins (or, from a terminal: claude plugin marketplace add CTF-Max/untapped-plugins, then claude plugin install untapped-search-console@untapped-plugins).
  • Codex: codex plugin marketplace add CTF-Max/untapped-plugins, then codex plugin add untapped-search-console@untapped-plugins.
  • Needs Python 3.10+ on PATH as python. Standard library only: nothing to pip install.

Setup

Same Google sign-in as Untapped Index Watch: a Google Cloud Desktop app OAuth client with the Search Console API enabled (steps in Index Watch's README). Claude Code: choose that file in the plugin's settings ("Google OAuth client file"). Codex: setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json" and restart. Then ask your agent to run google_login. Signed in already through Index Watch? Nothing more to do.

What it connects to

Only Google: accounts.google.com and oauth2.googleapis.com to sign in, searchconsole.googleapis.com and www.googleapis.com for your Search Console data. No telemetry. Details: PRIVACY.md.

Limits

  • Google hides rare queries for privacy, so query rows never add up to the site total; gsc_totals gives the real one.
  • Position is an average of averages: directional only.
  • gsc_compare compares each window's top 1,000 rows, so "lost" can mean "fell below the top 1,000".

Development

python -m unittest discover -s untapped-search-console/tests   # offline, 7 tests

来源：untapped-search-console/README.md，提交 c5eb3c7

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：该软件包类型无法在沙箱中运行。

版本历史

1
  1. v0.2.0最新Oct 22, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分