Download Youtube

download-youtube Skill

YouTube 영상에서 오디오(MP3)와 자막(Transcript)을 다운로드합니다.

사용법

/download-youtube <youtube-url>
/download-youtube <youtube-url> --week <N>
/download-youtube <youtube-url> --audio-only
/download-youtube <youtube-url> --transcript-only

동작 흐름

1. URL 분석 및 검증

1. YouTube URL 형식 검증:

   • youtube.com/watch?v=VIDEO_ID
   • youtu.be/VIDEO_ID
   • 그 외 형식은 에러

2. Week 번호 결정:

   • --week 파라미터가 있으면 사용
   • 없으면 src/content/syllabus.ts에서 URL 매칭하여 추론
   • 매칭 실패 시 사용자에게 Week 번호 입력 요청

3. Slug 생성:

   • syllabus.ts의 title 또는 krSlug에서 생성
   • 소문자, 공백→하이픈, 특수문자 제거
   • 예: "Deep Dive into LLMs" → deep-dive-llms

2. yt-dlp 설치 확인

which yt-dlp

설치되어 있지 않으면:

• 사용자에게 설치 안내: pip install yt-dlp
• 또는 자동 설치 시도

3. 메타데이터 및 챕터 추출

yt-dlp --dump-json <URL>

추출 정보:

• title: 영상 제목
• uploader: 채널명
• duration: 영상 길이 (초)
• description: 영상 설명
• chapters: 챕터 목록 (있는 경우)

챕터 데이터 구조

{
  "chapters": [
    {"start_time": 0.0, "title": "introduction", "end_time": 60.0},
    {"start_time": 60.0, "title": "pretraining data", "end_time": 467.0},
    ...
  ]
}

챕터 없는 영상 처리

챕터가 없는 경우 사용자에게 확인:

이 영상에는 챕터가 없습니다. 어떻게 처리할까요?
1. 수동으로 분할점 입력 (예: "10:00, 25:30, 45:00")
2. 전체를 하나의 섹션으로 처리
3. 시간 기준 자동 분할 (예: 10분 단위)

4. 오디오 다운로드 (--transcript-only가 아닌 경우)

yt-dlp -x --audio-format mp3 \
  -o "docs/week{N}/media/{slug}.mp3" \
  <URL>

저장 경로: docs/week{N}/media/{slug}.mp3

5. 자막/Transcript 다운로드 (--audio-only가 아닌 경우)

yt-dlp --write-subs --write-auto-subs \
  --sub-langs "en" --sub-format "vtt" \
  --skip-download \
  -o "docs/week{N}/media/{slug}" \
  <URL>

자막 우선순위:

1. 수동 영어 자막 (en)
2. 자동 생성 영어 자막 (en-orig, en-auto)
3. 없으면 경고 표시

저장 경로: docs/week{N}/media/{slug}.en.vtt

6. VTT → Markdown 변환 (챕터 기반 섹션 분할)

VTT 파일을 파싱하여 챕터 기반으로 섹션을 나누고, 각 섹션에 요약을 추가:

---
title: "영상 제목"
source_url: "https://youtube.com/..."
source_type: youtube_transcript
author: "채널명"
duration: "HH:MM:SS"
fetch_date: "YYYY-MM-DD"
translation_status: none
audio_file: "media/{slug}.mp3"
chapters: 25
---

# 영상 제목

[원본 영상](https://youtube.com/...)

## Table of Contents

1. [Introduction](#1-introduction) (0:00)
2. [Pretraining Data (Internet)](#2-pretraining-data-internet) (1:00)
3. [Tokenization](#3-tokenization) (7:47)
...

---

## 1. Introduction

**요약**: Andrej Karpathy가 ChatGPT와 같은 대규모 언어 모델에 대한 포괄적인 소개를 시작하며...

[00:00:00] hi everyone so I've wanted to make this video for a while...

[00:00:30] what should we be putting there and what are these words generated back...

---

## 2. Pretraining Data (Internet)

**요약**: LLM 학습의 첫 단계인 사전학습 데이터에 대해 설명합니다...

[01:00] the tools okay so let's build Chachi PT...

저장 경로: docs/week{N}/{slug}.md

섹션 분할 로직

1. VTT 파일에서 타임스탬프와 텍스트 추출
2. 각 타임스탬프를 챕터의 start_time/end_time과 비교
3. 해당 챕터에 transcript 라인 매핑
4. 챕터별로 그룹화하여 섹션 생성

섹션별 요약 생성

각 섹션의 transcript를 요약하여 요약 필드에 추가:

• 1-2문장으로 핵심 내용 요약
• 영어로 작성 (번역 시 한국어로 변환)

7. INDEX.md 업데이트

• docs/week{N}/INDEX.md의 해당 Reading 상태를 collected로 업데이트
• 수집 날짜, 자막 유형(수동/자동) 등 메타 정보 추가

옵션

예시

기본 사용 (오디오 + 자막)

/download-youtube https://www.youtube.com/watch?v=7xTGNNLPyMI

결과:

• docs/week1/media/deep-dive-llms.mp3
• docs/week1/media/deep-dive-llms.en.vtt
• docs/week1/deep-dive-llms.md

Week 지정

/download-youtube https://www.youtube.com/watch?v=TswQeKftnaw --week 7

결과: docs/week7/ 디렉토리에 저장

Transcript만 다운로드

/download-youtube https://www.youtube.com/watch?v=T9aRN5JkmL8 --transcript-only

결과: MP3 없이 자막과 Transcript 마크다운만 생성

에러 처리

참고 파일

• src/content/syllabus.ts: URL-Week 매핑
• docs/glossary.md: 기술 용어 번역 참조
• docs/INDEX.md: 전체 진행 상황
• docs/week{N}/INDEX.md: 주차별 상세

출력

다운로드 완료 후 표시:

• 저장된 파일 경로들
• 영상 길이
• 자막 유형 (수동/자동)
• 다음 단계 안내: /translate-reading week{N}/{slug}

VTT 파싱 로직

입력 예시 (VTT)

WEBVTT

00:00:00.000 --> 00:00:03.500
Hi everyone, today we're going to dive deep into

00:00:03.500 --> 00:00:07.200
how large language models work.

출력 예시 (Markdown)

[00:00:00] Hi everyone, today we're going to dive deep into how large language models work.

변환 규칙:

1. 연속된 짧은 문장은 하나로 병합 (가독성 향상)
2. 타임스탬프는 [HH:MM:SS] 형식으로 단순화
3. 문장 단위로 구분 (마침표, 물음표, 느낌표 기준)

번역 워크플로우 연계

이 스킬의 출력물은 /translate-reading 스킬과 완벽 호환됩니다:

/download-youtube <url>
    ↓
docs/week{N}/{slug}.md 생성
    ↓
/translate-reading week{N}/{slug}
    ↓
docs/week{N}/kr/{slug}.md 생성