extract-youtube-transcript提取YouTube字幕

Extract plain-text transcripts from YouTube videos using a local Python script. Use when the user wants to fetch, extract, or get a transcript from a YouTube video URL, analyze YouTube video content as text, or needs subtitles/captions from a video.

作者: admin | 来源: ClawHub

Extract YouTube Transcript

Fetches plain-text transcripts from YouTube videos using extract_youtube_transcript.py in this skill folder.

Dependency

CODEBLOCK0

Quick Start

CODEBLOCK1

Supported URL formats: youtube.com/watch?v=, youtu.be/, /embed/, /live/, /shorts/, or a raw 11-char video ID.

Common Patterns

Fetch with preferred language(s)

CODEBLOCK2

Pass languages in priority order. Falls back to any available transcript if none match.

Save transcript to file

CODEBLOCK3

Text is printed to stdout and also written to the file.

List available languages first

CODEBLOCK4

Use this to discover what language codes are available before fetching.

Language Codes

Code	Language
INLINECODE6	English
INLINECODE7

Error Handling

Error	Cause	Recovery
INLINECODE12	Owner disabled captions	No transcript available
INLINECODE13

Workflow

1. Try a direct fetch first
If NoTranscriptFound, run --list-langs to see available codes, then re-fetch with INLINECODE20
Save long transcripts to a file with --output for easier downstream processing

提取YouTube字幕

使用本技能文件夹中的extractyoutubetranscript.py从YouTube视频中获取纯文本字幕。

依赖

bash
pip show youtube-transcript-api &>/dev/null || pip install youtube-transcript-api

快速开始

bash
python extractyoutubetranscript.py https://www.youtube.com/watch?v=VIDEO_ID

支持的URL格式：youtube.com/watch?v=、youtu.be/、/embed/、/live/、/shorts/，或原始的11字符视频ID。

常见用法

按首选语言获取

bash
python extractyoutubetranscript.py URL --lang zh-Hant en

按优先级顺序传入语言。如果没有匹配的语言，则回退到任何可用的字幕。

保存字幕到文件

bash
python extractyoutubetranscript.py URL --output transcript.txt

文本会输出到标准输出，同时也会写入文件。

先列出可用语言

bash
python extractyoutubetranscript.py URL --list-langs

在获取之前，使用此命令查看可用的语言代码。

语言代码

代码	语言
en	英语
zh-Hant

繁体中文 | | zh-Hans | 简体中文 | | ja | 日语 | | ko | 韩语 | | es | 西班牙语 |

错误处理

错误	原因	解决方法
TranscriptsDisabled	视频所有者禁用了字幕	无可用字幕
NoTranscriptFound

工作流程

1. 首先尝试直接获取
如果出现NoTranscriptFound，运行--list-langs查看可用代码，然后使用--lang 重新获取
使用--output将长字幕保存到文件，以便后续处理

extract-youtube-transcript提取YouTube字幕