Youtube Transcript

YouTube Transcript

YouTube 영상의 자막을 추출하고 분석합니다. yt-dlp 기반, MCP 불필요.

Quick Start

/youtube-transcript https://www.youtube.com/watch?v=VIDEO_ID
"이 영상 자막 가져와: https://youtu.be/VIDEO_ID"
"이 영상 요약해줘: https://www.youtube.com/watch?v=VIDEO_ID"

Prerequisites

• yt-dlp 설치 필요
  • Windows: pip install yt-dlp 또는 winget install yt-dlp
  • Mac: brew install yt-dlp
  • Linux: pip install yt-dlp

Workflow

1. URL 추출

$ARGUMENTS 또는 사용자 메시지에서 YouTube URL을 추출합니다.

지원 형식:

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• VIDEO_ID (11자리 영숫자)

2. yt-dlp 설치 확인 + 자동 설치

yt-dlp --version

미설치 시 자동 설치 (pip 사용 가능하면):

pip install yt-dlp

pip도 없으면 플랫폼별 안내:

• Windows: winget install yt-dlp
• Mac: brew install yt-dlp
• Linux: sudo apt install yt-dlp 또는 pip install yt-dlp

설치 후 다시 yt-dlp --version으로 확인하고 진행.

3. 자막 언어 확인

yt-dlp --list-subs "URL" 2>&1 | head -5

• 수동 자막(manual)이 있으면 우선 사용
• 없으면 자동 생성 자막(auto-generated) 사용
• 사용자가 언어를 지정하지 않으면 영어(en) → 한국어(ko) 순으로 시도

4. 자막 다운로드

# 임시 파일로 다운로드
yt-dlp --write-auto-sub --sub-lang {LANG} --sub-format srt --skip-download \
  -o "/tmp/yt-transcript-%(id)s" "URL"

Windows의 경우:

yt-dlp --write-auto-sub --sub-lang {LANG} --sub-format srt --skip-download \
  -o "$TEMP/yt-transcript-%(id)s" "URL"

5. 자막 읽기 + 정리

다운로드된 .srt 파일을 Read로 읽고, 타임스탬프를 제거하여 순수 텍스트로 정리합니다.

SRT 형식:

1
00:00:00,160 --> 00:00:04,799
This is the subtitle text

2
00:00:02,560 --> 00:00:07,040
Next subtitle line

정리 후:

This is the subtitle text. Next subtitle line...

6. 결과 제공

사용자 요청에 따라:

7. 임시 파일 정리

rm -f /tmp/yt-transcript-*.srt 2>/dev/null
# Windows
del "%TEMP%\yt-transcript-*.srt" 2>nul

Options

Error Handling