mcpField
Y
youtube-transcript-cn

youtube-transcript-cn

github.com/spacezephyrProductivity340122 installsUpdated 31w ago
Repository

About youtube-transcript-cn

youtube-transcript-cn is a skill that extracts YouTube captions and produces Chinese transcripts for people who want to read, save, or process video content. It accepts several link formats and output options, and translates English captions into Chinese.

Key features

  1. 01Extracts YouTube captions
  2. 02Translates English captions into Chinese
  3. 03Accepts multiple video link formats
  4. 04Outputs text, Markdown, or JSON
  5. 05Supports timestamps and file output

Use cases

  1. 01Preparing Chinese transcripts of videos
  2. 02Saving captions with timestamps
  3. 03Exporting captions as JSON for processing

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/spacezephyr/myskill --skill youtube-transcript-cn

After installing, type/youtube-transcript-cnin Claude Code to confirm it loaded.

Bundled filesscripts/get_transcript.pyyoutube-transcript-cn.skill

Details

From the project README

YouTube 字幕提取技能

从 YouTube 视频提取字幕，输出中文文字稿。

快速使用

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

工作流程

  1. 获取视频链接：从用户消息中提取 YouTube URL
  2. 运行脚本：执行 scripts/get_transcript.py 提取字幕
  3. 处理输出：
    • 如果字幕是中文：直接输出
    • 如果字幕是英文：翻译为中文后输出
  4. 保存结果：根据用户需求保存为 Markdown 文件

脚本参数

参数说明默认值
urlYouTube 视频链接或 ID必填
-f, --format输出格式: text, markdown, jsonmarkdown
-t, --timestamps包含时间戳否
-l, --lang首选语言（逗号分隔）zh,en
-o, --output输出文件路径stdout

使用示例

基本用法
python3 scripts/get_transcript.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
带时间戳输出
python3 scripts/get_transcript.py -t "https://youtu.be/VIDEO_ID"
保存到文件
python3 scripts/get_transcript.py -o output.md "https://www.youtube.com/watch?v=VIDEO_ID"
JSON 格式（便于后处理）
python3 scripts/get_transcript.py -f json "VIDEO_ID"

支持的 URL 格式

  • 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 IDURL 格式错误请求用户提供正确的 YouTube 链接
网络超时网络问题重试或检查网络连接

输出格式示例

Markdown 格式
# 视频标题

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

---

## 文字稿

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

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

Comments

Markdown supported