yt-search

Name: yt-search
Author: azuma520

37stars7forks

How to install yt-search?

azuma520/youtube-to-notebooklm/yt-search

$npx -y skills add azuma520/youtube-to-notebooklm --skill yt-search

Installs into the current project.

Summary

Search YouTube videos, get video metadata, and download subtitles/transcripts using yt-dlp. Use when the user wants to find videos, search YouTube, look up a YouTube channel, get video info, download captions, grab subtitles, or extract a transcript. Triggers include "找影片", "搜影片"

Files · 1

View on GitHub

SKILL.md

1	# yt-search
2
3	YouTube 影片搜尋、元數據查詢、字幕下載。依賴 `yt-dlp`（`pip install yt-dlp`）。
4
5	## 搜尋影片
6
7	```bash
8	yt-dlp --flat-playlist "ytsearchN:關鍵字" -j
9	```
10
11	`N` = 結果數（預設 10，建議最多 20）。每行一個 JSON，取 `title`、`channel`、`duration_string`、`view_count`、`url`、`id`。
12
13	呈現為表格讓用戶挑選（按觀看數排序）：
14
15	```
16	# \| 標題 \| 頻道 \| 時長 \| 觀看數 \| URL
17	1 \| How to Make... \| FoodBiz \| 12:34 \| 45K \| https://youtube.com/watch?v=xxx
18	```
19
20	按上傳日期搜尋（找最新內容）：用 `ytsearchdateN:` 取代 `ytsearchN:`。
21
22	過濾搜尋結果：用 `--match-filters` 在搜尋層直接篩選，比下載後再過濾高效：
23
24	```bash
25	# 排除短影片（< 1 分鐘）和直播
26	yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "duration>60 & !is_live"
27
28	# 只要高人氣影片
29	yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "view_count>?1000"
30	```
31
32	用戶挑選後可進一步：取元數據、抓字幕、或推送到 NotebookLM（搭配 anything-to-notebooklm skill）。
33
34	## 取得影片元數據
35
36	```bash
37	yt-dlp -j "URL"
38	```
39
40	除基本欄位外，`channel_follower_count` 可評估頻道規模，`like_count` / `comment_count` 可評估內容互動度。
41
42	## 下載字幕
43
44	先確認可用字幕（避免下載失敗）：
45
46	```bash
47	yt-dlp --list-subs "URL" 2>&1 \| head -30
48	```
49
50	確認有字幕後再下載。`--sub-langs` 支援正則，可抓所有語言變體：
51
52	```bash
53	# 抓中文（含 zh-TW, zh-Hans 等）和英文（含 en-US 等）
54	yt-dlp --skip-download --write-auto-subs --sub-langs "zh.,en." --sub-format vtt -o "$TEMP/%(id)s" "URL"
55	```
56
57	也可同時抓手動字幕（品質更好）和自動字幕：
58
59	```bash
60	yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "zh.,en." --sub-format vtt -o "$TEMP/%(id)s" "URL"
61	```
62
63	手動字幕（`--write-subs`）品質優於自動字幕（`--write-auto-subs`），有手動的優先用。
64
65	輸出 VTT 檔，用內建腳本轉純文字：
66
67	```bash
68	python <skill-path>/scripts/parse_vtt.py "$TEMP/VIDEO_ID.en.vtt" -o "$TEMP/transcript.txt"
69	```
70
71	如果 `--list-subs` 顯示無字幕，告知用戶該影片沒有可用字幕。
72
73	## 年齡限制 / 會員內容
74
75	遇到年齡限制或需要登入才能觀看的影片，可從瀏覽器提取 Cookie：
76
77	```bash
78	yt-dlp --cookies-from-browser chrome -j "URL"
79	```
80
81	支援 chrome、firefox、edge、brave 等瀏覽器。先詢問用戶慣用的瀏覽器。
82
83	## 與 anything-to-notebooklm 的銜接
84
85	用戶常見流程：搜影片 → 選一部 → 推 NotebookLM。選定影片後，記住 URL，直接傳給 anything-to-notebooklm skill 使用（YouTube URL 可直接 `source add`，不需要先抓字幕）。
86
87	如果用戶想看逐字稿再決定是否推送，先抓字幕讓用戶確認內容。
88
89	## 注意事項
90
91	- Windows 中文輸出亂碼 → 指令前加 `PYTHONUTF8=1`
92	- 搜尋結果受地區影響 → 可加 `--geo-bypass`
93	- 長影片字幕檔很大 → 先確認 `duration` 再決定是否下載
94	- 批量操作加 `--sleep-requests 1` 避免被 YouTube 限流
95	- 用完字幕後清理暫存：`rm "$TEMP"/VIDEO_ID.*.vtt`

People who liked this also viewed

6 picks

Type

yt-search

37stars7forks

View on GitHub

How to install yt-search?

azuma520/youtube-to-notebooklm/yt-search

$npx -y skills add azuma520/youtube-to-notebooklm --skill yt-search

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# yt-search
2
3	YouTube 影片搜尋、元數據查詢、字幕下載。依賴 `yt-dlp`（`pip install yt-dlp`）。
4
5	## 搜尋影片
6
7	```bash
8	yt-dlp --flat-playlist "ytsearchN:關鍵字" -j
9	```
10
11	`N` = 結果數（預設 10，建議最多 20）。每行一個 JSON，取 `title`、`channel`、`duration_string`、`view_count`、`url`、`id`。
12
13	呈現為表格讓用戶挑選（按觀看數排序）：
14
15	```
16	# \| 標題 \| 頻道 \| 時長 \| 觀看數 \| URL
17	1 \| How to Make... \| FoodBiz \| 12:34 \| 45K \| https://youtube.com/watch?v=xxx
18	```
19
20	按上傳日期搜尋（找最新內容）：用 `ytsearchdateN:` 取代 `ytsearchN:`。
21
22	過濾搜尋結果：用 `--match-filters` 在搜尋層直接篩選，比下載後再過濾高效：
23
24	```bash
25	# 排除短影片（< 1 分鐘）和直播
26	yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "duration>60 & !is_live"
27
28	# 只要高人氣影片
29	yt-dlp --flat-playlist "ytsearch20:關鍵字" -j --match-filters "view_count>?1000"
30	```
31
32	用戶挑選後可進一步：取元數據、抓字幕、或推送到 NotebookLM（搭配 anything-to-notebooklm skill）。
33
34	## 取得影片元數據
35
36	```bash
37	yt-dlp -j "URL"
38	```
39
40	除基本欄位外，`channel_follower_count` 可評估頻道規模，`like_count` / `comment_count` 可評估內容互動度。
41
42	## 下載字幕
43
44	先確認可用字幕（避免下載失敗）：
45
46	```bash
47	yt-dlp --list-subs "URL" 2>&1 \| head -30
48	```
49
50	確認有字幕後再下載。`--sub-langs` 支援正則，可抓所有語言變體：
51
52	```bash
53	# 抓中文（含 zh-TW, zh-Hans 等）和英文（含 en-US 等）
54	yt-dlp --skip-download --write-auto-subs --sub-langs "zh.,en." --sub-format vtt -o "$TEMP/%(id)s" "URL"
55	```
56
57	也可同時抓手動字幕（品質更好）和自動字幕：
58
59	```bash
60	yt-dlp --skip-download --write-subs --write-auto-subs --sub-langs "zh.,en." --sub-format vtt -o "$TEMP/%(id)s" "URL"
61	```
62
63	手動字幕（`--write-subs`）品質優於自動字幕（`--write-auto-subs`），有手動的優先用。
64
65	輸出 VTT 檔，用內建腳本轉純文字：
66
67	```bash
68	python <skill-path>/scripts/parse_vtt.py "$TEMP/VIDEO_ID.en.vtt" -o "$TEMP/transcript.txt"
69	```
70
71	如果 `--list-subs` 顯示無字幕，告知用戶該影片沒有可用字幕。
72
73	## 年齡限制 / 會員內容
74
75	遇到年齡限制或需要登入才能觀看的影片，可從瀏覽器提取 Cookie：
76
77	```bash
78	yt-dlp --cookies-from-browser chrome -j "URL"
79	```
80
81	支援 chrome、firefox、edge、brave 等瀏覽器。先詢問用戶慣用的瀏覽器。
82
83	## 與 anything-to-notebooklm 的銜接
84
85	用戶常見流程：搜影片 → 選一部 → 推 NotebookLM。選定影片後，記住 URL，直接傳給 anything-to-notebooklm skill 使用（YouTube URL 可直接 `source add`，不需要先抓字幕）。
86
87	如果用戶想看逐字稿再決定是否推送，先抓字幕讓用戶確認內容。
88
89	## 注意事項
90
91	- Windows 中文輸出亂碼 → 指令前加 `PYTHONUTF8=1`
92	- 搜尋結果受地區影響 → 可加 `--geo-bypass`
93	- 長影片字幕檔很大 → 先確認 `duration` 再決定是否下載
94	- 批量操作加 `--sleep-requests 1` 避免被 YouTube 限流
95	- 用完字幕後清理暫存：`rm "$TEMP"/VIDEO_ID.*.vtt`

People who liked this also viewed

6 picks

Type