Rube MCP による Instagram オートメーション

Composio の Instagram ツールキットを介して、Rube MCP から Instagram の操作をオートメーション化します。

前提条件

• Rube MCP が接続されていること (RUBE_SEARCH_TOOLS が利用可能)
• ツールキット instagram を使用した RUBE_MANAGE_CONNECTIONS 経由のアクティブな Instagram 接続
• 常に最初に RUBE_SEARCH_TOOLS を呼び出して、現在のツール スキーマを取得
• Instagram ビジネス アカウントまたはクリエイター アカウントが必須 (個人アカウントはサポートされません)

セットアップ

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

1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能であることを確認
2. RUBE_MANAGE_CONNECTIONS をツールキット instagram で呼び出し
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Instagram/Facebook OAuth を完了
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認

コア ワークフロー

1. 単一の画像/動画投稿を作成

使用する場合: ユーザーが単一の写真または動画を Instagram に公開したい場合

ツール シーケンス:

1. INSTAGRAM_GET_USER_INFO - Instagram ユーザー ID を取得 [前提条件]
2. INSTAGRAM_CREATE_MEDIA_CONTAINER - 画像/動画 URL を含むメディア コンテナを作成 [必須]
3. INSTAGRAM_GET_POST_STATUS - メディア コンテナが準備完了であるかを確認 [オプション]
4. INSTAGRAM_CREATE_POST または INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - コンテナを公開 [必須]

主要パラメータ:

• image_url: 投稿する画像の公開 URL
• video_url: 投稿する動画の公開 URL
• caption: 投稿キャプション テキスト
• ig_user_id: Instagram ビジネス アカウント ユーザー ID

落とし穴:

• メディア URL は公開アクセス可能である必要があります。プライベート/認証済み URL は失敗します
• ビデオ コンテナは処理に時間がかかる可能性があります。公開する前に GET_POST_STATUS でポーリングしてください
• キャプションはハッシュタグとメンションをサポートしていますが、2200 文字の制限があります
• 処理がまだ完了していないコンテナを公開するとエラーが返されます

2. カルーセル投稿を作成

使用する場合: ユーザーが複数の画像/動画を単一のカルーセル投稿で公開したい場合

ツール シーケンス:

1. INSTAGRAM_CREATE_MEDIA_CONTAINER - 各メディア アイテムの個別コンテナを作成 [必須、アイテムごとに繰り返す]
2. INSTAGRAM_CREATE_CAROUSEL_CONTAINER - すべてのメディア コンテナを参照するカルーセル コンテナを作成 [必須]
3. INSTAGRAM_GET_POST_STATUS - カルーセル コンテナの準備状況を確認 [オプション]
4. INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - カルーセルを公開 [必須]

主要パラメータ:

• children: カルーセル用のメディア コンテナ ID の配列
• caption: カルーセル投稿キャプション
• ig_user_id: Instagram ビジネス アカウント ユーザー ID

落とし穴:

• カルーセルには 2～10 個のメディア アイテムが必須です。それより少ないまたは多いと失敗します
• 各子コンテナはカルーセル コンテナを作成する前に個別に作成する必要があります
• カルーセルを作成する前に、すべての子コンテナが完全に処理されている必要があります
• カルーセルでは混合メディア (画像 + 動画) がサポートされています

3. メディアと インサイトを取得

使用する場合: ユーザーが投稿を表示または投稿パフォーマンスを分析したい場合

ツール シーケンス:

1. INSTAGRAM_GET_IG_USER_MEDIA または INSTAGRAM_GET_USER_MEDIA - ユーザーのメディアをリスト表示 [必須]
2. INSTAGRAM_GET_IG_MEDIA - 特定の投稿の詳細を取得 [オプション]
3. INSTAGRAM_GET_POST_INSIGHTS または INSTAGRAM_GET_IG_MEDIA_INSIGHTS - 投稿のメトリクスを取得 [オプション]
4. INSTAGRAM_GET_USER_INSIGHTS - アカウント レベルのインサイトを取得 [オプション]

主要パラメータ:

• ig_user_id: Instagram ビジネス アカウント ユーザー ID
• media_id: 特定のメディア投稿の ID
• metric: 取得するメトリクス (例: impressions、reach、engagement)
• period: インサイトの期間 (例: day、week、lifetime)

落とし穴:

• インサイトはビジネス/クリエイター アカウントのみ利用可能です
• 一部のメトリクスには最小フォロワー数が必要です
• インサイト データは最大 48 時間の遅延がある場合があります
• period パラメータはメトリク タイプと一致する必要があります

4. 公開制限を確認

使用する場合: ユーザーが投稿を試みる前に公開できることを確認したい場合

ツール シーケンス:

1. INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT - 残りの公開クォータを確認 [必須]

主要パラメータ:

• ig_user_id: Instagram ビジネス アカウント ユーザー ID

落とし穴:

• Instagram は 24 時間ローリング ウィンドウで 25 投稿の制限を実施しています
• 公開制限は午前 0 時ではなくローリング ベースでリセットされます
• 一括投稿操作の前に制限を確認して失敗を回避してください

5. メディア コメントと子を取得

使用する場合: ユーザーが投稿のコメントまたはカルーセルの子を表示したい場合

ツール シーケンス:

1. INSTAGRAM_GET_IG_MEDIA_COMMENTS - メディア投稿のコメントをリスト表示 [必須]
2. INSTAGRAM_GET_IG_MEDIA_CHILDREN - カルーセル投稿の子をリスト表示 [オプション]

主要パラメータ:

• media_id: メディア投稿の ID
• ig_media_id: 代替メディア ID パラメータ

落とし穴:

• コメントはページネーション される場合があります。完全な結果を取得するにはページネーション カーソルに従ってください
• カルーセルの子は個別のメディア オブジェクトとして返されます
• アカウントのコメント モデレーション設定が返される内容に影響します

一般的なパターン

ID 解決

Instagram ユーザー ID:

1. INSTAGRAM_GET_USER_INFO を呼び出す
2. レスポンスから ig_user_id を抽出
3. その後のすべての API 呼び出しで使用

メディア コンテナ ステータス チェック:

1. INSTAGRAM_CREATE_MEDIA_CONTAINER を呼び出す
2. レスポンスから container_id を抽出
3. container_id を使用して INSTAGRAM_GET_POST_STATUS でポーリング
4. 公開する前にステータスが 'FINISHED' になるまで待機

2 段階公開

• フェーズ 1: コンテンツ URL を含むメディア コンテナを作成
• フェーズ 2: 処理完了後にコンテナを公開
• 動画コンテンツの場合は常にフェーズ間でコンテナ ステータスを確認
• カルーセルの場合は、カルーセル コンテナを作成する前にすべての子がフェーズ 1 を完了している必要があります

既知の落とし穴

メディア URL:

• すべての画像/動画 URL は公開アクセス可能な HTTPS URL である必要があります
• 認証の背後にある URL、CDN 制限がある URL、またはクッキーが必要な URL は失敗します
• 一時的な URL (署名済み S3 など) は処理完了前に期限切れになる場合があります

レート制限:

• 24 時間ローリング ウィンドウで 25 投稿
• API レート制限は公開制限とは別に適用されます
• 429 レスポンスに対して指数バックオフを実装してください

アカウント要件:

• ビジネス またはクリエイター Instagram アカウントのみがサポートされています
• 個人アカウントは Instagram Graph API を使用できません
• アカウントは Facebook ページに接続されている必要があります

レスポンス解析:

• メディア ID は数値文字列です
• インサイト データは異なるレスポンス キーの下にネストされる場合があります
• ページネーションはカーソルベースのトークンを使用します

クイック リファレンス

タスク	ツール スラッグ	主要パラメータ
ユーザー情報を取得	INSTAGRAM_GET_USER_INFO	(なし)
メディア コンテナを作成	INSTAGRAM_CREATE_MEDIA_CONTAINER	image_url/video_url、caption
カルーセルを作成	INSTAGRAM_CREATE_CAROUSEL_CONTAINER	children、caption
投稿を公開	INSTAGRAM_CREATE_POST	ig_user_id、creation_id
メディアを公開	INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH	ig_user_id、creation_id
投稿ステータスを確認	INSTAGRAM_GET_POST_STATUS	ig_container_id
ユーザーのメディアをリスト表示	INSTAGRAM_GET_IG_USER_MEDIA	ig_user_id
メディア詳細を取得	INSTAGRAM_GET_IG_MEDIA	ig_media_id
投稿インサイトを取得	INSTAGRAM_GET_POST_INSIGHTS	media_id、metric
ユーザー インサイトを取得	INSTAGRAM_GET_USER_INSIGHTS	ig_user_id、metric、period
公開制限を取得	INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT	ig_user_id
メディア コメントを取得	INSTAGRAM_GET_IG_MEDIA_COMMENTS	ig_media_id
カルーセルの子を取得	INSTAGRAM_GET_IG_MEDIA_CHILDREN	ig_media_id

使用する場合

このスキルは、上記の概要に記載されているワークフローまたはアクションを実行するときに適用されます。

制限事項

• このスキルは、上記に説明されているスコープと明らかに一致するタスクの場合のみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家レビューの代わりとして扱わないでください。
• 必要な入力、権限、セキュリティ境界、または成功基準が不足している場合は、停止して説明を求めてください。