SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场youtube-automation

youtube-automation

营销与增长

查看项目

更新于 10-15 08:07

技能介绍

用途

YouTube Automation 用于通过 Rube MCP（基于 Composio 的 YouTube 工具集）自动化执行 YouTube 相关任务，包括上传视频、管理播放列表、搜索内容、获取分析数据和处理评论等。它适合需要将 YouTube 频道管理集成到 AI 客户端或自动化工作流中的用户。

前置条件

  • Rube MCP 必须已连接（可通过 RUBE_SEARCH_TOOLS 是否响应来验证）。
  • 需要通过 RUBE_MANAGE_CONNECTIONS 建立有效的 YouTube 连接，toolkit 为 youtube。
  • 在执行任何操作前，务必先调用 RUBE_SEARCH_TOOLS 获取当前的工具 schema。

设置方式

  1. 获取 Rube MCP：在客户端配置中添加 MCP 服务器 https://rube.app/mcp，无需 API 密钥，添加端点即可工作。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 设为 youtube。
  4. 如果连接状态不是 ACTIVE，请跟随返回的授权链接完成 Google OAuth。
  5. 确认连接状态为 ACTIVE 后再运行任何工作流。

主要能力与工作流

1. 上传与管理视频

适用场景：用户想上传视频或更新视频元数据。 工具序列：YOUTUBE_UPLOAD_VIDEO（上传新视频，必需）、YOUTUBE_UPDATE_VIDEO（更新标题、描述、标签、隐私设置，可选）、YOUTUBE_UPDATE_THUMBNAIL（设置自定义缩略图，可选）。 关键参数：title（标题，最多 100 字符）、description（描述，最多 5000 字节）、tags（关键词标签数组）、categoryId（YouTube 分类 ID，例如 '22' 表示 People & Blogs）、privacyStatus（'public'、'private' 或 'unlisted'）、videoFilePath（对象，含 {name, mimetype, s3key}）。 注意事项：上传消耗高配额，仅修改元数据时优先用 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 单位；批量视频详情每次调用实际限制约 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（逗号分隔的视频 ID 用于批量详情）、parts（资源部分，如 'snippet,statistics'）。 注意事项：频道统计为生命周期总量，非单期数据；批量视频详情对私享/已删除视频可能返回少于请求数量；响应数据可能嵌套在 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（评论线程的视频 ID）、maxResults（每页结果）、pageToken（分页令牌）。 注意事项：订阅已订阅的频道可能报错；评论线程返回顶层评论，每条最多含 5 条回复；部分视频可能禁用评论；取消订阅需要订阅 ID 而非频道 ID。

常见模式

频道 ID 解析：调用 YOUTUBE_GET_CHANNEL_ID_BY_HANDLE 传入 '@handle'，从响应中提取 channelId，再用于后续频道操作。 上传播放列表：获取频道 ID（以 'UC' 开头），将前缀 'UC' 替换为 'UU' 得到上传播放列表 ID，再配合 LIST_PLAYLIST_ITEMS 枚举所有视频。 分页：设置 maxResults（每页最多 50），检查响应中的 nextPageToken，在下次请求中作为 pageToken 传入，直到 nextPageToken 不存在。 批量视频详情：从搜索或播放列表收集视频 ID，每约 50 个 ID 分块，逐块调用 GET_VIDEO_DETAILS_BATCH，合并结果。

已知限制

配额管理：YouTube API 有每日配额限制（默认 10000 单位）；上传 = 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）；批量响应可能将数据包装在不同键下。

适用场景

  • 内容运营者批量上传、更新和管理频道视频。
  • 需要通过 AI 客户端或自动化脚本执行 YouTube 搜索、分析数据拉取。
  • 将 YouTube 频道管理集成到更广泛的 AI 工作流中。