Rube MCP 経由の Google Search Console 自動化
Rube MCP (Composio) を使用して、Google Search Console の検索アナリティクスのクエリ、URL 検査、サイトマップ管理、検索パフォーマンスの監視を自動化します。
ツールキットドキュメント: composio.dev/toolkits/google_search_console
前提条件
- Rube MCP が接続されていること（
RUBE_SEARCH_TOOLSが利用可能） RUBE_MANAGE_CONNECTIONSを使用して toolkitgoogle_search_consoleのアクティブな接続があること- Google Search Console でサイトの所有権が確認されている、または適切な権限があること
- 現在のツールスキーマを取得するために、常に最初に
RUBE_SEARCH_TOOLSを呼び出すこと
セットアップ
Rube MCP を取得: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要です。エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCP が利用可能であることを確認します。- toolkit
google_search_consoleを指定してRUBE_MANAGE_CONNECTIONSを呼び出します。 - 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します。
- ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します。
コアワークフロー
1. 確認済みサイトの一覧表示
GOOGLE_SEARCH_CONSOLE_LIST_SITES を使用して、認証済みユーザーが所有またはアクセス権を持つすべてのサイトを取得します。
ツール: GOOGLE_SEARCH_CONSOLE_LIST_SITES
パラメータ: (なし)
戻り値: siteUrl と permissionLevel を含むサイトエントリのリスト
2. 検索アナリティクスのクエリ
GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY を使用して、クリック数、インプレッション数、CTR、掲載順位を含む検索パフォーマンスデータを取得します。
ツール: GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY
パラメータ:
- site_url (必須): サイトURL (例: "https://www.example.com/" または "sc-domain:example.com")
- start_date (必須): 開始日 (YYYY-MM-DD形式)
- end_date (必須): 終了日 (YYYY-MM-DD形式)
- dimensions: ["query", "page", "country", "device", "date", "searchAppearance"] でグループ化
- search_type: "web" (デフォルト), "image", "video", "news", "discover", "googleNews"
- dimension_filter_groups: ディメンションのフィルター (演算子: equals, notEquals, contains, notContains, includingRegex, excludingRegex)
- row_limit: 最大行数 (1～25000、デフォルト 1000)
- start_row: ページネーションオフセット (デフォルト 0)
- aggregation_type: "auto", "byPage", "byProperty", "byNewsShowcasePanel"
- data_state: "final" (デフォルト), "all", "hourly_all"
3. URL の検査
GOOGLE_SEARCH_CONSOLE_INSPECT_URL を使用して、特定の URL のインデックスステータスと問題を確認します。
ツール: GOOGLE_SEARCH_CONSOLE_INSPECT_URL
パラメータ:
- inspection_url (必須): 検査する完全なURL (例: "https://www.example.com/page")
- site_url (必須): プロパティURL (例: "https://www.example.com/")
- language_code: BCP-47言語 (デフォルト: "en-US")
4. サイトマップの一覧表示
GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS を使用して、サイトに提出されたすべてのサイトマップを取得します。
ツール: GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS
パラメータ:
- site_url (必須): サイトURL (例: "https://www.example.com/")
- sitemap_index: サイトマップを一覧表示する特定のサイトマップインデックスURL
5. サイトマップの提出
GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP を使用して、インデックス登録のためにサイトマップを登録または再提出します。
ツール: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP
パラメータ:
- site_url (必須): サイトURLまたはドメインプロパティ (例: "sc-domain:example.com")
- feedpath (必須): 完全なサイトマップURL (例: "https://www.example.com/sitemap.xml")
6. サイトマップ詳細の取得
GOOGLE_SEARCH_CONSOLE_GET_SITEMAP を使用して、提出された特定のサイトマップの情報を取得します。
ツール: GOOGLE_SEARCH_CONSOLE_GET_SITEMAP
パラメータ:
- site_url (必須): サイトURL
- feedpath (必須): 詳細を取得するサイトマップURL
一般的なパターン
- パフォーマンス監視:
GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERYをdimensions: ["date"]と共に日付範囲で使用して、日別の検索パフォーマンスの傾向を追跡します。 - 上位クエリレポート:
GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERYをdimensions: ["query"]と共に使用して、最もクリックされた検索語句を見つけます。 - ページレベル分析:
dimensions: ["page"]を使用してトップパフォーマンスページを特定し、その後dimensions: ["query", "page"]を使用して各ページにトラフィックをもたらすクエリを確認します。 - インデックス監査:
GOOGLE_SEARCH_CONSOLE_INSPECT_URLを使用して、重要なページのインデックスステータスを確認します。 - サイトマップ管理:
GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPSを使用して提出済みサイトマップを確認し、その後GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAPを使用して新しいサイトマップや更新されたサイトマップを提出します。 - 国/デバイス内訳:
dimensions: ["country", "device"]を使用して、検索トラフィックの地理的およびデバイスタイプ別の分布を把握します。 - 特定クエリのフィルタリング:
dimension_filter_groupsをcontainsまたはincludingRegex演算子と共に使用して、特定のキーワードグループに焦点を当てます。
既知の落とし穴
- サイトURL形式の重要性: URLプレフィックスプロパティは、プロトコルと末尾のスラッシュを含む完全なURL（例:
https://www.example.com/）を使用します。ドメインプロパティはsc-domain:プレフィックス（例:sc-domain:example.com）を使用します。間違った形式を使用すると、空の結果またはエラーが返されます。 - 日付範囲の制限: データは通常2～3日の遅延で利用可能になります。
data_state: "all"には、まだ変更される可能性のある新しいデータが含まれます。hourly_allは過去3日以内の日付でのみ機能します。 - 行数制限とページネーション: API はクリック数（日付でグループ化する場合は日付）でソートされた上位結果を返します。完全なデータを取得するには、
start_rowとrow_limitを使用してページネーションを行います。 - リクエストあたり最大 25,000 行: ページネーションを使用しても、各リクエストは最大 25,000 行しか返しません。非常に大きなデータセットの場合は、日付範囲を狭めるか、ディメンションフィルターを追加します。
- 検査URLはサイトと一致する必要がある:
inspection_urlはsite_urlプロパティ配下のページである必要があります。プロパティをまたがる検査は失敗します。 - サイトマップはアクセス可能である必要がある:
GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAPでは、サイトマップファイルが指定されたURLで公開アクセス可能であり、XMLとして適切にフォーマットされている必要があります。 - 結果はクリック数でソート: デフォルトでは、アナリティクスの結果はクリック数の降順でソートされます。ただし、
dateでグループ化する場合（日付の昇順でソート）は除きます。
クイックリファレンス
| アクション | ツール | 主要パラメータ |
|---|---|---|
| サイト一覧 | GOOGLE_SEARCH_CONSOLE_LIST_SITES | (なし) |
| 検索アナリティクス | GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY | site_url, start_date, end_date, dimensions |
| URL 検査 | GOOGLE_SEARCH_CONSOLE_INSPECT_URL | inspection_url, site_url |
| サイトマップ一覧 | GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS | site_url |
| サイトマップ提出 | GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP | site_url, feedpath |
| サイトマップ情報取得 | GOOGLE_SEARCH_CONSOLE_GET_SITEMAP | site_url, feedpath |
Powered by Composio