Untapped Index Watch

Untapped Index Watch

サイトのすべてのページは Google のインデックスに登録されていますか？前回から何が変わりましたか？ご自身の Search Console を使う、無料の読み取り専用ツールです。Find Untapped Growth が開発しました。

ツール

ツール	機能
google_login / google_login_status / google_logout	Google に一度サインインします（Search Console は読み取り専用）。すべての Untapped Google プラグインで共有されます
gsc_sites	Search Console のプロパティ
index_check	各サイトマップ URL（または URL のリスト）を調べます。インデックス登録済み／未登録／不明、平易な言葉でのフラグ、各問題が通常意味することと対処方法、前回のチェックからインデックスから外れたページや新たに登録されたページを確認できます
index_history	サイトごとの過去のチェック（実行ごとの件数）、または 1 つの URL の履歴をローカルに保存します

フラグ：インデックスから削除 · 未登録（Google の理由付き）· ページ自身の noindex によるブロック · robots.txt · Google が取得できなかった · Google が別の正規 URL を選択した · 正規 URL が変更された · 45 日以上クロールされていない。 検査に失敗した場合は UNKNOWN と報告され、「未登録」とは報告されません。

インストール

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

セットアップ（一度だけ、約 5 分）

1. Google Cloud コンソール → プロジェクトを作成 → Google Search Console API を有効にします。
2. OAuth 同意画面 → 外部 → 自分をテストユーザーとして追加します。
3. 認証情報 → OAuth クライアント ID を作成 → デスクトップアプリ → JSON をダウンロードします。
4. プラグインにそのファイルを指定します。
   • Claude Code： プラグインを有効にするとき、プラグインの設定（「Google OAuth client file」）でファイルを選択します （後から設定する場合：/plugin → untapped-index-watch → configure）。
   • Codex： 変数を設定してから、Codex を再起動します。

     setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json"
     

5. エージェントに google_login を実行するよう依頼し、ブラウザーで読み取り専用アクセスを承認します。

設定／変数	デフォルト
Google OAuth client file / UNTAPPED_GOOGLE_CLIENT_SECRET	（必須）デスクトップアプリ用 OAuth クライアント JSON のパス
UNTAPPED_GOOGLE_HOME	~/.untapped-plugins/google — 保存されたサインイン情報（共有）
UNTAPPED_INDEX_HOME	~/.untapped-plugins/index-watch — チェック履歴

接続先

Google のみです。サインインには accounts.google.com と oauth2.googleapis.com、Search Console には searchconsole.googleapis.com と www.googleapis.com、さらにご自身のサイトのサイトマップに接続します。テレメトリーはありません。詳細：PRIVACY.md。

制限事項

• Google が許可する URL 検査は、プロパティごとに 1 日あたり 2,000 件（1 分あたり 600 件）です。デフォルトでは 50 件の URL をチェックします。
• インデックス登録をリクエストする API はありません。Search Console で手動クリックする必要があります。
• 検査では Google が最後に把握した状態が報告されるため、最近の変更が反映されるまで数日かかる場合があります。

開発

python -m unittest discover -s untapped-index-watch/tests   # offline, 13 tests