Untapped SERP

未開拓のSERP

AI エージェント（Codex または Claude Code）向けに、ご自身の DataForSEO アカウントを使って、Google の実際の検索結果と検索ボリュームを取得します。1日の支出上限を設定できます。Find Untapped Growth が開発しました。

組み込みのウェブ検索では、エージェントが独自のインデックスから少数の結果を取得します。このプラグインでは、特定の場所である語句を検索した際に Google が実際に表示する内容を確認できます。掲載順位、「他の人はこちらも質問」、ローカルパック、AI Overview が引用するサイト、強調スニペット、特定のドメインが掲載されるすべての位置を取得します。また、Google Ads の月間検索ボリュームも取得できます。

ツール

ツール	機能	ご利用料金（DataForSEO の定価、2026-10-09 閲覧）
google_serp	キーワード、場所、デバイスを指定して Google のオーガニック検索結果をリアルタイムで取得	10件あたり $0.002（depth 10 = $0.002）。site: などの検索演算子は5倍の料金
google_search_volume	1～100件のキーワード（allow_large_batch を指定した場合は1000件）の月間検索ボリューム、CPC、競合度、過去12か月の推移	キーワード数にかかわらず、1回あたり $0.09
serp_estimate	呼び出しの費用見積もりと、今日の上限内で実行できるかどうかを確認	無料
serp_spend	今日／今月の支出額、上限、直近10回の呼び出し、認証情報の設定状況を確認	無料

料金：SERP · depth の課金 · Google Ads の検索ボリューム。プラグインは各応答で報告された費用を記録するため、台帳には当社の見積もりではなく、DataForSEO の請求額が反映されます。

インストール

• Claude Code： /plugin install untapped-serp --marketplace CTF-Max/untapped-plugins （または、ターミナルで claude plugin marketplace add CTF-Max/untapped-plugins を実行してから、 claude plugin install untapped-serp@untapped-plugins を実行します）。
• Codex： codex plugin marketplace add CTF-Max/untapped-plugins を実行してから、codex plugin add untapped-serp@untapped-plugins を実行します。
• PATH 上に python として Python 3.10 以降が必要です。標準ライブラリのみを使用するため、pip install は不要です。

セットアップ

1. DataForSEO アカウントを作成し、API ログイン名とパスワードをコピーします（ダッシュボード → API Access）。
2. プラグインに認証情報を設定します。
   • Claude Code： プラグインを有効にすると、設定画面で入力を求められます（後から設定する場合：/plugin → untapped-serp → configure）。設定ファイルではなく、お使いのコンピューターの安全な認証情報ストアに保存されます。
   • Codex： 環境変数として設定してから、Codex を再起動します。

     setx DATAFORSEO_LOGIN "[email protected]"
     setx DATAFORSEO_PASSWORD "your-api-password"
     

     （macOS/Linux の場合は、シェルのプロファイルで export を使って設定します。）

設定

設定（Claude Code）／変数	デフォルト	意味
1日の支出上限 / UNTAPPED_SERP_DAILY_CAP_USD	1.00	UTC の当日分について、請求済み額と処理中の支出額の合計がこの上限を超える場合、有料の呼び出しを停止します
UNTAPPED_SERP_SANDBOX	オフ	1 = DataForSEO の無料サンドボックスを使用します（ダミーデータ。sandbox: true と表示されます）
UNTAPPED_SERP_HOME	~/.untapped-plugins/serp（Windows：C:\Users\<you>\.untapped-plugins\serp）	キャッシュと支出台帳の保存場所

支出の安全対策

• キャッシュの有効期間内（SERP は24時間、検索ボリュームは30日）に同じリクエストを再実行しても、新たな料金は発生しません。max_age_hours: 0 を指定すると、最新のデータを取得します。
• タイムアウトや接続切断などで結果が不明な呼び出しは、自動的に再試行されません。その予約額は当日の上限に引き続き算入されます。
• 呼び出し先は api.dataforseo.com（または sandbox.dataforseo.com）上の2つの HTTPS エンドポイントに限られます。認証情報が他の場所に送信されないよう、プロキシとリダイレクトは拒否されます。
• dry_run: true または serp_estimate を使うと、呼び出しを行わずに費用を確認できます。

知っておきたい制限事項

• 1回の SERP 取得で指定できるのは、場所1か所、デバイス1台、取得時点1つです。掲載順位は通りごと、時間ごとに変動します。
• Google Ads の検索ボリュームは丸められた範囲で表示されます。また、ローカル検索の少量の語句では null（データなし）になることがよくあります。null はゼロを意味しません。
• target: "not in top N" は、取得した検索結果に見つからなかったという意味であり、「インデックスされていない」という意味ではありません。

開発

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