youtube-digest

YouTube Digest

YouTube 영상 분석 → 요약/인사이트/번역 문서 생성 → 퀴즈 테스트.

워크플로우

1. 메타데이터 수집

scripts/extract_metadata.sh "<URL>"

추출: title, description, channel, upload_date, duration, tags

2. Transcript 추출

scripts/extract_transcript.sh "<URL>" [output_dir]

우선순위: 수동 자막(ko→en) > 자동 생성 자막(ko→en)

3. 맥락 파악 (WebSearch)

웹 검색으로 고유명사 정확한 표기 수집:

• "{영상 제목}" {채널명} summary
• "{발표자명}" {주제 키워드}

4. Transcript 교정

자동 자막의 고유명사 오인식을 웹 검색 결과로 대체:

• Kora → Cora, cloud code → Claude Code, every → Every.to

5. 문서 생성

---
title: {영상 제목}
url: {YouTube URL}
channel: {채널명}
date: {업로드 날짜}
duration: {영상 길이}
processed_at: {처리 일시}
---

# {영상 제목}

## 요약
{3-5문장 요약 + 주요 포인트 3개}

## 인사이트
### 핵심 아이디어
### 적용 가능한 점

## 전체 스크립트 (한글 번역)
[00:00] ...

6. 파일 저장

위치: research/readings/youtube/{YYYY-MM-DD}-{sanitized-title}.md

7. 학습 퀴즈

3단계 × 3문제 = 총 9문제. AskUserQuestion으로 각 단계 3문제 동시 출제.

문제 유형 상세: references/quiz-patterns.md

결과 처리

틀린 문제에 대해 정답과 해설 제공 후, 문서 끝에 퀴즈 결과 추가:

## 퀴즈 결과

총점: 7/9 (78%) | 1단계 3/3 ✅ | 2단계 2/3 | 3단계 2/3

### 오답 노트

**Q5**: {질문}
- 선택: B → 정답: C
- {1-2문장 해설}

8. 후속 선택

퀴즈 완료 후 AskUserQuestion:

• 한 번 더 퀴즈: 다른 문제로 재테스트
• Deep Research: 웹 심층 조사 (references/deep-research.md 참조)
• 종료: 마무리

참고사항

자막 언어 우선순위

1. 한국어 수동 → 2. 영어 수동 → 3. 한국어 자동 → 4. 영어 자동

불완전한 자막 처리

• 고유명사 오인식: 4단계에서 일괄 대체
• 이해 불가 부분: [불명확] 표시

yt-dlp 옵션

• --list-subs: 자막 목록 확인
• --cookies-from-browser chrome: 로그인 필요 시

리소스

• scripts/extract_metadata.sh - 메타데이터 추출
• scripts/extract_transcript.sh - 자막 추출
• references/quiz-patterns.md - 퀴즈 문제 유형 상세
• references/deep-research.md - Deep Research 워크플로우