Claude Code 插件 — YouTube 創作者完整工作流。
影片 →
/youtube-upload上傳、/youtube-shorts切 Shorts 生命週期 →/youtube-list列出、/youtube-stats看流量、/youtube-update改 metadata 連載 →/youtube-series系列模板（標題格式 / 描述 / playlist 一次定義，每集自動套） Credential →/youtube-setupOAuth 管理（init / export / import / reset）
不用打開 YouTube Studio 拖檔。一行指令，搞定：
- ✅ 影片 + 自定義 封面圖
- ✅ 排程發布（指定日期時間，YouTube 自動公開）
- ✅ 加到播放清單（給名字自動建立，或丟 playlist ID）
- ✅ 字幕自動偵測（同名
.srt/.vtt自動上傳） - ✅ 斷網續傳（resumable，6 次指數退避重試，不用整段重來）
- ✅ 發布後驗證（自動 polling YouTube 確認影片真的能播）
- ✅ 完整 dry-run（送出前看 JSON payload 確認）
- ✅ 連載系列模板（多集連載一次定義 + 自動跨集連結）
- ✅ 直式 Shorts 切片（從橫式長片抽 9:16 高潮片段）
- ✅ 流量回饋 / metadata 改寫（不重新上傳就能調整）
- ✅ 100% 用你自己的 Google 帳號 / 自己的 OAuth credential — 沒有共用授權、沒有第三方 server
- Python 3.10+ — plugin 用 Python 跑 OAuth 跟上傳邏輯
- Claude Code 已安裝且能執行 plugin
確認方式：
python3 --version # 要 >= 3.10如果沒裝 Python：
| OS | 安裝方式 |
|---|---|
| macOS | brew install python@3.12 |
| Ubuntu/Debian | sudo apt install python3 python3-pip |
| Fedora | sudo dnf install python3 python3-pip |
| Windows | https://www.python.org/downloads/ （勾選 "Add to PATH"） |
| 其他 | https://www.python.org/downloads/ |
裝好後重啟終端機。
/plugin marketplace add yanchen184/yc-plugin
/plugin install yc-plugin@yc-plugin
第一次跑會自動 pip install 必要的 Python 套件。完成。
直接跑 /youtube-upload <影片>，Claude 會引導你拿 OAuth credential。或預先跟著做：
打開 Google Cloud Console → 左上角下拉選單 → NEW PROJECT → 任意名字 → CREATE
左側 → APIs & Services → Library → 搜 YouTube Data API v3 → ENABLE
左側 → APIs & Services → OAuth consent screen → External → CREATE
填：
- App name：任意
- User support email：你的 Gmail
- Developer contact information：你的 Gmail
Test users 那頁加你自己的 Gmail 進去。
為什麼？你的 app 沒過 Google 驗證，預設只有 test user 能授權。每個 app 上限 100 個 test users，個人用足夠。
左側 → APIs & Services → Credentials → + CREATE CREDENTIALS → OAuth client ID
- Application type：選 Desktop app（很重要）
- Name：任意
- 點 CREATE → DOWNLOAD JSON
/youtube-upload <影片路徑>
第一次會問 client_secret 在哪，貼上絕對路徑就好。
/youtube-upload D:/videos/ep1.mp4
Claude 會問你標題、隱私、描述、tags、封面、排程、播放清單。
/youtube-upload D:/videos/ep1.mp4 "EP1 校園愛情故事"
python ~/.claude/plugins/cache/yc-plugin/yc-plugin/<version>/bin/youtube_upload.py \
--file ep1.mp4 \
--title "EP1 校園愛情故事" \
--description-file desc.txt \
--tags "校園,廣播劇,有聲故事" \
--thumbnail cover.jpg \
--playlist "WB故事空間" \
--publish-at "2026-05-10 20:00" \
--language zh-TWpython ... --file ep1.mp4 --title "test" --dry-run| Flag | 說明 |
|---|---|
--file PATH |
影片檔案（必填） |
--title T |
標題（預設用檔名） |
--description D |
短描述（直接傳） |
--description-file PATH |
從檔案讀描述（適合長文） |
--tags "a,b,c" |
逗號分隔 tags |
--privacy public/unlisted/private |
預設 unlisted，用 --publish-at 時自動變 private |
--category ID |
YouTube 分類 id（預設 22 = People & Blogs） |
--language zh-TW |
影片語言（預設 zh-TW） |
--thumbnail PATH |
封面圖 jpg/png ≤2MB（需驗證頻道） |
--playlist NAME_OR_ID |
播放清單名（自動建立）或 ID |
--publish-at "YYYY-MM-DD HH:MM" |
排程發布時間（本地時區） |
--caption PATH |
字幕檔（不指定會自動偵測同名 .srt / .vtt） |
--for-kids |
標記兒童內容 |
--no-auto-caption |
關閉自動字幕偵測 |
--no-verify-processing |
跳過上傳完的 status 確認 |
--dry-run |
只印 metadata，不真上傳 |
--verbose |
debug 訊息 |
Plugin 會自動：
- 字幕：同目錄找
<video>.srt或<video>.vtt，找到自動上傳（--no-auto-caption可關） - 章節：影片描述開頭如果有
00:00 開場這種行，YouTube 自動辨識成章節（不需 API） - 分類：預設
22(People & Blogs)。常見其他：24Entertainment、27Education、10Music、23Comedy、26Howto
Claude Code
│
/youtube-upload my.mp4
│
┌────────────────────────────┴────────────────────────────┐
│ │
▼ ▼
commands/youtube-upload.md ──────► bin/setup.py bin/youtube_upload.py
(對話流程定義) (1 次初始化) (主邏輯)
│ │
▼ ▼
~/.claude/plugins/data/yc-plugin/
├── client_secret.json (你的 OAuth)
├── yt_token.json (refresh token)
└── log.txt (所有上傳紀錄)
│
▼
YouTube Data API v3
(videos / thumbnails /
captions / playlists)
- ✅ 此 repo 完全不含 secret — credential / token 全在你電腦的
~/.claude/plugins/data/yc-plugin/ - ✅ 每個用戶各自的 OAuth client — 互不影響、quota 各自承擔
- ✅ 沒有第三方 server — 直接打 Google API
⚠️ 如果 credential 不小心外洩：去 credentials 頁面 刪掉重建即可
整個 ~/.claude/plugins/data/yc-plugin/ 搬過去就好。或用 /youtube-setup：
# 舊電腦
/youtube-setup export ~/Desktop/creds.zip
# 新電腦（裝完 plugin 後）
/youtube-setup import ~/Downloads/creds.zip
例如你給剪輯師處理影片，最後要上你的頻道：
# 你
/youtube-setup export ~/Desktop/wb_creds.zip
# 用安全管道（Signal / 1Password 共享）把 zip 給夥伴
# 夥伴（裝完 plugin 後）
/youtube-setup import ~/Downloads/wb_creds.zip
# 接下來他跑 /youtube-upload，影片會上你的頻道，不需要瀏覽器登入
creds.zip內含你 YouTube 頻道的「完整鑰匙」- 持有這個 zip 的人可以上傳、刪除、修改你頻道任何影片
- 90 天內 refresh_token 都有效
- 不要用 email、Slack、Discord、雲端硬碟分享 — 用 end-to-end 加密（Signal / iMessage / 1Password Secure Sharing）
- 信任崩盤就去 https://myaccount.google.com/permissions 撤銷該 OAuth client，所有人手上的 token 立即失效
不行。OAuth credential 是綁你 Google 帳號 + 你建的 OAuth client。別的頻道要用別的 credential。
點 Advanced → Go to <你的 app> (unsafe) 繼續就好。是你自己的 app，「unsafe」只是 Google 的標準警告，個人用不需要驗證。
自動續傳（resumable upload）。最多重試 6 次，間隔 2/4/8/16/32/64 秒。撐不過去會印錯誤；網路恢復後重跑同一指令即可。
你沒把自己加到 OAuth consent screen 的 Test users。回 Step 3 加。
腳本自動偵測 refresh 失敗 → 刪舊 token → 重跑 OAuth flow。瀏覽器會再跳一次，不用手動。
YouTube Data API 預設每天 10000 quota units，每次上傳 ~1600。所以 ~6 部/天。 要更多去 Quotas 頁面 申請增加。
需要驗證頻道才能用自定義縮圖。去 https://www.youtube.com/verify 用手機驗證。
--publish-at "2026-05-10 20:00"（本地時區）。隱私會自動變 private，到時間 YouTube 自動轉 public。
給名字就好，不存在會自動建立。已存在會用同名清單。 要精確指定也可以給 playlist ID（PL... 開頭、20+ 字元）。
影片旁邊放同名 .srt 或 .vtt（例如 ep1.mp4 + ep1.srt），就會自動上。
不想自動：加 --no-auto-caption。
~/.claude/plugins/data/yc-plugin/log.txt，每次上傳都會 append。
python ~/.claude/plugins/cache/yc-plugin/.../bin/setup.py --resetyc-plugin/
├── .claude-plugin/
│ ├── plugin.json
│ └── marketplace.json
├── commands/youtube-upload.md # /youtube-upload 命令定義
├── hooks/hooks.json # SessionStart hook (auto pip install)
├── bin/
│ ├── lib/
│ │ ├── paths.py # plugin data dir / token / log paths
│ │ ├── console.py # info/warn/err with file logging
│ │ └── youtube_client.py # OAuth + upload helpers
│ ├── youtube_upload.py # 主上傳腳本
│ ├── setup.py # 第一次設定
│ ├── youtube_auth.py # 獨立 OAuth bootstrap
│ └── install_deps.py # 自動 pip install
├── requirements.txt
├── README.md (你正在看的)
├── CHANGELOG.md
├── CONTRIBUTING.md
├── NAMING.md
└── LICENSE
MIT — 自由使用、修改、分享。
歡迎 issue / PR！詳見 CONTRIBUTING.md。
這個 plugin 的誕生：原本只是想幫自己自動化上傳廣播劇的流程，做著做著想到「不如分享出來」，於是有了 yc-plugin。如果你也想做類似的工具，歡迎交流。