Communitygithub.com

AlperTuncOrtak/crypto-data-pipeline

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

crypto-data-pipeline 是什麼?

這項技能讓 AI 代理能夠透過 Composio 的 YouTube 工具組與 Rube MCP 無縫整合,自動執行全方位的 YouTube 操作。主要功能包括上傳與管理影片、搜尋內容、建立與管理播放清單、獲取頻道與影片分析資料,以及管理訂閱和留言。它支援在任何可整合 Rube MCP 的平台上執行(如 Claude Code、Cursor、Codex 等),並嚴格遵循標準化流程:首先呼叫 `RUBE_SEARCH_TOOLS` 取得最新工具架構,然後透過 `RUBE_MANAGE_CONNECTIONS` 建立 YouTube 連線(需完成 Google OAuth 驗證)。本技能強調配額管理的最佳實踐,例如優先使用列表端點而非高成本的搜尋和上傳端點,並詳細說明常見陷阱,例如 ID 格式轉換(頻道 ID 'UC' 轉為上傳播放清單 ID 'UU')、分頁處理、批次處理及回應解析的注意事項。它非常適合需要自動化重複性 YouTube 工作流程的開發者與內容創作者,並提供清晰的工具序列與參數指南。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlperTuncOrtak/crypto-data-pipeline/tree/HEAD/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. 呼叫 RUBE_MANAGE_CONNECTIONS 並指定工具組 youtube
  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:搜尋查詢(支援精確短語、排除條件、頻道 handle)
  • 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 - 將 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('@handle')或 'me'
  • forHandle:頻道 handle(例如 '@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 解析

Handle 轉換為頻道 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
透過 handle 取得頻道 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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

Best practices for Remotion - Video creation in React

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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.

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

AlperTuncOrtak/crypto-data-pipeline

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

相關技能