Communitygithub.com

ASoudy/AGS

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

AGS 是什么?

该技能通过 Rube MCP 集成 Composio 的 YouTube 工具包,实现 YouTube 操作的自动化。它涵盖了视频上传与元数据更新、YouTube 内容搜索、播放列表管理、频道与视频分析、以及订阅与评论管理五大核心工作流。每个工作流都提供了清晰的工具调用顺序、关键参数说明及常见陷阱提示,帮助开发者高效、安全地使用 YouTube API。技能支持在客户端配置中添加 Rube MCP 端点(https://rube.app/mcp),无需 API 密钥,仅需通过 OAuth 连接 YouTube 账户。特别强调配额管理(上传约 1600 单位、搜索 100 单位、列表仅 1 单位)和 ID 格式(视频 ID 11 字符、频道 ID 以 UC 开头、播放列表 ID 以 PL 或 UU 开头),以优化 API 使用成本并避免错误。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/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. 调用 RUBE_MANAGE_CONNECTIONS,工具包设为 youtube
  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 单位
  • 批量视频详情每次调用实际限制约为 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_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
  • 将 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 20 individual skills — each has its own dedicated page.

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

相关技能