Rube MCP による YouTube 自動化
Composio の YouTube ツールキットを Rube MCP 経由で使用して YouTube 操作を自動化します。
前提条件
- Rube MCP が接続されていること(
RUBE_SEARCH_TOOLSが利用可能) - ツールキット
youtubeを使用してRUBE_MANAGE_CONNECTIONS経由でアクティブな 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文字ではなく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ユニット)がかかります
- 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')
注意点:
- チャンネル統計は期間ごとではなく、累計値です
- バッチ動画詳細では、非公開または削除された動画に対して要求よりも少ないアイテムが返される場合があります
- 応答データは
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. 応答からチャンネルIDを抽出する
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 | (スキーマを確認) |
使用するタイミング
このスキルは、概要に記載されたワークフローやアクションを実行する場合に適用されます。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、または成功基準が不足している場合は、中断して明確化を求めてください。