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 が利用可能かを確認する- ツールキット
youtubeを指定してRUBE_MANAGE_CONNECTIONSを呼び出す - 接続が ACTIVE でない場合は、返された認証リンクに従って Google OAuth を完了する
- ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認する
コアワークフロー
1. 動画のアップロードと管理
使用タイミング: ユーザーが動画をアップロードしたり、動画メタデータを更新したい場合
ツールの順序:
YOUTUBE_UPLOAD_VIDEO- 新しい動画をアップロード [必須]YOUTUBE_UPDATE_VIDEO- タイトル、説明、タグ、プライバシーを更新 [任意]YOUTUBE_UPDATE_THUMBNAIL- カスタムサムネイルを設定 [任意]
主要パラメータ:
title: 動画タイトル(最大100文字)description: 動画の説明(最大5000バイト)tags: キーワードタグの配列categoryId: YouTube カテゴリ ID(例:'22' は People & Blogs)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アイテムまで
- 検索はリストエンドポイント(1ユニット)に比べてクォータコストが高い(100ユニット)
- バッチ動画詳細の実用的な上限は1回の呼び出しあたり約50 ID で、それ以上は分割すること
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: バッチ詳細用の動画 ID をカンマ区切りで指定parts: 含めるリソース部分(例:'snippet,statistics')
注意点:
- チャンネル統計情報は累計値であり、期間ごとの値ではない
- バッチ動画詳細は、非公開・削除された動画がある場合、要求した数より少ないアイテムを返すことがある
- レスポンスデータは
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 を収集
- 約50 ID ずつのグループに分割
- グループごとに 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 | (スキーマを確認) |
使用タイミング
このスキルは、概要に記載されたワークフローやアクションを実行する際に適用可能です。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと。
- 必要な入力、権限、安全性の境界、または成功基準が不足している場合は、停止して明確化を求めること。