Back to Details

youtube-publisher

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

YouTube Publisher

YouTube Publisher

First time? If 
setup_complete: false
above, run 
./SETUP.md
first, then set 
setup_complete: true
.
Upload videos to YouTube with full metadata control.
首次使用？ 如果上方的
setup_complete: false
，请先运行
./SETUP.md
，然后将
setup_complete
设置为
true
。
上传视频至YouTube，可全面控制元数据。

Quick Start

快速开始

bash
cd ~/.claude/skills/youtube-publisher/scripts
bash
cd ~/.claude/skills/youtube-publisher/scripts

First time: authenticate

首次使用：进行身份验证

npx ts-node youtube-upload.ts --auth
npx ts-node youtube-upload.ts --auth

Upload video

上传视频

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
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

Upload as YouTube Short (vertical video)

上传为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
undefined
npx ts-node youtube-upload.ts
--video /path/to/short.mp4
--title "Quick Tip #Shorts"
--description "A quick tip for you!"
--privacy public
--short
undefined

Options

选项

OptionShortDescription
--video
-v
Video file path (required)
--title
-t
Video title (required)
--description
-d
Video description
--tags
Comma-separated tags
--privacy
-p
Privacy: public, unlisted, private (default: unlisted)
--category
-c
Category ID (default: 22 = People & Blogs)
--thumbnail
Custom thumbnail image (local path or URL)
--subtitles
Subtitle file path (SRT/VTT)
--subtitle-lang
Subtitle language code (default: zh)
--subtitle-name
Subtitle display name (default: 中文)
--playlist
Add to playlist ID
--short
Mark as YouTube Short
--auth
Run OAuth2 authentication flow
--dry-run
Preview without uploading
选项简写说明
--video
-v
视频文件路径（必填）
--title
-t
视频标题（必填）
--description
-d
视频描述
--tags
逗号分隔的标签
--privacy
-p
隐私设置：public（公开）、unlisted（不公开可分享）、private（私有）（默认：unlisted）
--category
-c
分类ID（默认：22 = 人物与博客）
--thumbnail
自定义缩略图（本地路径或URL）
--subtitles
字幕文件路径（SRT/VTT格式）
--subtitle-lang
字幕语言代码（默认：zh）
--subtitle-name
字幕显示名称（默认：中文）
--playlist
添加至播放列表ID
--short
标记为YouTube Short
--auth
运行OAuth2身份验证流程
--dry-run
预览上传内容，不实际上传

Category IDs

分类ID

IDCategory
1Film & Animation
2Autos & Vehicles
10Music
15Pets & Animals
17Sports
19Travel & Events
20Gaming
22People & Blogs
23Comedy
24Entertainment
25News & Politics
26Howto & Style
27Education
28Science & Technology
ID分类
1电影与动画
2汽车与交通工具
10音乐
15宠物与动物
17体育
19旅行与活动
20游戏
22人物与博客
23喜剧
24娱乐
25新闻与政治
26教程与风格
27教育
28科学与技术

Authentication

身份验证

First-time setup requires OAuth2 authentication:
  1. Run 
    npx ts-node youtube-upload.ts --auth
  2. Browser opens Google login
  3. Grant permissions to upload videos
  4. Token is saved to 
    .youtube-token.json
Token refreshes automatically. Re-run 
--auth
if expired.
首次设置需要OAuth2身份验证：
  1. 运行
    npx ts-node youtube-upload.ts --auth
  2. 浏览器将打开Google登录页面
  3. 授予视频上传权限
  4. 令牌将保存至
    .youtube-token.json
令牌会自动刷新。如果过期，请重新运行
--auth
。

Environment

环境配置

Create 
scripts/.env
:
env
YOUTUBE_CLIENT_ID=your_client_id
YOUTUBE_CLIENT_SECRET=your_client_secret
Get credentials from Google Cloud Console:
  1. Create project at console.cloud.google.com
  2. Enable YouTube Data API v3
  3. Create OAuth2 credentials (Desktop app)
  4. Download and extract client_id & client_secret
创建
scripts/.env
文件：
env
YOUTUBE_CLIENT_ID=your_client_id
YOUTUBE_CLIENT_SECRET=your_client_secret
从Google Cloud Console获取凭证：
  1. 在console.cloud.google.com创建项目
  2. 启用YouTube Data API v3
  3. 创建OAuth2凭证（桌面应用）
  4. 下载并提取client_id和client_secret

Examples

示例

Upload Tutorial Video

上传教程视频

bash
npx ts-node youtube-upload.ts \
  -v tutorial.mp4 \
  -t "How to Use Claude Code - Complete Guide" \
  -d "Learn everything about Claude Code in this comprehensive tutorial.

Timestamps:
00:00 Introduction
02:30 Getting Started
05:00 Advanced Features

#ClaudeCode #AI #Tutorial" \
  --tags "claude code,ai,tutorial,anthropic,coding" \
  --category 28 \
  --privacy public
bash
npx ts-node youtube-upload.ts \
  -v tutorial.mp4 \
  -t "How to Use Claude Code - Complete Guide" \
  -d "Learn everything about Claude Code in this comprehensive tutorial.

Timestamps:
00:00 Introduction
02:30 Getting Started
05:00 Advanced Features

#ClaudeCode #AI #Tutorial" \
  --tags "claude code,ai,tutorial,anthropic,coding" \
  --category 28 \
  --privacy public

Upload YouTube Short

上传YouTube Short

bash
npx ts-node youtube-upload.ts \
  -v short_video.mp4 \
  -t "Mind-blowing AI trick! #Shorts" \
  -d "This will change how you work! #AI #Tech" \
  --privacy public \
  --short
bash
npx ts-node youtube-upload.ts \
  -v short_video.mp4 \
  -t "Mind-blowing AI trick! #Shorts" \
  -d "This will change how you work! #AI #Tech" \
  --privacy public \
  --short

Upload to Playlist

上传至播放列表

bash
npx ts-node youtube-upload.ts \
  -v episode5.mp4 \
  -t "Podcast Episode 5" \
  --playlist PLxxxxxxxxxxxxxx \
  --privacy unlisted
bash
npx ts-node youtube-upload.ts \
  -v episode5.mp4 \
  -t "Podcast Episode 5" \
  --playlist PLxxxxxxxxxxxxxx \
  --privacy unlisted

Upload with Thumbnail and Subtitles

上传带缩略图和字幕的视频

bash
npx ts-node youtube-upload.ts \
  -v tutorial.mp4 \
  -t "Tutorial with Subtitles" \
  -d "Learn step by step with subtitles" \
  --thumbnail /path/to/cover.jpg \
  --subtitles /path/to/subtitles.srt \
  --subtitle-lang zh \
  --subtitle-name "中文" \
  --privacy public
bash
npx ts-node youtube-upload.ts \
  -v tutorial.mp4 \
  -t "Tutorial with Subtitles" \
  -d "Learn step by step with subtitles" \
  --thumbnail /path/to/cover.jpg \
  --subtitles /path/to/subtitles.srt \
  --subtitle-lang zh \
  --subtitle-name "中文" \
  --privacy public

Upload with Local Thumbnail

上传带本地缩略图的视频

bash
npx ts-node youtube-upload.ts \
  -v video.mp4 \
  -t "My Video Title" \
  --thumbnail "/Users/m/Downloads/shell/work/cover.jpg" \
  --privacy public
bash
npx ts-node youtube-upload.ts \
  -v video.mp4 \
  -t "My Video Title" \
  --thumbnail "/Users/m/Downloads/shell/work/cover.jpg" \
  --privacy public

Output

输出

On success, returns:
上传成功后，将返回：

Limitations

限制条件

  • Max file size: 256GB (YouTube limit)
  • Supported formats: MP4, MOV, AVI, WMV, FLV, 3GP, MPEG
  • Supported subtitle formats: SRT, VTT
  • Daily upload quota: 10,000 units (typically ~6 videos/day)
  • Title max: 100 characters
  • Description max: 5,000 characters
  • Tags max: 500 characters total
  • 最大文件大小：256GB（YouTube限制）
  • 支持格式：MP4、MOV、AVI、WMV、FLV、3GP、MPEG
  • 支持字幕格式：SRT、VTT
  • 每日上传配额：10,000单位（通常约6个视频/天）
  • 标题最大长度：100字符
  • 描述最大长度：5,000字符
  • 标签总长度上限：500字符