Cookie設定

必須cookieはサイトを動かし続けます。アナリティクスはどのページが役立つかを示します。選択はフッターからいつでも変更できます。

当サイトのCookieポリシー — Cookieのカテゴリー、選択内容をブラウザーに保存する方法、同意の撤回方法を詳しく説明しています。

必須

サイトの基本機能と同意の選択。常に有効。

アクセス解析

サイトの利用状況の理解に役立ちます。許可した後にのみ読み込まれます。

GitHubZIPをダウンロード

Google Search Console連携

Search Consoleにクエリを送り、データをローカルのSQLiteファイルに保存して、URLごとにクロールの証拠データと結び付けます。アクセスは読み取り専用で、ご自身のGoogle認証情報を使います。

GitHubで見るクイックスタート

できること

  • ターミナルでのSpiderHead：seohead gsc-query

読み取り専用で接続

SpiderHeadが使うのは、Search Consoleの読み取り専用スコープだけです。アクセス権の渡し方は3通りあり、どれか1つを選びます。有効なログインがあっても特定のサイトを読めるとは限らないため、プロパティへのアクセスはprovider-verifyで別途確認します。

  • 自分のデスクトップ用OAuthクライアントを使い、scripts/gsc_oauth_login.pyでブラウザ上の同意を行う方法。リフレッシュトークンはローカルの設定フォルダに保存されます。
  • プロパティにユーザーとして追加したGoogleサービスアカウントを使う方法。
  • 設定項目GSC_ACCESS_TOKENに、取得済みのアクセストークンを指定する方法。

ローカルの履歴

gsc-archiveは期間をキューに入れ、指定したSQLiteファイルに、再開可能な小さなバッチで取得します。sources-syncはプロジェクトごとに日次の履歴を保持し、足りない日だけを取得します。ホスト型サービスには何も送らず、ファイルは所有者のみアクセス可能な権限で作成されます。

  • 日付は両端を含み、太平洋時間を使います。
  • 集計の単位（合計、ページ、クエリ）が違えば別のデータセットとして扱い、合算しません。
  • アーカイブにはクエリとURLが含まれることがあるため、公開レポートやGitには含めないでください。

URL検査

modeをinspect_urlにしたgsc-queryは、1つのURLについてGoogle自身のインデックス判定を返します。結果は、クローラーのチェックとは別系統のまま扱います。sf runの中の--gsc-inspectは、決まった方法で選んだ最大50件のURLのサンプルを検査します。ローカルのレート制限は1分あたり600件、24時間あたり2,000件です。

  • 検査できるのは、ページのインデックス済みバージョンだけです。
  • ローカルの制限に加えて、サイトごとのGoogleの制限も適用されます。
  • 検査していないURLは不明のままです。

3ステップで、スキャンを1件保存

  1. 読み取り専用の権限を1つ接続する

    所有しているプロパティに対して、読み取り専用のGoogleの権限を接続します。接続の状態はいつでも確認できます。

  2. ローカルに保存する

    期間をキューに入れ、手元のSQLiteファイルに、上限付きの小さなバッチで取得します。再実行では、足りない日だけを取得します。

  3. URLごとに結び付ける

    クリック数、表示回数、掲載順位、CTRを、URLをキーにしてクロールしたページに結び付けます。1つのURLに対するGoogle自身のインデックス判定は、別系統のまま扱います。

コマンド1つで実行

bash
seohead gsc-query --site-url sc-domain:example.com --start-date 2026-09-01 --end-date 2026-09-30

先にインストールします: インストールガイド。どのコマンドも、AIエージェント向けのMCPツールとして実行できます。

必要なもの

  • 所有している、または閲覧できるSearch Consoleのプロパティ（ドメインプロパティまたはURLプレフィックス）
  • 認証情報は次のいずれか1つ：OAuthの同意、サービスアカウント、アクセストークン（すべて読み取り専用）
  • 直近約16か月以内の期間
  • 任意：行を結び付ける対象のクロールまたはスキャン

制限事項

  • Googleが保持するデータは約16か月分です。
  • 匿名化されたクエリは含まれず、行数に上限がかかることもあります。上限に達したジョブにはその旨が記され、完全なエクスポートではありません。
  • クリック数、表示回数、CTR、掲載順位は、集計の単位をまたいで合算しません。
  • インデックスの判定は、検査したURLにしか及びません。

よくある質問

データはホスト型サービスに送られますか？
いいえ。リクエストは手元のマシンから、ご自身の権限でGoogle Search Console APIに直接送られます。結果は、所有者のみアクセス可能な権限のローカルSQLiteファイルに保存されます。クエリやURLが含まれることがあるため、それらのファイルは公開レポートやGitに含めないでください。
Search Consoleのプロパティを変更できますか？
いいえ。権限は読み取り専用です。ツールが読み取るのは、検索アナリティクスとURL検査の結果だけです。
どのくらい過去のデータまで取得できますか？
約16か月分です。これはGoogleが提供している履歴の範囲です。日付は両端を含み、太平洋時間を使います。
一部のクエリが見当たらないのはなぜですか？
Googleは匿名化されたクエリを含めず、返す行数に上限をかけることもあります。上限に達したジョブは完全なエクスポートではなく、ツールもそのように記録します。
Googleのインデックス判定は、クロールのチェックの代わりになりますか？
いいえ。1つのURLに対するGoogleの判定は、inspect_urlモードのgsc-queryから得られます。クローラー独自のチェック（メタデータ、ヘッダー、robots、リダイレクト、構造化データ、レンダリング）は、inspect-urlで実行します。2つの結果は別々のままです。
費用はかかりますか？ローカルには何が保存されますか？
APIはGoogleの割り当ての範囲内であれば無料です。SpiderHeadは、リフレッシュトークンまたはサービスアカウントのパスをローカルの設定フォルダに、アーカイブと履歴のファイルを指定した場所に保存します。履歴ファイルにトークンは書き込まれません。

他の機能も見る

ブログと用語集から

Google Search Console完全ガイド2026ブログGoogle Search Console（GSC）用語集インデックス登録用語集

同じグループの機能 · データソース

GA4・Yandex Metrikaのデータ連携機能Yandex Webmaster連携機能CrUXのCore Web Vitalsレポート機能サーバーログ分析ツール機能既知の被リンク元を確認する被リンクチェッカー機能セマンティックコア収集ツール機能

自分のサイトで試す

ZIPをダウンロードすべての機能