yc-plugin
Claude Code 插件 — YouTube 創作者完整工作流。
影片 → /youtube-upload 上傳、/youtube-shorts 切 Shorts
標題 → /youtube-title 產影片標題（跨公式產候選 + CTR 計分 + 縮圖文案建議，YouTube 邏輯非部落格 SEO）
生命週期 → /youtube-list 列出、/youtube-stats 看流量、/youtube-update 改 metadata
連載 → /youtube-series 系列模板（標題格式 / 描述 / playlist 一次定義，每集自動套）
Credential → /youtube-setup OAuth 管理（init / export / import / reset）
附帶工具 → /screendoc 前端專案截圖手冊一條龍（Playwright 截圖 → 4 視角審查 → HTML 操作手冊，詳見下方）
為什麼用這個
不用打開 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：
裝好後重啟終端機。
安裝
/plugin marketplace add yanchen184/yc-plugin
/plugin install yc-plugin@yc-plugin
第一次跑會自動 pip install 必要的 Python 套件。完成。
第一次設定（一次性，~3 分鐘）
直接跑 /youtube-upload <影片>，Claude 會引導你拿 OAuth credential。或預先跟著做：
1. Google Cloud Console 開個 project
打開 Google Cloud Console → 左上角下拉選單 → NEW PROJECT → 任意名字 → CREATE
2. 啟用 YouTube Data API v3
左側 → APIs & Services → Library → 搜 YouTube Data API v3 → ENABLE
3. 設定 OAuth consent screen
左側 → 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，個人用足夠。
4. 建立 OAuth client
左側 → APIs & Services → Credentials → + CREATE CREDENTIALS → OAuth client ID
- Application type：選 Desktop app（很重要）
- Name：任意
- 點 CREATE → DOWNLOAD JSON
5. 把 JSON 給 Claude
/youtube-upload <影片路徑>
第一次會問 client_secret 在哪，貼上絕對路徑就好。
使用範例
最簡單
/youtube-upload D:/videos/ep1.mp4
Claude 會問你標題、隱私、描述、tags、封面、排程、播放清單。
在指令裡帶標題
/youtube-upload D:/videos/ep1.mp4 "EP1 校園愛情故事"
從命令列直接跑（不透過 Claude）
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-TW
只看會送什麼，不真上傳
python ... --file ep1.mp4 --title "test" --dry-run
完整 CLI flags
| 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)。常見其他：24 Entertainment、27 Education、10 Music、23 Comedy、26 Howto
系統架構
