通过 Rube MCP 实现 YouTube 自动化
选择性阅读规则
从以下文件开始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然后仅加载与用户实际任务匹配的继承文档、脚本、资产或示例。
通过 Rube MCP 使用 Composio 的 YouTube 工具包自动化 YouTube 操作。
前提条件
- 必须连接 Rube MCP(
RUBE_SEARCH_TOOLS可用) - 通过
RUBE_MANAGE_CONNECTIONS使用工具包youtube建立活跃的 YouTube 连接 - 始终先调用
RUBE_SEARCH_TOOLS以获取当前工具架构
设置
获取 Rube MCP:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器。无需 API 密钥——只需添加端点即可工作。
- 确认
RUBE_SEARCH_TOOLS有响应,以验证 Rube MCP 可用 - 使用工具包
youtube调用RUBE_MANAGE_CONNECTIONS - 如果连接未处于 ACTIVE 状态,请按照返回的认证链接完成 Google OAuth
- 在运行任何工作流之前确认连接状态显示为 ACTIVE
核心工作流
1. 上传和管理视频
适用场景:用户想要上传视频或更新视频元数据
工具顺序:
YOUTUBE_UPLOAD_VIDEO- 上传新视频 [必需]YOUTUBE_UPDATE_VIDEO- 更新标题、描述、标签、隐私设置 [可选]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 内容
适用场景:用户想要查找视频、频道或播放列表
工具顺序:
YOUTUBE_SEARCH_YOU_TUBE- 搜索内容 [必需]YOUTUBE_VIDEO_DETAILS- 获取特定视频的详细信息 [可选]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 批量获取多个视频的详细信息 [可选]
关键参数:
q:搜索查询(支持精确短语、排除项、频道句柄)type:'video'、'channel' 或 'playlist'maxResults:每页结果数(1-50)pageToken:用于分页
陷阱:
- 搜索端点仅返回 'snippet' 部分;使用 VIDEO_DETAILS 获取统计数据
- 搜索结果总数上限为 500 项
- 搜索的配额成本(100 单位)高于列表端点(1 单位)
- BATCH 视频详细信息每次调用实用限制约 50 个 ID;对于更大集合需分块处理
3. 管理播放列表
适用场景:用户想要创建播放列表或管理播放列表内容
工具顺序:
YOUTUBE_LIST_USER_PLAYLISTS- 列出用户现有的播放列表 [可选]YOUTUBE_CREATE_PLAYLIST- 创建新播放列表 [可选]YOUTUBE_ADD_VIDEO_TO_PLAYLIST- 将视频添加到播放列表 [可选]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. 获取频道和视频分析数据
适用场景:用户想要分析频道表现或视频指标
工具顺序:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE- 将句柄解析为频道 ID [前提条件]YOUTUBE_GET_CHANNEL_STATISTICS- 获取频道的订阅者/观看/视频计数 [必需]YOUTUBE_LIST_CHANNEL_VIDEOS- 列出频道中的所有视频 [可选]YOUTUBE_GET_VIDEO_DETAILS_BATCH- 获取每个视频的统计数据 [可选]YOUTUBE_GET_CHANNEL_ACTIVITIES- 获取近期频道活动 [可选]
关键参数:
channelId:频道 ID('UC...')、句柄('@handle')或 'me'forHandle:频道句柄(例如 '@Google')id:用于批量详情的逗号分隔的视频 IDparts:要包含的资源部分(例如 'snippet,statistics')
陷阱:
- 频道统计数据是终身累计值,而非周期值
- BATCH 视频详情可能返回少于请求的项目(针对私有或已删除视频)
- 响应数据可能嵌套在
data或data_preview下;需做防御性解析 - contentDetails.duration 使用 ISO 8601 格式(例如 'PT4M13S')
5. 管理订阅和评论
适用场景:用户想要订阅频道或查看视频评论
工具顺序:
YOUTUBE_SUBSCRIBE_CHANNEL- 订阅频道 [可选]YOUTUBE_UNSUBSCRIBE_CHANNEL- 取消订阅频道 [可选]YOUTUBE_LIST_USER_SUBSCRIPTIONS- 列出订阅列表 [可选]YOUTUBE_LIST_COMMENT_THREADS- 列出视频评论 [可选]
关键参数:
channelId:要订阅/取消订阅的频道videoId:评论线程的视频 IDmaxResults:每页结果数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_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |
| 更新视频 | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |
| 设置缩略图 | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |
| 搜索 YouTube | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |
| 视频详情 | YOUTUBE_VIDEO_DETAILS | id, part |
| 批量视频详情 | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |
| 列出播放列表 | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |
| 创建播放列表 | YOUTUBE_CREATE_PLAYLIST | (检查架构) |
| 添加到播放列表 | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (检查架构) |
| 列出播放列表项 | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |
| 频道统计数据 | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |
| 列出频道视频 | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |
| 通过句柄获取频道 ID | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |
| 订阅 | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |
| 列出订阅 | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (检查架构) |
| 列出评论 | YOUTUBE_LIST_COMMENT_THREADS | videoId |
| 频道活动 | YOUTUBE_GET_CHANNEL_ACTIVITIES | (检查架构) |
适用场景
此技能适用于执行概述中描述的工作流或操作。
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为针对特定环境的验证、测试或专家评审的替代方案。
- 如果缺少必需的输入、权限、安全边界或成功标准,请停下并请求澄清。