Untapped SERP

io.github.CTF-Max由 GitHub 帳號 CTF-Max 發布v0.2.0更新於 Oct 30, 2026

Real Google results and search volume

已驗證STDIO僅桌面網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

透過使用者自己的 DataForSEO 帳戶，為 AI 助理提供真實的 Google 搜尋結果與 Google Ads 搜尋量，並設有每日花費上限。

可以做什麼
  • 依關鍵字、地區與裝置取得即時 Google 自然搜尋結果，包含相關提問、本地商家區塊、精選摘要與 AI 概覽引用
  • 批次查詢關鍵字的月搜尋量、CPC、競爭度與 12 個月趨勢
  • 預估單次呼叫費用，並判斷當日上限是否允許執行
  • 查看今日與本月花費、上限、最近呼叫紀錄以及憑證是否已設定
適用情境
適合需要真實 Google 排名或搜尋需求而非內建索引的情境：SEO 與內容研究、關鍵字搜尋量核對、競品網域曝光分析或本地搜尋研究。
執行需求
以外掛形式在桌面端本機執行於 Claude Code 或 Codex；需要 PATH 中有 Python 3.10+（僅標準函式庫）。需要 DataForSEO 帳戶的 API 登入名稱與密碼，可透過外掛的安全憑證儲存或 DATAFORSEO_LOGIN、DATAFORSEO_PASSWORD 環境變數提供。需能連線至 DataForSEO 的 API 端點。
安裝前請注意
呼叫會在使用者的 DataForSEO 帳戶產生實際費用（例如依 SERP 深度與搜尋量呼叫計費）；每日上限預設為 1.00 美元，超出即停止付費呼叫。憑證只送往 DataForSEO 端點，但屬於帳戶機密，應存放於安全憑證儲存而非明文檔案。結果不明的呼叫不會自動重試，但仍計入當日上限。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Untapped SERP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Untapped SERP

Real Google results and search volume for your AI agent (Codex or Claude Code), through your own DataForSEO account, with a daily spend cap. Built by Find Untapped Growth.

Built-in web search gives an agent a handful of results from its own index. This plugin gives it what Google actually shows for a phrase in a place: positions, People Also Ask, the local pack, which sites an AI Overview cites, the featured snippet, and every spot a given domain holds. It also gives Google Ads monthly search volume.

Tools

ToolWhat it doesCost to you (DataForSEO list price, read 2026-10-09)
google_serpLive Google organic results for one keyword + location + device$0.002 per 10 results (depth 10 = $0.002); search operators like site: cost 5×
google_search_volumeMonthly volume, CPC, competition, 12-month trend for 1–100 keywords (1000 with allow_large_batch)$0.09 per call, any number of keywords
serp_estimateCost reserve for a call and whether today's cap allows itfree
serp_spendSpend today / this month, the cap, the last 10 calls, whether credentials are setfree

Prices: SERP · depth billing · Google Ads volume. The plugin records the cost each response reports, so your ledger reflects what DataForSEO charged, not our estimate.

Install

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

Setup

  1. Create a DataForSEO account and copy your API login and password (dashboard → API Access).
  2. Give them to the plugin:
    • Claude Code asks for them in the plugin's settings when you enable it (later: /plugin → untapped-serp → configure). They are kept in your computer's secure credential store, not in a settings file.
    • Codex: set them as environment variables, then restart Codex:
      powershell
      setx DATAFORSEO_LOGIN "[email protected]"setx DATAFORSEO_PASSWORD "your-api-password"
      (macOS/Linux: export them in your shell profile.)

Settings

Setting (Claude Code) / variableDefaultMeaning
Daily spend cap / UNTAPPED_SERP_DAILY_CAP_USD1.00Paid calls stop once charged + in-flight spend for the UTC day would pass this
UNTAPPED_SERP_SANDBOXoff1 = use DataForSEO's free sandbox (dummy data, labelled sandbox: true)
UNTAPPED_SERP_HOME~/.untapped-plugins/serp (Windows: C:\Users\<you>\.untapped-plugins\serp)Where the cache + spend ledger live

Money safety

  • Same request again within its cache window (SERP 24 h, volume 30 days) = no new charge. max_age_hours: 0 forces fresh.
  • A call whose outcome is unknown (timeout, dropped connection) is never retried automatically; its reserve stays counted against today's cap.
  • Only two HTTPS endpoints on api.dataforseo.com (or sandbox.dataforseo.com) are ever called; proxies and redirects are refused so your credentials can't be sent anywhere else.
  • dry_run: true or serp_estimate shows the cost without calling.

Limits worth knowing

  • One SERP = one location, one device, one moment. Rankings move by street and by hour.
  • Google Ads volumes are rounded buckets and are often null (no data) for small local phrases; null is never zero.
  • target: "not in top N" means not found in the results fetched, not "not indexed".

Development

python -m unittest discover -s untapped-serp/tests   # offline, 21 testspython tools/sync_shared.py --check                  # shared MCP lib copies are currentpython tools/serp_smoke.py                           # free sandbox round trip

來源：untapped-serp/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 分