tiktok-transcribe

1# TikTok 视频转录 Skill
2 
3将 TikTok 视频下载音频，用 SenseVoice-Small 转录为文字，存为带 frontmatter 的 Markdown 文件。内容中英混杂时自动检测语言。
4 
5## 环境要求
6 
7```bash
8# Python 3.9+
9python -m venv .venv
10source .venv/bin/activate
11 
12# 依赖
13pip install funasr modelscope torch torchaudio
14 
15# 系统依赖
16# macOS: brew install ffmpeg yt-dlp
17# Ubuntu: sudo apt install ffmpeg && pip install yt-dlp
18```
19 
20## 使用方法
21 
22```bash
23# 完整链接
24python scripts/transcribe.py "https://www.tiktok.com/@user/video/1234567890"
25 
26# 短链（自动跟随跳转）
27python scripts/transcribe.py "https://vm.tiktok.com/xxxxx"
28python scripts/transcribe.py "https://vt.tiktok.com/xxxxx"
29 
30# 指定输出目录
31python scripts/transcribe.py "https://vm.tiktok.com/xxxxx" -o ./output
32```
33 
34## 流程
35 
36### Step 1: yt-dlp 下载音频
37 
38TikTok 有地区限制，脚本默认加 `--geo-bypass`。短链由 yt-dlp 自动跟随跳转，无需手动处理。
39 
40```bash
41yt-dlp --extract-audio --audio-format mp3 --audio-quality 128K \
42  --geo-bypass \
43  "https://vm.tiktok.com/xxxxx"
44```
45 
46### Step 2: SenseVoice-Small 转录
47 
48```python
49from funasr import AutoModel
50 
51model = AutoModel(
52    model="iic/SenseVoiceSmall",
53    trust_remote_code=True,
54    vad_model="fsmn-vad",
55    vad_kwargs={"max_single_segment_time": 30000},
56    device="cpu",
57)
58 
59result = model.generate(
60    input=audio_path,
61    language="auto",   # TikTok 中英混杂，自动检测
62    use_itn=True,
63    batch_size_s=60,
64)
65```
66 
67### Step 3: 生成 Markdown
68 
69脚本自动创建带 frontmatter 的 Markdown 文件，包含来源链接、作者、语言和转录文本。
70 
71## 已知限制
72 
73- **地区限制**：部分地区或网络环境下 TikTok 内容可能无法访问，`--geo-bypass` 可缓解但不保证解决
74- **反爬**：频繁请求可能触发限流；脚本内置重试，仍建议控制频率
75…