Communitygithub.com

AlperTuncOrtak/crypto-data-pipeline

通过 Rube MCP(Composio)自动化 YouTube 任务:上传视频、管理播放列表、搜索内容、获取分析数据以及处理评论。始终先搜索工具以获取当前架构。

crypto-data-pipeline 是什么?

该技能通过 Composio 的 YouTube 工具包和 Rube MCP 实现 YouTube 操作的全面自动化。它支持包括视频上传和管理、内容搜索、播放列表创建与维护、频道与视频分析、订阅管理以及评论处理在内的多种工作流。该技能强调在运行任何工作流之前,必须先通过 RUBE_SEARCH_TOOLS 获取当前工具架构,并确保 YouTube 连接处于 ACTIVE 状态。它还详细列出了关键参数和常见陷阱,例如配额管理(上传消耗 1600 单位,搜索消耗 100 单位)、ID 格式(视频 ID 为 11 位字符,频道 ID 以 'UC' 开头)、分页处理以及响应解析注意事项。该技能适用于 Claude Code、Cursor、Codex 等支持 MCP 的 AI 代理平台,为开发者提供了一种高效、结构化的方式来与 YouTube API 交互,最大限度地减少错误并优化配额使用。

兼容平台~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. 使用工具包 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 单位
  • 批量视频详情的实际限制约为每次调用 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 不是视频 ID;请使用 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:每页结果数
  • 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 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

相关技能