youtube-transcript-cn

```bash

python3 scripts/get_transcript.py "https://www.youtube.com/watch?v=VIDEO_ID"

```

1. 获取视频链接：从用户消息中提取 YouTube URL
2. 运行脚本：执行 scripts/get_transcript.py 提取字幕
3. 处理输出：

- 如果字幕是中文：直接输出

- 如果字幕是英文：翻译为中文后输出

1. 保存结果：根据用户需求保存为 Markdown 文件

| 参数 | 说明 | 默认值 |

|-----|------|-------|

| url | YouTube 视频链接或 ID | 必填 |

| -f, --format | 输出格式: text, markdown, json | markdown |

| -t, --timestamps | 包含时间戳 | 否 |

| -l, --lang | 首选语言（逗号分隔） | zh,en |

| -o, --output | 输出文件路径 | stdout |

基本用法

```bash

python3 scripts/get_transcript.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

```

带时间戳输出

```bash

python3 scripts/get_transcript.py -t "https://youtu.be/VIDEO_ID"

```

保存到文件

```bash

python3 scripts/get_transcript.py -o output.md "https://www.youtube.com/watch?v=VIDEO_ID"

```

JSON 格式（便于后处理）

```bash

python3 scripts/get_transcript.py -f json "VIDEO_ID"

```

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• 直接使用 Video ID

脚本按以下顺序查找字幕：

1. 简体中文 (zh-Hans)
2. 繁体中文 (zh-Hant)
3. 中文 (zh)
4. 英文 (en)
5. 自动生成字幕

如果获取到的是英文字幕，需要翻译为中文：

1. 运行脚本获取英文字幕
2. 使用 Claude 内置能力翻译为流畅的中文
3. 保持原文结构和段落划分

| 错误 | 原因 | 解决方案 |

|-----|------|---------|

| No captions available | 视频无字幕 | 告知用户该视频没有可用字幕 |

| Cannot extract video ID | URL 格式错误 | 请求用户提供正确的 YouTube 链接 |

| 网络超时 | 网络问题 | 重试或检查网络连接 |

Markdown 格式

```markdown

# 视频标题

• Video ID: abc123
• 语言: 中文（自动生成）
• 链接: https://www.youtube.com/watch?v=abc123

---

这是视频的第一段内容...

这是视频的第二段内容...

```