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）

Web 検索で固有名詞の正確な表記を収集します：

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

4. Transcript の校正

自動字幕で誤認識された固有名詞を、Web 検索結果をもとに置き換えます：

• 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問を同時に出題します。

段階	難易度	出題基準
1	基本	核心となるインサイト、主要な概念
2	中級	インサイトと詳細な内容の関連付け
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：Web で詳細に調査（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 ワークフロー