Communitygithub.com

Desesbraker/agentes-vip

透過 Rube MCP (Composio) 自動化 YouTube 任務:上傳影片、管理播放清單、搜尋內容、取得分析資料以及處理留言。務必先搜尋工具以取得最新架構。

agentes-vip 是什麼?

此技能透過 Composio 的 YouTube 工具包,藉由 Rube MCP 自動化 YouTube 操作。它提供一套完整的工作流程,用於上傳及管理影片、搜尋內容、管理播放清單、取得頻道與影片分析,以及管理訂閱與留言。對於需要自動化 YouTube 工作流程的開發者與 AI 代理使用者來說,這項技能極具價值,因為它將多個 YouTube API 操作整合為邏輯化的步驟序列,有助於降低複雜性與潛在錯誤。支援的任務包括上傳影片(含選用中繼資料更新與自訂縮圖)、透過關鍵字或頻道代碼搜尋影片與頻道、建立與管理播放清單、以及擷取詳細分析資料(如訂閱人數、觀看次數與影片統計資料)。該技能強調使用前必須先呼叫 `RUBE_SEARCH_TOOLS` 以確保工具架構為最新版本,並透過 `RUBE_MANAGE_CONNECTIONS` 建立 YouTube 連線。它也涵蓋了 YouTube API 限額管理、ID 格式轉換(例如將頻道 ID 的 'UC' 轉換為 'UU' 以上傳播放清單)以及回應資料解析等重要注意事項。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/youtube-automation

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

透過 Rube MCP 自動化 YouTube

透過 Composio 的 YouTube 工具包,經由 Rube MCP 自動化 YouTube 操作。

先決條件

  • 必須連接 Rube MCP(RUBE_SEARCH_TOOLS 可用)
  • 透過 RUBE_MANAGE_CONNECTIONS 啟用 YouTube 連線,使用工具包 youtube
  • 務必先呼叫 RUBE_SEARCH_TOOLS 以取得最新的工具架構

設定

取得 Rube MCP:在客戶端設定中新增 https://rube.app/mcp 作為 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' 代表人物與網誌)
  • 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-50)
  • pageToken:用於分頁

注意陷阱:

  • 搜尋端點只回傳 'snippet' 部分;統計資料請使用 VIDEO_DETAILS
  • 搜尋結果總數上限為 500 筆
  • 搜尋的配額成本(100 單位)高於列表端點(1 單位)
  • BATCH 影片詳細資料的實際限制約為每次呼叫 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-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')

注意陷阱:

  • 頻道統計資料是累計總數,並非特定時段資料
  • BATCH 影片詳細資料可能會因私人或已刪除影片而回傳較少的項目
  • 回應資料可能巢狀於 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:每頁結果數
  • pageToken:分頁權杖

注意陷阱:

  • 訂閱已訂閱的頻道可能會回傳錯誤
  • 留言串會回傳頂層留言,每則最多包含 5 則回覆
  • 某些影片可能已停用留言功能
  • 取消訂閱需要訂閱 ID,而非頻道 ID

常見模式

頻道 ID 解析

代碼轉換為頻道 ID:

1. 使用 '@handle' 呼叫 YOUTUBE_GET_CHANNEL_ID_BY_HANDLE
2. 從回應中提取 channelId
3. 在後續的頻道操作中使用

上傳播放清單:

1. 取得頻道 ID(開頭為 'UC')
2. 將 'UC' 前綴取代為 'UU' 以取得上傳播放清單 ID
3. 使用 LIST_PLAYLIST_ITEMS 來列舉所有影片

分頁

  • 設定 maxResults(每頁最多 50 筆)
  • 檢查回應中是否有 nextPageToken
  • 在下一次請求中將權杖作為 pageToken 傳入
  • 持續進行直到 nextPageToken 不存在

批次影片詳細資料

  • 從搜尋或播放清單列表中收集影片 ID
  • 每約 50 個 ID 分為一組
  • 每組呼叫 GET_VIDEO_DETAILS_BATCH
  • 合併各組的結果

已知陷阱

配額管理:

  • YouTube API 有每日配額限制(預設 10,000 單位)
  • 上傳 = 1600 單位;搜尋 = 100 單位;列表 = 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
搜尋 YouTubeYOUTUBE_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 16 individual skills — each has its own dedicated page.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

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

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

Desesbraker/agentes-vip

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.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

相關技能