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 分