youtube-transcript

Doyajin174's avatarfrom Doyajin174

Download and process YouTube video transcripts using yt-dlp. Use this when extracting subtitles, creating summaries from videos, or processing video content.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026
[Summarization]

When & Why to Use This Skill

This Claude skill automates the extraction and processing of YouTube video transcripts using yt-dlp. It enables users to efficiently download subtitles, convert VTT files to clean text, and generate concise summaries or chapters from video content. By streamlining the transition from video to text, it significantly enhances research efficiency and content accessibility, even providing a Whisper-based fallback for videos without native captions.

Use Cases

  • Video Content Summarization: Quickly extract core insights and key takeaways from long educational or informational YouTube videos to save time.
  • Multilingual Subtitle Extraction: Download and organize subtitles in various languages for translation, accessibility, or language learning purposes.
  • Content Repurposing: Convert video dialogue into clean, timestamp-free text for use in blog posts, articles, or social media content.
  • Automated Transcription Fallback: Utilize Whisper integration to generate high-quality transcripts for videos that lack official or auto-generated subtitles.
nameyoutube-transcript
descriptionDownload and process YouTube video transcripts using yt-dlp. Use this when extracting subtitles, creating summaries from videos, or processing video content.
allowed-toolsRead, Glob, Grep, Bash, Write
licenseMIT
authormichalparkola
version"1.0"

YouTube Transcript Downloader

유튜브 영상에서 자막을 추출하고 처리하는 스킬입니다.

Priority Order

1. yt-dlp 설치 확인
2. 사용 가능한 자막 목록 확인
3. 수동 자막 우선 시도
4. 자동 생성 자막 폴백
5. 최후 수단: Whisper 변환

Requirements

# macOS
brew install yt-dlp

# Linux
sudo apt install yt-dlp

# Universal
pip install yt-dlp

Workflow

Step 1: 자막 목록 확인

yt-dlp --list-subs "VIDEO_URL"

Step 2: 수동 자막 다운로드 (권장)

# 한국어 자막
yt-dlp --write-sub --sub-lang ko --skip-download "VIDEO_URL"

# 영어 자막
yt-dlp --write-sub --sub-lang en --skip-download "VIDEO_URL"

Step 3: 자동 생성 자막 (폴백)

yt-dlp --write-auto-sub --sub-lang ko --skip-download "VIDEO_URL"

Step 4: VTT → 텍스트 변환

# VTT 파일에서 타임스탬프 제거
sed '/^[0-9]/d; /^$/d; /-->/d' subtitle.ko.vtt > transcript.txt

Output Processing

중복 제거

자동 생성 자막은 progressive 캡션으로 인해 중복이 많음:

# 중복 라인 제거
seen = set()
unique_lines = []
for line in lines:
    if line not in seen:
        seen.add(line)
        unique_lines.append(line)

요약 생성

추출된 자막으로:

  • 핵심 내용 요약
  • 타임스탬프별 챕터 생성
  • 주요 키워드 추출

Examples

Example 1: 강의 영상 요약

User: 이 유튜브 강의 요약해줘 - https://youtube.com/watch?v=xxx

Claude:
1. yt-dlp로 자막 다운로드
2. VTT → 텍스트 변환
3. 핵심 내용 요약 생성
4. 타임스탬프별 목차 제공

Example 2: 다국어 자막 추출

User: 이 영상의 영어/한국어 자막 둘 다 추출해줘

Claude:
1. --list-subs로 가용 언어 확인
2. 각 언어별 자막 다운로드
3. 정리된 텍스트 파일 제공

Error Handling

에러 원인 해결책
yt-dlp not found 미설치 brew/apt/pip 설치
No subtitles available 자막 없음 Whisper 사용 제안
Invalid URL URL 오류 URL 형식 확인
Video unavailable 비공개/삭제 사용자에게 알림

Whisper Fallback

자막이 전혀 없는 경우 (사용자 확인 필요):

# 파일 크기 확인
yt-dlp --print filesize "VIDEO_URL"

# 사용자 승인 후 오디오 다운로드
yt-dlp -x --audio-format mp3 "VIDEO_URL"

# Whisper로 변환
whisper audio.mp3 --language ko --model base

주의: 대역폭/처리 시간 소요로 사용자 확인 필수