Communitygithub.com

ASoudy/AGS

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

AGS 是什麼?

此技能透過 Composio 的 YouTube 工具組與 Rube MCP,讓 AI 代理能夠全面自動化 YouTube 操作。它提供預先定義的工作流程,用於上傳和更新影片、管理播放清單、搜尋內容、取得頻道與影片分析資料,以及管理訂閱和留言。開發者可以透過此技能,以程式化方式處理耗時的重複性任務,例如批次更新中繼資料、分析頻道成效,或組織大型播放清單。 該技能強制要求在執行任何動作之前,必須先呼叫 `RUBE_SEARCH_TOOLS` 以確保使用最新的工具綱要,這是一項重要的實務做法。它整合了 Rube MCP 的連線管理,讓使用者可以透過 Google OAuth 驗證其 YouTube 帳戶。技能文件中詳細記錄了每個工作流程的關鍵陷阱,例如配額管理(上傳花費 1600 單位,搜尋花費 100 單位)、ID 格式(例如,將頻道 ID 中的 'UC' 轉換為 'UU' 以取得上傳播放清單)以及回應剖析(統計資料值為字串,非整數)。它也會引導使用者在處理大型資料集時進行分頁和批次處理。 此技能支援的平台包括 Composio 和 Rube MCP,因此適用於任何與 MCP(模型內容協定)相容的 AI 代理,例如 Claude Code、Cursor 或 Codex。其主要價值在於將 YouTube API 互動封裝在結構化、可重複執行的工作流程中,減少手動開發和除錯的需求。

相容平台~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 中提問

開啟一個已預先載入此 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 單位)高於 list 端點(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
  • 將 ID 分組為約 50 個一批的區塊
  • 對每個區塊呼叫 GET_VIDEO_DETAILS_BATCH
  • 合併所有區塊的結果

已知陷阱

配額管理:

  • YouTube API 有每日配額限制(預設 10,000 單位)
  • 上傳 = 1600 單位;搜尋 = 100 單位;list = 1 單位
  • 可能的話,優先使用 list 端點而非搜尋
  • 監控配額使用量,避免達到每日限制

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 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.

相關技能