AgentSkillsCN

youtube-uploader

为 YouTube 视频添加标题、描述与标签后上传。适用于：YouTube 上传、发布视频、在 YouTube 上分享。

SKILL.md
--- frontmatter
name: youtube-uploader
description: "Upload videos to YouTube with title, description, tags. Use for: youtube upload, publish video, share on youtube."
setup_complete: false
setup: "./SETUP.md"

YouTube Uploader

First time? If setup_complete: false above, run ./SETUP.md first, then set setup_complete: true.

Upload videos to YouTube with full metadata control.

Quick Start

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

# First time: authenticate
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

# Upload as YouTube Short (vertical video)
npx ts-node youtube-upload.ts \
  --video /path/to/short.mp4 \
  --title "Quick Tip #Shorts" \
  --description "A quick tip for you!" \
  --privacy public \
  --short

Options

OptionShortDescription
--video-vVideo file path (required)
--title-tVideo title (required)
--description-dVideo description
--tagsComma-separated tags
--privacy-pPrivacy: public, unlisted, private (default: unlisted)
--category-cCategory ID (default: 22 = People & Blogs)
--thumbnailCustom thumbnail image path
--playlistAdd to playlist ID
--shortMark as YouTube Short
--authRun OAuth2 authentication flow
--dry-runPreview without uploading

Category IDs

IDCategory
1Film & Animation
2Autos & Vehicles
10Music
15Pets & Animals
17Sports
19Travel & Events
20Gaming
22People & Blogs
23Comedy
24Entertainment
25News & Politics
26Howto & Style
27Education
28Science & Technology

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.

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

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

Upload 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

Upload to Playlist

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

Output

On success, returns:

Limitations

  • •Max file size: 256GB (YouTube limit)
  • •Supported formats: MP4, MOV, AVI, WMV, FLV, 3GP, MPEG
  • •Daily upload quota: 10,000 units (typically ~6 videos/day)
  • •Title max: 100 characters
  • •Description max: 5,000 characters
  • •Tags max: 500 characters total