wjs-uploading-video

When to use

• User has one or more finished

  .mp4

  files and wants them on YouTube
• User points to a

  final/

  directory with multiple segments and an

  UPLOAD_META.md

• User wants a specific privacy / playlist / scheduled publish

• 微信视频号 upload (no public API; user uploads manually via web)
• 抖音 / 小红书 / B 站 (different APIs, not yet implemented here)
• YouTube Shorts variants from horizontal source (use

  wjs-reframing-video

  first to produce the 9:16 cut, then upload that via this skill)

Prerequisites (one-time per machine)

1. Google Cloud OAuth client:

   ~/.config/youtube/credentials.json

   must exist. See

   references/credentials-setup.md

   for the 5-minute setup if missing.
2. Python deps:

   pip3 install google-auth-oauthlib google-api-python-client requests

   (only

   google-auth

   +

   requests

   are strictly needed at upload time, but the OAuth-lib pulls them).
3. First-ever upload opens a browser for Google consent and writes

   ~/.config/youtube/token.json

   . Subsequent runs reuse it silently.

How it works (and why it's not the stock youtube-uploader)

Location:

PUT

google-api-python-client

httplib2

[Errno 65] No route to host

socket.timeout

httplib2

google-auth

requests

socket.timeout

ConnectionError

Usage

Batch upload a

final/

directory

python3 ~/.claude/skills/wjs-uploading-video/scripts/upload_youtube.py \
  --dir "/path/to/final" \
  --meta "/path/to/final/UPLOAD_META.md"

1. Reads

   UPLOAD_META.md

   and pairs each

   ## NN · filename.mp4

   block to a video file in

   --dir

2. Skips videos already in

   --results-file

   (default

   <dir>/.youtube_upload_results.json

   ) — safe to re-run after failures
3. Uploads sequentially with progress every 8 MB
4. Writes the final URL list to

   --results-file

Single file

python3 ~/.claude/skills/wjs-uploading-video/scripts/upload_youtube.py \
  --video /path/to/clip.mp4 \
  --title "My Title" \
  --description "Body text" \
  --tags "tag1,tag2,tag3"

Common overrides

--privacy

public

private

unlisted

public

--category

28

--made-for-kids

false

--playlist <ID>

--publish-at <ISO8601>

--privacy private

--credentials

~/.config/youtube/credentials.json

--token

~/.config/youtube/token.json

--chunk-mb

8

--dry-run

UPLOAD_META.md format

## 01 · segment_01_no-bugs.mp4

**短标题**
代码没有错误,只有意图不一致

**视频描述**
AI 时代屎山的重新定义...

—— 王建硕 × 任鑫《...》第 1 集

#王建硕 #AI编程 #ClaudeCode

---

• ## NN · <filename>

  → which video this block describes

• **短标题**

  (or

  **Title**

  ) block → YouTube title, verbatim. Short titles work but consider that YouTube allows up to 100 chars — if you want a richer title with series name, write it that way in

  **短标题**

• **视频描述**

  (or

  **Description**

  ) block → YouTube description, verbatim, with the

  #tag

  hashtags retained at the bottom
• All

  #word

  tokens in the 视频描述 → comma-separated YouTube tags (each

  #

  is stripped; the user's channel name

  王建硕

  is auto-prepended per global instructions)

--dir

--allow-missing-meta

--title <basename>

Sensible defaults this skill bakes in

• Privacy = public: videos go live immediately and appear in subscriber feeds + search. Override per call with

  --privacy unlisted

  (link-only) or

  --privacy private

  (owner-only) when you want to review first
• Category = 28 (Science & Tech): matches 王建硕 channel's main content; override with

  --category

  per upload
• selfDeclaredMadeForKids = false: YouTube requires this; the user's content is adult-targeted
• Chunk size = 8 MB: validated working size through this user's local proxy (256 KB stalled)
• Skip already-uploaded: results file is the source of truth; deleting it forces re-upload

Channel-name CTA rule

Troubleshooting

access_denied 403

[Errno 65] No route to host

curl --max-time 10 https://upload.googleapis.com/upload/youtube/v3/videos

000

--chunk-mb 4

quotaExceeded

~/.config/youtube/token.json

After uploading

• Results saved to

  --results-file

  (JSON: file, title, video id, URL)
• Echo the URL list back to the user in a markdown table
• Videos are

  public

  by default — they're live the moment the upload completes. If the user wanted a review buffer, mention they can re-upload with

  --privacy unlisted

  (or flip back to unlisted in YouTube Studio)
• If they mentioned a 合集 / series, offer to create a YouTube playlist and batch-add the new uploads (the user must give a playlist ID or let you create one)