azuma520/youtube-to-notebooklm/yt-search

yt-search

YouTube 影片搜尋、元數據查詢、字幕下載。依賴 yt-dlp（pip install yt-dlp）。

搜尋影片

yt-dlp --flat-playlist "ytsearchN:關鍵字" -j

N = 結果數（預設 10，建議最多 20）。每行一個 JSON，取 title、channel、duration_string、view_count、url、id。

呈現為表格讓用戶挑選（按觀看數排序）：

# | 標題 | 頻道 | 時長 | 觀看數 | URL
1 | How to Make... | FoodBiz | 12:34 | 45K | https://youtube.com/watch?v=xxx

按上傳日期搜尋（找最新內容）：用 ytsearchdateN: 取代 ytsearchN:。

過濾搜尋結果：用 --match-filters 在搜尋層直接篩選，比下載後再過濾高效：

# 排除短影片（< 1 分鐘）和直播
yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "duration>60 & !is_live"
 
# 只要高人氣影片
yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "view_count>?1000"

用戶挑選後可進一步：取元數據、抓字幕、或推送到 NotebookLM（搭配 anything-to-notebooklm skill）。

取得影片元數據

yt-dlp -j "URL"

除基本欄位外，channel_follower_count 可評估頻道規模，like_count / comment_count 可評估內容互動度。

下載字幕

先確認可用字幕（避免下載失敗）：

yt-dlp --list-subs "URL" 2>&1 | head -30

確認有字幕後再下載。--sub-langs 支援正則，可抓所有語言變體：

# 抓中文（含 zh-TW, zh-Hans 等）和英文（含 en-US 等）
yt-dlp --skip-download --write-auto-subs --sub-langs "zh.*,en.*" --sub-format vtt -o "$TEMP/%(id)s" "URL"

也可同時抓手動字幕（品質更好）和自動字幕：

yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "zh.*,en.*" --sub-format vtt -o "$TEMP/%(id)s" "URL"

手動字幕（--write-subs）品質優於自動字幕（--write-auto-subs），有手動的優先用。

輸出 VTT 檔，用內建腳本轉純文字：

python <skill-path>/scripts/parse_vtt.py "$TEMP/VIDEO_ID.en.vtt" -o "$TEMP/transcript.txt"

如果 --list-subs 顯示無字幕，告知用戶該影片沒有可用字幕。

年齡限制 / 會員內容

遇到年齡限制或需要登入才能觀看的影片，可從瀏覽器提取 Cookie：

yt-dlp --cookies-from-browser chrome -j "URL"

支援 chrome、firefox、edge、brave 等瀏覽器。先詢問用戶慣用的瀏覽器。

與 anything-to-notebooklm 的銜接

用戶常見流程：搜影片 → 選一部 → 推 NotebookLM。選定影片後，記住 URL，直接傳給 anything-to-notebooklm skill 使用（YouTube URL 可直接 source add，不需要先抓字幕）。

如果用戶想看逐字稿再決定是否推送，先抓字幕讓用戶確認內容。

注意事項

• Windows 中文輸出亂碼 → 指令前加 PYTHONUTF8=1
• 搜尋結果受地區影響 → 可加 --geo-bypass
• 長影片字幕檔很大 → 先確認 duration 再決定是否下載
• 批量操作加 --sleep-requests 1 避免被 YouTube 限流
• 用完字幕後清理暫存：rm "$TEMP"/VIDEO_ID.*.vtt