Untapped Search Console

Untapped Search Console

ユーザーがサイトを見つけるために何を検索しているか、1ページ目に近い検索キーワードは何か、先月から何が変化したかを、自分の Search Console から確認できます。無料で、読み取り専用です。Find Untapped Growth が開発しました。

ツール

ツール	内容
google_login / google_login_status / google_logout	読み取り専用の Google サインインを 1 回行うと、すべての Untapped Google プラグインで共有されます
gsc_sites	Search Console のプロパティ
gsc_totals	指定期間におけるサイトの実際のクリック数と表示回数
gsc_performance	フィルター付きで、クエリ／ページ／国／デバイス／日付ごとの行を取得します（一度に最大 3 項目）
gsc_whats_working	earning（保護する）・close（順位 4～20 位でクリックなし。施策の効果が期待できる箇所）・top3_no_clicks（タイトル／スニペットを修正）・invisible（20 位以下）
gsc_compare	今期と前期の比較：増加、減少、新規、消失、および両期間の実際の合計

Search Console の直近約 2 日分は確定していないため、期間の終了日はデフォルトで 3 日前です。今日を終了日とする期間では、実際にはない減少が表示されます。

インストール

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

セットアップ

Untapped Index Watch と同じ Google サインインを使用します。Search Console API を有効にした Google Cloud の デスクトップアプリ OAuth クライアントが必要です（手順は Index Watch の README を参照）。 Claude Code：プラグインの設定にある「Google OAuth client file」で、そのファイルを選択します。Codex： setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json" を実行してから、再起動します。その後、エージェントに google_login を実行するよう依頼してください。Index Watch ですでにサインイン済みの場合、追加の作業は不要です。

接続先

Google のみです。サインインには accounts.google.com と oauth2.googleapis.com、Search Console のデータ取得には searchconsole.googleapis.com と www.googleapis.com に接続します。テレメトリーはありません。詳細は PRIVACY.md を参照してください。

制限事項

• Google はプライバシー保護のため、検索数の少ないクエリを非表示にします。そのため、クエリ行の合計はサイト全体の合計と一致しません。実際の合計は gsc_totals で取得できます。
• 順位は平均値をさらに平均した値であり、傾向を把握するための参考値です。
• gsc_compare は各期間の上位 1,000 行を比較するため、「消失」は「上位 1,000 位から外れた」という意味の場合があります。

開発

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