Google Search Console のロゴ

SEOと検索

接続する Googleサーチコンソール Excel、Google Sheets、AI、RESTへ

クエリ、ページ、国、デバイスをテーブルとして扱います。Query Streamsの他の機能がSEO対策のために内部的に使用しているものと同じコネクタです。

無料で始めよう 13の目的地

一つの接続、あらゆる表面

Search Console のデータが保存される場所

Googleサーチコンソール ライブAPIデータ SQLテーブルとして
フェデレーションクエリ + その他のコネクタ 1つのSQL 複数のソースから · すべてのプラン
ネットワーク・エージェント
  • 1 発信接続
  • 0 受信ポート
  • 読み取り専用 · 認証情報はそのまま保持されます

走る

Query Streamsは、Search ConsoleのプロパティをSQLに変換します。クエリ、ページ、国、デバイスの組み合わせごとに1つのテーブルの行としてデータが格納され、さらにサイト、サイトマップ、検査結果も含まれ、Microsoft Excel、Google Sheets、Power BI、MCP経由のAIアシスタント、RESTエンドポイントから読み取り可能です。初回同期時にGoogleが保持する16か月分のデータをすべて取得します。これは、Search Consoleのインターフェースでは一度に取得できない部分です。

  1. チーム、ベンダー、パートナーの皆様へ

  2. Search Console から Excel Microsoft Excel · Excelアドイン

    Search Consoleのリアルタイム検索結果をワークシートに直接取り込み、必要に応じて更新できます（デスクトップ版Excel、Excel Online、Microsoft 365に対応）。

    検索コンソールガイド

  3. Search Console から Google スプレッドシートへ Sheetsアドオン

    サイドバーから保存済みの検索コンソールクエリを実行し、結果をシートにドラッグ＆ドロップします。共有されている共同作業者は、各自でシートを更新できます。

    検索コンソールガイド

  4. Search ConsoleについてNovaに聞いてみてください Nova AI · テキストからSQLへ

    分かりやすい英語で質問してください。Novaは既にSearch Consoleのテーブルを把握しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を渡す必要もありません。

    Novaの仕組み

  5. Search Console から Data Viewer へ 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ

    同僚、ベンダー、パートナーなど、誰とでも、Search Consoleのリアルタイム検索結果をブックマーク可能なグリッド形式で共有できます。このグリッドは、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態で表示されます。共有相手には検索結果のみが表示され、SQLや認証情報は一切表示されません。

    データビューアの仕組み
  6. アプリとシステム向け

  7. 検索コンソールREST API HTTPエンドポイント

    Search Consoleクエリを、認証済みのJSONエンドポイントとして公開します。このエンドポイントは、OpenAPI 3.1仕様に準拠しており、Postman、Insomnia、Hoppscotch用の既製コレクションも用意されているため、どのアプリケーションでも呼び出すことができます。データベースポートは開かれません。

    REST APIの仕組み

  8. Search Console から Power BI へ Power Query M

    生成された Power Query M を Power BI アドバンスト エディターに貼り付けると、レポートは HTTPS 経由で Search Console のリアルタイムの結果を読み取ります。ODBC ドライバーもデータベース ポートも必要ありません。

    Power BI の仕組み

  9. Search Console から Airtable へ 自動化プラットフォーム

    Search Consoleの行をスケジュールに基づいてAirtableベースに同期したり、Airtable自動化スクリプト内で取得したりできます。

    検索コンソールガイド

  10. コンソールからBaserowへ 自動化プラットフォーム

    Search ConsoleからRESTエンドポイント経由でBaserowテーブルにデータを送信します（セルフホスト型またはBaserowクラウド）。

    検索コンソールガイド

  11. コンソールからSeaTableへ検索 自動化プラットフォーム

    ファイルをエクスポートしたりデータベースを公開したりすることなく、SeaTableのデータベースをSearch Consoleのデータで常に最新の状態に保つ。

    検索コンソールガイド

  12. Search Console から Smartsheet へ 自動化プラットフォーム

    Search Consoleの検索結果をSmartsheetのグリッドにプッシュすることで、計画やレポートが先週のエクスポートデータではなく、ソースシステムから読み込まれるようにします。

    検索コンソールガイド

  13. Anvil の検索コンソール Anvil Works · アプリプラットフォーム

    Anvil PythonアプリをSearch Consoleと連携させるには、アプリ内にデータベース認証情報を埋め込むのではなく、RESTエンドポイントを使用します。

    検索コンソールガイド
  14. AIツール向け

  15. 検索コンソール MCP サーバー Claude、Cursor、およびMCPクライアント

    AIアシスタントには、正しいSQLを作成するために必要なスキーマを含むSearch Consoleへの読み取り専用アクセス権を付与します。チャットに認証情報を含めないでください。

    検索コンソールガイド
  16. 人々に届けられる

  17. Search Consoleのアラートとレポート Slack · Discord · メール · Webhook

    Search Consoleクエリをスケジュール設定して、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、または変化率が設定した値を超えるまでメッセージを保留することができます。

    アラートとレポートの仕組み

仕組み

5つのステップ、受信ファイアウォールの変更は不要

01

Googleサービスアカウントを作成し、それをSearch Consoleプロパティのユーザーとして追加します。

02

ネットワークエージェントをインストールし、サービスアカウントキーとサイトURL（https形式またはsc-domain形式のいずれか）を指定します。

03

保存します。最初の同期では、5種類の検索タイプすべてにおいて過去16か月分までさかのぼって検索します。

04

gsc.search_analyticsに対して通常のSQLを記述するか、Novaに記述させることもできます。

05

Excel、Sheets、Power BI、MCP、またはRESTからデータを読み込み、サインアップと収益が保存されているあらゆるデータソースに接続します。

機能の詳細解説

Search Console が提供するもの

16か月分を1つの表にまとめました。

Search Console は 16 か月分のデータを保持し、一度に一部ずつ表示します。SQL に変換すれば、インターフェースではできない前年比の比較は GROUP BY によって行うことができます。

  • gsc.search_analyticsは、クエリ、ページ、国、デバイス、日ごとに1行のデータで構成され、クリック数、インプレッション数、クリック率、平均掲載順位が含まれています。
  • ウェブだけでなく、5種類の検索タイプが同期されます 画像、動画、ニュース、そしてDiscoverも表示され、それぞれにラベルが付いています。
  • DiscoverとNewsの行にはクエリやデバイスの情報は含まれません。これは、Googleがこれらの項目についてこれらのディメンションを報告していないためです。これらの列は、架空のものではなく、null値です。
  • gsc.sitesとgsc.sitemapsはそれぞれ独立したテーブルとして提供されるため、送信された件数とインデックスに登録された件数をクエリで比較できます。

Googleの遅延について正直に

Search Consoleのデータは概ね3日遅れており、最初の表示後も直近数日のデータは頻繁に更新されます。これらはどちらもGoogleの仕様であり、隠蔽されることなく公開されています。

  • 同期は3日前までしか行われません。それより新しい情報を要求しても、明日には間違った数値が返されるからです。
  • 各行には、データの状態を示す列があり、それが部分的なデータか最終的なデータかを示すため、レポートでは、まだ確定していない日を平均値に含めるのではなく、除外することができます。
  • 各増分処理では過去5日間のデータを再読み込みするため、部分的な行は最初に読み込まれたバージョンのままではなく、最終的な行として扱われます。

私たちはこれを自分たちで使っています

Query Streamsはこのコネクタ上で独自のSEO処理を実行します。同じテーブル、同じ3日間の遅延、同じ部分完了/完了フラグを使用します。これはロゴウォールに飾るためのデモ統合ではありません。

  • クエリの結果、Googleが1ページあたり1日に返す2万5千行を超えるデータが表示された場合、そのデータのみが取得されます。複数の次元に分割することは自動的には行われません。
  • URL検査テーブルは存在し、スケジュールされた同期ではなく、必要に応じてデータが入力されます。

すべてのAPIコネクタで共有されます

各APIコネクタの仕組み

  • あなたのアカウントはテーブルになります エンドポイントは、主キーとインデックスを持つ型付きSQLテーブルにマッピングされるため、JSONをページングする代わりに、SELECT、JOIN、GROUP BYを記述します。
  • 同期する項目と頻度は自分で選択できます。 各テーブルにはそれぞれ独自の間隔が設定されている場合と、間隔が設定されていない場合がある。ベンダーのAPIが対応している場合は、前回の実行以降に変更されたレコードのみが取得される。
  • コピーはあなたのものです — それは、お客様のマシン上のエージェントと同じ場所にある、AES-256-GCMで暗号化されたDuckDBファイル内に存在します。当社のクラウド上にはありません。
  • ベンダーはあなたからしか連絡を受けない エージェントはユーザー自身のネットワークから直接APIを呼び出すため、クエリストリームがクエリに応答する際にトークンは必要ありません。

知っておくと良い

  • これは同期されたコピーであり、ライブプロキシではありません。 クエリは既に取得済みのデータを読み取るため、SQLの速度で処理が進み、APIのレート制限を消費することはありません。選択したテーブルでは、読み取り時に古い行を更新することも可能です。
  • レート制限は尊重されます 各コネクタはベンダーが公表している制限値を十分に下回るペースで動作するため、レポートによって、そのコネクタを使用する他のすべてのアカウントが制限されることはありません。
  • 何も捨てられない テーブルに名前が付けられていないフィールドは、クエリ可能なraw_data JSON列に保持されます。
  • データベースに結合してください — 同じステートメント内で API テーブルと SQL Server テーブルを使用することは、ここでは通常のクエリであり、統合プロジェクトではありません。

クロスソースSQL

Search Consoleを他のデータと連携させる

Search Consoleでは、どのページがクリックを獲得したかを知ることができます。しかし、それらのクリックのうちどれがアカウント作成につながったのか、またそのアカウントが最終的にいくら支払ったのかを知ることはできません。これらの情報は別の場所にあり、1つの明細書で3つすべてを確認できます。各ソースは実行可能な部分のみを実行し、結果をストリーミングで返送し、結合は中央で行われます。ソース同士が直接やり取りすることはなく、どこにもデータがコピーされることはありません。

接続数3件・エージェント数3名

Googleサーチコンソール SEOと検索
PostgreSQL 関係エンジン
ストライプ 支払いと請求

一つの声明

-- Search Consoleからのクリック数、データベースからのサインアップ数、Stripeからの収益
セレクト   s.page、SUM(s.clicks) AS clicks、SUM(i.amount_due) AS invoiced
フロム     gsc_site.gsc.search_analytics1 s
ジョイン     pg_crm.一般顧客2       c ON c.landing_page = s.page
ジョイン     請求する.stripe.invoices3       i ON i.customer = c.stripe_id
GROUP BY s.page
ORDER BY DESCをクリック;

3 つの部分は、接続、スキーマ、テーブルです。接続名は、あなたが付けた名前です。列は例示です。テーブルは、あなたのテーブルになります。Search Console のデータは 3 日前まで遡りますが、これは同期によって追加されたものではなく、Google 独自のレポート遅延です。読み取り専用はすべての部分に適用されます。SELECT、WITH、EXPLAIN のみで、1 つのクエリに対して 1 つのソースが渡せるデータの量には上限があります。 フェデレーションクエリの仕組み

接続の詳細

Search Consoleに必要なもの

認証
Google サービス アカウント キー。プロパティのユーザーとして追加されます。読み取り専用スコープで、エージェントに保持されます。
財産
サイトのURL（https://example.com/ または sc-domain:example.com）。空欄のままにすると、アカウントが表示できるすべてのプロパティが同期されます。
手を伸ばして
あなたのネットワークから検索コンソールAPIへの通信はHTTPSで行われます。受信通信はありません。
スキーマ
gsc — つまり、gsc.search_analytics、gsc.sitemaps などです。
表
4. search_analytics、sites、sitemaps、url_inspection
検索タイプ
ウェブ、画像、ビデオ、ニュース、発見、それぞれが行にラベル付けされている
鮮度
3日前まで遡って表示されますが、これはGoogle独自のレポート遅延によるものです。過去5日間は毎回再読み込みされます。
歴史
初回同期から16か月間 - Googleが保持するすべてのデータ
ローカルコピー
エージェントと同じマシン上に、AES-256-GCMで暗号化されたDuckDBファイルがあります。

読み取り専用は構造的なものです。このコネクタが行うすべての呼び出しは読み取りであり、保持するトークンは読み取り専用スコープです。サイトマップの送信やインデックス作成のリクエストはできません。

クロスソースクエリでは、3つの部分からなる参照の中央部分はgscです。検索分析を読み取るgsc_siteという接続は、gsc_site.gsc.search_analyticsと記述されます。

ベンダー資料： search.google.com

よくある質問

Google Search Consoleに関する質問

クエリ ストリームを通じて Google Search Console のデータを読み取ることができるツールはどれですか？

Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。アカウントを一度接続すれば、すべてのインターフェースが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は一切不要です。

Google Search Consoleアカウントへのファイアウォールポートを開放する必要がありますか？

いいえ。Query Streams Network Agentはネットワーク内で動作し、暗号化された単一の送信接続を開きます。受信トラフィックを監視するものはなく、VPNも不要で、アカウントは既存のファイアウォールルールを維持します。

クエリ ストリームは Google Search Console のデータを変更することができますか？

いいえ。エージェントは実行時に読み取り専用を強制します。つまり、一度に1つのステートメント（SELECT文など）のみを実行します。認証情報はエージェント上に保持され、クエリ ストリームに送信されることはありません。

Query StreamsがGoogle Search Consoleに接続するために必要なものは何ですか？

到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバーを保持するため、アカウントには何もインストールされません。認証: プロパティのユーザーとして追加された Google サービス アカウント キー。エージェントに保持される読み取り専用スコープ。プロパティ: サイト URL - https://example.com/ または sc-domain:example.com。空白のままにすると、アカウントが表示できるすべてのプロパティが同期されます。アクセス方法: ネットワークから Search Console API への HTTPS。受信はありません。スキーマ: gsc - つまり、gsc.search_analytics、gsc.sitemaps。

Google Search Consoleを別のデータベースに同じクエリで結合することはできますか？

はい、それはフェデレーションクエリです。1つのステートメントで、Google Search Consoleと他の接続を同時に参照でき、connection.schema.table の形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用はすべての部分（SELECT、WITH、EXPLAINのみ）に適用され、1つのソースが単一のクエリで渡せるデータ量には上限があります。フェデレーションクエリはプラン機能であり、フェデレーションクエリのページには現在のソースとサイズの制限が表示されます。

作業が行われる場所に検索コンソールを配置する

エージェントをインストールし、アカウントを指定して、送信先を選択してください。

無料で始めよう すべてのコネクタ

読み取り専用 発信専用 認証情報はエージェントに保持されます