youtube-transcript-cn

Original：🇨🇳 Chinese

Translated

1 scriptsChecked / no sensitive code detected

Extract subtitles from YouTube video links and convert them into Chinese transcripts. Supports both auto-generated and manual subtitles. Usage scenarios: (1) Users provide a YouTube link and request subtitle/transcript extraction, (2) Users request to convert YouTube video content into text, (3) Users say "Help me convert this YouTube video to text" or similar requests. Trigger words: YouTube subtitles, video to text, extract subtitles, YouTube transcript, video text draft.

2installs

Sourcezephyrwang6/myskill

Added on2026-02-28

NPX Install

npx skill4agent add zephyrwang6/myskill youtube-transcript-cn

SKILL.md Content (Chinese)

View Translation Comparison →

YouTube Subtitle Extraction Skill

Extract subtitles from YouTube videos and output Chinese transcripts.

Quick Start

bash

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

Workflow

Get video link: Extract YouTube URL from user messages
Run script: Execute
```
scripts/get_transcript.py
```
to extract subtitles
Process output:
- If subtitles are in Chinese: Output directly
- If subtitles are in English: Translate to Chinese before output
Save results: Save as Markdown file per user requirements

Script Parameters

Parameter	Description	Default Value
`url`	YouTube video link or ID	Required
`-f, --format`	Output format: `text` , `markdown` , `json`	`markdown`
`-t, --timestamps`	Include timestamps	No
`-l, --lang`	Preferred languages (comma separated)	`zh,en`
`-o, --output`	Output file path	stdout

Usage Examples

Basic Usage

bash

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

Output with Timestamps

bash

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

Save to File

bash

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

JSON Format (for easy post-processing)

bash

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

Supported URL Formats

https://www.youtube.com/watch?v=VIDEO_ID

```
https://youtu.be/VIDEO_ID
```
```
https://www.youtube.com/embed/VIDEO_ID
```
Direct use of Video ID

Language Priority

The script looks for subtitles in the following order:

Simplified Chinese (zh-Hans)
Traditional Chinese (zh-Hant)
Chinese (zh)
English (en)
Auto-generated subtitles

Translation Processing

If the acquired subtitles are in English, they need to be translated into Chinese:

Run the script to get English subtitles
Use Claude's built-in capability to translate into fluent Chinese
Maintain the original structure and paragraph division

Error Handling

Error	Cause	Solution
No captions available	The video has no subtitles	Inform the user that there are no available subtitles for this video
Cannot extract video ID	URL format error	Ask the user to provide a correct YouTube link
Network timeout	Network problem	Retry or check network connection

Output Format Example

Markdown Format

markdown

# 视频标题

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

---

## 文字稿

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

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

youtube-transcript-cn

NPX Install

Tags

SKILL.md Content (Chinese)

YouTube Subtitle Extraction Skill

Quick Start

Workflow

Script Parameters

Usage Examples

Basic Usage

Output with Timestamps

Save to File

JSON Format (for easy post-processing)

Supported URL Formats

Language Priority

Translation Processing

Error Handling

Output Format Example

Markdown Format