youtube-transcribe

1# YouTube 视频转录 + 翻译 Skill
2 
3**字幕优先**：先抓官方/自动字幕（秒级、免 GPU），抓不到再下载音频用 SenseVoice-Small 转录；英文内容自动翻译成中文，输出中英对照 Markdown。加 `--no-subtitle` 可强制走音频转录。
4 
5## 为什么需要这个
6 
7YouTube 有大量优质英文内容，但很多人没时间看完或语言不通。这个 skill：
8 
9- 转录视频为文字（支持中英文）
10- 英文内容自动翻译成高质量中文
11- 输出中英对照，方便学习
12 
13## 环境要求
14 
15```bash
16# Python 3.9+
17python -m venv .venv
18source .venv/bin/activate
19 
20# 依赖
21pip install funasr modelscope torch torchaudio
22 
23# 系统依赖
24# macOS: brew install ffmpeg yt-dlp
25# Ubuntu: sudo apt install ffmpeg && pip install yt-dlp
26 
27# 翻译功能（可选，英文视频需要）
28export DEEPSEEK_API_KEY="your-api-key"
29```
30 
31## 使用方法
32 
33```bash
34python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx"
35python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --output ./output
36python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --no-translate  # 不翻译
37python scripts/transcribe.py "https://www.youtube.com/watch?v=xxxxx" --no-subtitle  # 强制音频转录
38python scripts/batch_transcribe.py urls.txt -o ./output --no-translate
39```
40 
41## 流程
42 
43### Step 1: yt-dlp 下载音频
44 
45```bash
46yt-dlp --extract-audio --audio-format mp3 --audio-quality 128K \
47  "https://www.youtube.com/watch?v=xxxxx"
48```
49 
50### Step 2: SenseVoice-Small 转录
51 
52```python
53from funasr import AutoModel
54model = AutoModel(model="iic/SenseVoiceSmall", ...)
55result = model.generate(input=audio_path, language="auto", use_itn=True)
56```
57 
58### Step 3: 语言检测 + 翻译
59 
60- 中文内容 → 直接输出
61- 英文内容 → LLM 翻译成中文，输出中英对照
62 
63### Step 4: 生成 Markdown
64 
65```markdown
66---
67title: 视频标题
68type: note
69tags: [YouTube]
70language: en
71…