ComposioHQ/google-search-console-automation-console-automation

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 経由でツールキット google_search_console のアクティブな接続があること
• Google Search Console でサイト所有権が確認されているか、適切な権限があること
• まず常に RUBE_SEARCH_TOOLS を呼び出して現在のツールスキーマを取得してください

セットアップ

Rube MCP の取得: クライアント設定で MCP サーバーとして https://rube.app/mcp を追加します。APIキーは不要で、エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認します
2. RUBE_MANAGE_CONNECTIONS をツールキット google_search_console で呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了します
4. ワークフローを実行する前に、接続ステータスが 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

共通パターン

• パフォーマンス監視: dimensions: ["date"] を指定した GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY を日付範囲で使用して、日次の検索パフォーマンス推移を追跡します。
• 上位クエリレポート: dimensions: ["query"] を指定した GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_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-prefixプロパティでは完全なURL（プロトコルと末尾スラッシュ含む、例: https://www.example.com/）を使用します。ドメインプロパティでは sc-domain: プレフィックス（例: sc-domain:example.com）を使用します。間違った形式を使用すると、結果が空になるかエラーが発生します。
• 日付範囲の制限: データは通常2～3日遅れで利用可能です。data_state: "all" はより新しいデータを含みますが、まだ変更される可能性があります。hourly_all は過去3日間の日付に対してのみ機能します。
• 行制限とページネーション: APIはデフォルトでクリック数の降順（日付でグループ化する場合は日付の昇順）で結果を返します。完全なデータを取得するには、row_limit とともに start_row を使用してページネーションします。
• リクエストあたり最大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