Communitygithub.com

BEKO2210/Firstbrain

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

Firstbrain 是什么?

该技能通过Composio的YouTube工具包和Rube MCP集成,实现了YouTube操作的全面自动化。它支持视频上传与管理、内容搜索、播放列表创建与维护、频道和视频分析、以及订阅和评论管理。使用时需先连接Rube MCP,建立YouTube连接(通过Google OAuth认证),并始终调用`RUBE_SEARCH_TOOLS`获取最新工具模式以避免API变更问题。该技能特别注重配额管理,提示用户优先使用开销较小的列表接口(1单元)而非搜索(100单元)或上传(1600单元),并详细说明了各种ID格式(视频、频道、播放列表)的转换规则和常见陷阱,例如播放列表ID中“UC”前缀需替换为“UU”。支持平台主要为Claude Code等兼容MCP协议的AI Agent环境。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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. 调用 YOUTUBE_GET_CHANNEL_ID_BY_HANDLE,传入 '@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)
  • 批量响应可能将数据包装在不同的键下

快速参考

任务工具 Slug关键参数
上传视频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 18 individual skills — each has its own dedicated page.

BEKO2210/Firstbrain

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

BEKO2210/Firstbrain

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

BEKO2210/Firstbrain

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks

相关技能