Communitygithub.com

ASoudy/AGS

YouTube 操作を自動化するスキル:動画アップロード、プレイリスト管理、コンテンツ検索、分析取得、コメント処理など。Rube MCP(Composio)経由で実行します。

AGS とは?

このスキルは、Composio の YouTube ツールキットを Rube MCP 経由で利用し、YouTube 上の様々な操作を自動化するためのものです。主な機能として、動画のアップロードとメタデータ更新、動画・チャンネル・プレイリストの検索、プレイリストの作成と管理、チャンネル統計や動画分析の取得、チャンネル登録やコメント管理といったワークフローを提供します。各ワークフローは具体的なツールの呼び出し順序とパラメータが定義されており、開発者や AI エージェントはこれをガイドとして実行できます。特に、クォータ管理や ID フォーマットの違い(チャンネル ID とプレイリスト ID の変換など)、レスポンスのパース方法といった実践上の注意点も詳細にカバーしており、効率的でエラーの少ない自動化を実現します。対応プラットフォームは Rube MCP を MCP サーバーとして接続できる任意のクライアントです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/youtube-automation

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

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

ドキュメント

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 キーは不要で、エンドポイントを追加するだけで動作します。

  1. RUBE_SEARCH_TOOLS が応答することを確認して、Rube MCP が利用可能かを確認する
  2. ツールキット 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バイト(文字数ではないため、マルチバイト文字は多くカウントされる)

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回の呼び出しあたり約50 ID で、それ以上は分割すること

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 を収集
  • 約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_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 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

関連スキル