Communitygithub.com

benjaminasterA/antigravity-awesome-skills

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

antigravity-awesome-skills 是什么?

该技能使 AI 代理能够通过 Composio 的 YouTube 工具集(经由 Rube MCP)直接实现 YouTube 操作自动化。它涵盖了一系列核心工作流,包括视频上传与元数据更新、内容搜索、播放列表管理、频道与视频数据分析、订阅管理以及评论互动。技能强调整合前必须进行工具搜索(RUBE_SEARCH_TOOLS)以获取最新架构,并需要有效的 YouTube 连接(通过 RUBE_MANAGE_CONNECTIONS 进行 OAuth 认证)。详细文档包括了关键参数、配额管理注意事项(例如上传消耗 1600 单位、搜索消耗 100 单位以及列表端点消耗 1 单位)、ID 格式规范以及响应解析策略。对于需要自动化 YouTube 内容管理或分析的开发者,本技能提供了配置指南、常见模式(如频道 ID 解析和分页)以及避免常见陷阱的提醒。它主要适用于 Claude Code、Cursor 或 Codex 等 Rube MCP 支持的 AI 代理平台。

兼容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/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 单位)
  • 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 单位;列表 = 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 4 individual skills — each has its own dedicated page.

相关技能