---

name: youtube-automation description: "通过 Rube MCP (Composio) 自动化 YouTube 任务：上传视频、管理播放列表、搜索内容、获取分析数据和处理评论。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 YouTube 自动化

通过 Composio 的 YouTube 工具包经由 Rube MCP 自动化 YouTube 操作。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit youtube 建立活跃的 YouTube 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema

设置

获取 Rube MCP：在你的客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应来验证 Rube MCP 可用
2. 使用 toolkit 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 单位）vs 列表端点（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 不是 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'）

注意事项：

• 频道统计数据是累计总量，不是按时间段的
• 批量视频详情可能因私有/已删除视频返回比请求更少的项目
• 响应数据可能嵌套在 data 或 data_prev 下