Rube MCPによるYouTube自動化
ComposioのYouTubeツールキットをRube MCP経由で操作し、YouTubeタスクを自動化します。
前提条件
- Rube MCPが接続されていること(
RUBE_SEARCH_TOOLSが利用可能) RUBE_MANAGE_CONNECTIONSでツールキットyoutubeを使用したアクティブなYouTube接続- 最新のツールスキーマを取得するため、最初に必ず
RUBE_SEARCH_TOOLSを呼び出すこと
セットアップ
Rube MCPの入手: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加してください。APIキーは不要で、エンドポイントを追加するだけで利用できます。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCPが利用可能であることを確認するRUBE_MANAGE_CONNECTIONSをツールキットyoutubeで呼び出す- 接続がACTIVEでない場合は、返された認証リンクに従ってGoogle OAuthを完了する
- ワークフローを実行する前に、接続ステータスがACTIVEであることを確認する
主要ワークフロー
1. 動画のアップロードと管理
使用するタイミング: ユーザーが動画をアップロードしたい、または動画のメタデータを更新したい場合
ツールの順序:
YOUTUBE_UPLOAD_VIDEO- 新しい動画をアップロード [必須]YOUTUBE_UPDATE_VIDEO- タイトル、説明、タグ、公開設定を更新 [任意]YOUTUBE_UPDATE_THUMBNAIL- カスタムサムネイルを設定 [任意]
主要パラメータ:
title: 動画のタイトル(最大100文字)description: 動画の説明(最大5000バイト)tags: キーワードタグの配列categoryId: YouTubeカテゴリID(例: '22' = 人とブログ)privacyStatus: 'public'、'private'、'unlisted' のいずれかvideoFilePath: 動画ファイルの{name, mimetype, s3key}オブジェクト
注意点:
- UPLOAD_VIDEOはクォータを多く消費するため、メタデータのみの変更にはUPDATE_VIDEOを優先すること
- videoFilePathはs3keyを含むオブジェクトである必要があり、生のファイルパスやURLではいけません
- タグの合計長は区切り文字を含めて500文字を超えてはいけません
- タグ内の山括弧
< >は自動的に削除されます - 説明の制限は5000バイト(文字数ではなく、マルチバイト文字は多くカウントされます)
2. YouTubeコンテンツの検索
使用するタイミング: ユーザーが動画、チャンネル、プレイリストを検索したい場合
ツールの順序:
YOUTUBE_SEARCH_YOU_TUBE- コンテンツを検索 [必須]YOUTUBE_VIDEO_DETAILS- 特定の動画の詳細を取得 [任意]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 複数の動画の詳細を取得 [任意]
主要パラメータ:
q: 検索クエリ(完全一致フレーズ、除外、チャンネルハンドルに対応)type: 'video'、'channel'、'playlist' のいずれかmaxResults: 1ページあたりの結果数(1~50)pageToken: ページネーション用
注意点:
- 検索エンドポイントは'snippet'部分のみを返します。統計情報を取得するにはVIDEO_DETAILSを使用してください
- 検索結果は合計500アイテムが上限です
- 検索のクォータコスト(100単位)はリストエンドポイント(1単位)よりも高い
- BATCH動画詳細の実用的な上限は1回の呼び出しあたり約50IDです。大きなセットは分割してください
3. プレイリストの管理
使用するタイミング: ユーザーがプレイリストを作成したり、プレイリストの内容を管理したい場合
ツールの順序:
YOUTUBE_LIST_USER_PLAYLISTS- ユーザーの既存プレイリストを一覧表示 [任意]YOUTUBE_CREATE_PLAYLIST- 新しいプレイリストを作成 [任意]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- 動画をプレイリストに追加 [任意]YOUTUBE_LIST_PLAYLIST_ITEMS- プレイリスト内の動画を一覧表示 [任意]
主要パラメータ:
playlistId: プレイリストID(ユーザー作成は'PL...'、アップロードは'UU...')part: 含めるリソース部分(例: 'snippet,contentDetails')maxResults: 1ページあたりのアイテム数(1~50)pageToken: 前回の応答からのページネーショントークン
注意点:
- チャンネルID('UC...')をプレイリストIDとして渡さないでください。アップロードについては'UC'を'UU'に変換してください
- 大きなプレイリストはpageTokenによるページネーションが必要です。nextPageTokenがなくなるまで続けてください
- items[].idはvideoIdではありません。items[].snippet.resourceId.videoIdを使用してください
- 重複するプレイリスト名の作成は許可されています。最初に既存のプレイリストを確認してください
4. チャンネルと動画のアナリティクス取得
使用するタイミング: ユーザーがチャンネルのパフォーマンスや動画のメトリクスを分析したい場合
ツールの順序:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- ハンドルをチャンネルIDに解決 [前提条件]YOUTUBE_GET_CHANNEL_STATISTICS- チャンネルの登録者数、視聴数、動画数を取得 [必須]YOUTUBE_LIST_CHANNEL_VIDEOS- チャンネルのすべての動画を一覧表示 [任意]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 動画ごとの統計情報を取得 [任意]YOUTUBE_GET_CHANNEL_ACTIVITIES- 最近のチャンネルアクティビティを取得 [任意]
主要パラメータ:
channelId: チャンネルID('UC...')、ハンドル('@handle')、または'me'forHandle: チャンネルハンドル(例: '@Google')id: バッチ詳細用のカンマ区切りの動画IDparts: 含めるリソース部分(例: 'snippet,statistics')
注意点:
- チャンネル統計情報は全期間の合計であり、期間ごとではありません
- BATCH動画詳細は、非公開または削除された動画については要求よりも少ないアイテムを返す場合があります
- 応答データは
dataまたはdata_previewの下にネストされている場合があるため、防御的に解析してください - contentDetails.durationはISO 8601形式(例: 'PT4M13S')を使用します
5. チャンネル登録とコメントの管理
使用するタイミング: ユーザーがチャンネルに登録したり、動画のコメントを表示したい場合
ツールの順序:
YOUTUBE_SUBSCRIBE_CHANNEL- チャンネルに登録 [任意]YOUTUBE_UNSUBSCRIBE_CHANNEL- チャンネルの登録を解除 [任意]YOUTUBE_LIST_USER_SUBSCRIPTIONS- 登録チャンネルを一覧表示 [任意]YOUTUBE_LIST_COMMENT_THREADS- 動画のコメントを一覧表示 [任意]
主要パラメータ:
channelId: 登録/解除するチャンネルvideoId: コメントスレッド用の動画IDmaxResults: 1ページあたりの結果数pageToken: ページネーショントークン
注意点:
- 既に登録しているチャンネルに再度登録しようとするとエラーが返される場合があります
- コメントスレッドは、それぞれ最大5件の返信を持つトップレベルコメントを返します
- 一部の動画ではコメントが無効になっている場合があります
- 登録解除にはサブスクリプションID(チャンネルIDではない)が必要です
共通パターン
チャンネルIDの解決
ハンドルからチャンネルIDへ:
1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLEを'@handle'で呼び出す
2. 応答からchannelIdを抽出する
3. 後続のチャンネル操作で使用する
アップロードプレイリスト:
1. チャンネルIDを取得('UC'で始まる)
2. 'UC'プレフィックスを'UU'に置き換えてアップロードプレイリストIDを取得する
3. LIST_PLAYLIST_ITEMSとともに使用してすべての動画を列挙する
ページネーション
maxResultsを設定(1ページあたり最大50)- 応答の
nextPageTokenを確認 - トークンを次のリクエストの
pageTokenとして渡す nextPageTokenがなくなるまで続ける
バッチ動画詳細
- 検索またはプレイリスト一覧から動画IDを収集する
- 約50IDのグループに分割する
- グループごとにGET_VIDEO_DETAILS_BATCHを呼び出す
- グループ間で結果をマージする
既知の注意点
クォータ管理:
- YouTube APIには1日あたりのクォータ制限があります(デフォルト10,000単位)
- アップロード = 1600単位;検索 = 100単位;リスト = 1単位
- 可能な場合は、検索よりもリストエンドポイントを優先すること
- クォータ使用量を監視して、1日の制限に達しないようにする
ID形式:
- 動画ID: 11文字の英数字文字列
- チャンネルID: 'UC'で始まり、22文字が続く
- プレイリストID: 'PL'(ユーザー作成)または'UU'(アップロード)で始まる
- チャンネルIDとプレイリストIDを混同しないこと
サムネイル:
- カスタムサムネイルにはチャンネルの電話確認が必要です
- JPG、PNG、GIF形式である必要があり、2MB未満
- 推奨解像度: 1280x720(16:9アスペクト比)
応答の解析:
- 統計値は整数ではなく文字列として返されます。計算前にキャストしてください
- 期間はISO 8601形式(PT#H#M#S)を使用します
- バッチ応答はデータを異なるキーの下にラップする場合があります
クイックリファレンス
| タスク | ツールスラッグ | 主要パラメータ |
|---|---|---|
| 動画をアップロード | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| 動画を更新 | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| サムネイルを設定 | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| YouTubeを検索 | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| 動画詳細 | YOUTUBE_VIDEO_DETAILS | id, part |
| 動画詳細(バッチ) | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| プレイリスト一覧 | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| プレイリスト作成 | YOUTUBE_CREATE_PLAYLIST | (スキーマを確認) |
| プレイリストに追加 | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (スキーマを確認) |
| プレイリストアイテム一覧 | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| チャンネル統計 | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| チャンネル動画一覧 | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| ハンドルからチャンネルID | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| チャンネル登録 | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| 登録一覧 | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (スキーマを確認) |
| コメント一覧 | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| チャンネルアクティビティ | YOUTUBE_GET_CHANNEL_ACTIVITIES | (スキーマを確認) |