用途
youtube-uploader 是一个命令行技能，用于将本地视频文件上传到 YouTube，并在上传时对视频的元数据进行完整控制。它适合需要以脚本或自动化方式发布视频的开发者、内容创作者和 AI 工作流使用者。
主要能力
- 上传视频文件到 YouTube，可指定标题与描述。
- 设置以逗号分隔的标签（tags）。
- 设置隐私状态：public、unlisted、private，默认 unlisted。
- 设置视频分类 ID（默认 22，即 People & Blogs）。
- 设置自定义缩略图（--thumbnail）。
- 将视频加入指定播放列表（--playlist）。
- 标记为 YouTube Short（--short），用于竖屏短视频。
- 通过 --dry-run 在不实际上传的情况下预览。
- 通过 --auth 运行 OAuth2 认证流程。
使用方式
首次使用前，先运行 ./SETUP.md 中说明的步骤，并将 setup_complete 设为 true。核心命令在技能脚本目录下执行：
cd ~/.claude/skills/youtube-uploader/scripts
首次认证： npx ts-node youtube-upload.ts --auth
上传视频示例：
npx ts-node youtube-upload.ts
--video /path/to/video.mp4
--title "My Awesome Video"
--description "Check out this amazing content!"
--tags "tech,ai,tutorial"
--privacy unlisted
上传为 YouTube Short 示例：
npx ts-node youtube-upload.ts
--video /path/to/short.mp4
--title "Quick Tip #Shorts"
--description "A quick tip for you!"
--privacy public
--short
参数说明：
- --video / -v：视频文件路径，必填。
- --title / -t：视频标题，必填。
- --description / -d：视频描述。
- --tags：逗号分隔的标签。
- --privacy / -p：public、unlisted、private，默认 unlisted。
- --category / -c：分类 ID，默认 22（People & Blogs）。
- --thumbnail：自定义缩略图路径。
- --playlist：要加入的播放列表 ID。
- --short：标记为 YouTube Short。
- --auth：运行 OAuth2 认证流程。
- --dry-run：预览而不上传。
认证
首次设置需要 OAuth2 认证：
- 运行 npx ts-node youtube-upload.ts --auth
- 浏览器打开 Google 登录
- 授予上传视频权限
- 令牌保存至 .youtube-token.json 令牌会自动刷新，过期时可重新运行 --auth。
需要在 scripts/.env 中配置： YOUTUBE_CLIENT_ID=your_client_id YOUTUBE_CLIENT_SECRET=your_client_secret
凭证获取方式：在 console.cloud.google.com 创建项目，启用 YouTube Data API v3，创建 OAuth2 凭证（Desktop app），下载并提取 client_id 与 client_secret。
分类 ID
1 Film & Animation；2 Autos & Vehicles；10 Music；15 Pets & Animals；17 Sports；19 Travel & Events；20 Gaming；22 People & Blogs；23 Comedy；24 Entertainment；25 News & Politics；26 Howto & Style；27 Education；28 Science & Technology。
输出
成功后返回视频 ID、视频 URL（https://youtu.be/VIDEO_ID）和状态。
适用场景
- 通过脚本批量或自动化发布视频。
- 发布教学视频、播客、短片等内容。
- 将视频加入播放列表或标记为 Short。
- 在 AI 智能体工作流中作为上传视频的工具使用。
限制
- 最大文件大小：256GB（YouTube 限制）。
- 支持格式：MP4、MOV、AVI、WMV、FLV、3GP、MPEG。
- 每日上传配额：10,000 单位（通常约 6 个视频/天）。
- 标题最长 100 字符。
- 描述最长 5,000 字符。
- 标签总计最长 500 字符。
- 具体价格、收费信息暂未提供。