Communitygithub.com

benjaminasterA/antigravity-awesome-skills

Rube MCP(Composio)経由でYouTubeタスクを自動化します。動画のアップロード、プレイリスト管理、コンテンツ検索、分析情報の取得、コメント管理などを行えます。常にツールを先に検索して現在のスキーマを確認してください。

antigravity-awesome-skills とは?

このスキルは、Rube MCP(ComposioのYouTubeツールキット)を介してYouTubeの様々な操作を自動化するための包括的なガイドです。開発者やAIエージェントユーザーは、このスキルを使って動画のアップロード・更新、プレイリストの作成・管理、コンテンツの検索、チャンネル統計情報の取得、コメントや購読の管理などを効率的に行えます。対応プラットフォームはRube MCPで、特別なAPIキーは不要でエンドポイントを追加するだけで利用可能です。重要な注意点として、常に最初に`RUBE_SEARCH_TOOLS`を呼び出して現在のツールスキーマを取得し、その後`RUBE_MANAGE_CONNECTIONS`でYouTube接続を確立する必要があります。また、YouTube APIのクオータ制限やIDフォーマット、レスポンス解析の注意点など、実運用で直面しやすい落とし穴についても詳細に解説しています。

対応~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/youtube-automation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Rube MCPによるYouTube自動化

ComposioのYouTubeツールキットをRube MCP経由で使用し、YouTube操作を自動化します。

前提条件

  • Rube MCPが接続されていること(RUBE_SEARCH_TOOLSが利用可能)
  • RUBE_MANAGE_CONNECTIONSを使用してtoolkit youtubeでYouTube接続がアクティブであること
  • 常に最初にRUBE_SEARCH_TOOLSを呼び出し、現在のツールスキーマを取得してください

セットアップ

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

  1. RUBE_SEARCH_TOOLSが応答することを確認し、Rube MCPが利用可能かを確認する
  2. toolkit youtubeを指定してRUBE_MANAGE_CONNECTIONSを呼び出す
  3. 接続がACTIVEでない場合、返された認証リンクに従いGoogle OAuthを完了する
  4. ワークフローを実行する前に接続ステータスがACTIVEであることを確認する

コアワークフロー

1. 動画のアップロードと管理

使用するタイミング: ユーザーが動画をアップロードしたり、メタデータを更新したい場合

ツールの順序:

  1. YOUTUBE_UPLOAD_VIDEO - 新しい動画をアップロード [必須]
  2. YOUTUBE_UPDATE_VIDEO - タイトル、説明、タグ、公開範囲を更新 [任意]
  3. 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コンテンツの検索

使用するタイミング: 動画、チャンネル、プレイリストを探したい場合

ツールの順序:

  1. YOUTUBE_SEARCH_YOU_TUBE - コンテンツを検索 [必須]
  2. YOUTUBE_VIDEO_DETAILS - 特定の動画の詳細を取得 [任意]
  3. YOUTUBE_GET_VIDEO_DETAILS_BATCH - 複数の動画の詳細を取得 [任意]

主なパラメータ:

  • q: 検索クエリ(完全一致、除外、チャンネルハンドルに対応)
  • type: 'video'、'channel'、'playlist'のいずれか
  • maxResults: 1ページあたりの結果数(1~50)
  • pageToken: ページネーショントークン

注意点:

  • 検索エンドポイントは'snippet'部分のみを返します。統計情報を取得するにはVIDEO_DETAILSを使用
  • 検索結果は最大500項目
  • 検索はリストエンドポイント(1ユニット)に比べて高いクオータコスト(100ユニット)がかかります
  • バッチ動画詳細は1回あたり約50IDが実用的な上限です。大きなセットは分割してください

3. プレイリストの管理

使用するタイミング: プレイリストを作成したり、内容を管理したい場合

ツールの順序:

  1. YOUTUBE_LIST_USER_PLAYLISTS - ユーザーの既存プレイリストを一覧 [任意]
  2. YOUTUBE_CREATE_PLAYLIST - 新しいプレイリストを作成 [任意]
  3. YOUTUBE_ADD_VIDEO_TO_PLAYLIST - プレイリストに動画を追加 [任意]
  4. 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. チャンネルと動画の分析情報取得

使用するタイミング: チャンネルのパフォーマンスや動画の指標を分析したい場合

ツールの順序:

  1. YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - ハンドルからチャンネルIDを解決 [前提条件]
  2. YOUTUBE_GET_CHANNEL_STATISTICS - チャンネルの登録者数、再生回数、動画数を取得 [必須]
  3. YOUTUBE_LIST_CHANNEL_VIDEOS - チャンネルの全動画を一覧 [任意]
  4. YOUTUBE_GET_VIDEO_DETAILS_BATCH - 動画ごとの統計情報を取得 [任意]
  5. 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. 購読とコメントの管理

使用するタイミング: チャンネルに登録したり、動画のコメントを表示したい場合

ツールの順序:

  1. YOUTUBE_SUBSCRIBE_CHANNEL - チャンネルを登録 [任意]
  2. YOUTUBE_UNSUBSCRIBE_CHANNEL - チャンネルの登録を解除 [任意]
  3. YOUTUBE_LIST_USER_SUBSCRIPTIONS - 登録チャンネル一覧 [任意]
  4. YOUTUBE_LIST_COMMENT_THREADS - 動画のコメントを一覧 [任意]

主なパラメータ:

  • channelId: 登録/解除するチャンネル
  • videoId: コメントスレッドを取得する動画ID
  • maxResults: 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_VIDEOtitle, description, tags, categoryId, privacyStatus, videoFilePath
動画更新YOUTUBE_UPDATE_VIDEOvideo_id, title, description, tags
サムネイル設定YOUTUBE_UPDATE_THUMBNAILvideoId, thumbnailUrl
YouTube検索YOUTUBE_SEARCH_YOU_TUBEq, type, maxResults
動画詳細YOUTUBE_VIDEO_DETAILSid, part
バッチ動画詳細YOUTUBE_GET_VIDEO_DETAILS_BATCHid, parts
プレイリスト一覧YOUTUBE_LIST_USER_PLAYLISTSmaxResults, pageToken
プレイリスト作成YOUTUBE_CREATE_PLAYLIST(スキーマを確認)
プレイリストに追加YOUTUBE_ADD_VIDEO_TO_PLAYLIST(スキーマを確認)
プレイリストアイテム一覧YOUTUBE_LIST_PLAYLIST_ITEMSplaylistId, maxResults
チャンネル統計YOUTUBE_GET_CHANNEL_STATISTICSid/forHandle/mine
チャンネル動画一覧YOUTUBE_LIST_CHANNEL_VIDEOSchannelId, maxResults
ハンドルからチャンネルIDYOUTUBE_GET_CHANNEL_ID_BY_HANDLEchannel_handle
チャンネル登録YOUTUBE_SUBSCRIBE_CHANNELchannelId
登録一覧YOUTUBE_LIST_USER_SUBSCRIPTIONS(スキーマを確認)
コメント一覧YOUTUBE_LIST_COMMENT_THREADSvideoId
チャンネルアクティビティYOUTUBE_GET_CHANNEL_ACTIVITIES(スキーマを確認)

使用するタイミング

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

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル