# 미디어 추출 — yt-dlp

> yt-dlp는 YouTube 전용 도구가 아니라 **1,858개 사이트**를 지원하는 범용 미디어 추출 도구.
> 영상, 오디오, 팟캐스트, 라이브 스트리밍 — 미디어 URL이면 yt-dlp를 먼저 시도한다.

## 설치 확인

```bash
which yt-dlp || python3 -m yt_dlp --version
```

- `yt-dlp` 명령어가 PATH에 있으면 그대로 사용
- 없으면 `python3 -m yt_dlp`로 대체 (아래 모든 명령어에서 치환)
- 미설치 시: `pip install yt-dlp`

## 핵심 명령어 (모든 지원 사이트 공통)

### 메타데이터 추출 (가장 범용)

```bash
yt-dlp --dump-json "URL"
```

title, uploader, duration, view_count, description, tags 등 구조화 JSON 반환.
전용 extractor가 있는 사이트에서 ~95% 성공.

### 자막 추출

```bash
yt-dlp --write-sub --write-auto-sub --sub-lang "en,ko" --skip-download -o "/tmp/%(id)s" "URL"
cat /tmp/VIDEO_ID.*.vtt
```

YouTube는 100개 언어 자동자막 지원. 다른 사이트는 자체 자막 제공 시에만 동작.

### 검색

```bash
# YouTube
yt-dlp --dump-json "ytsearch5:{검색어}"

# SoundCloud
yt-dlp --dump-json "scsearch5:{검색어}"

# Dailymotion
yt-dlp --dump-json "dailymotionsearch5:{검색어}"

# Yahoo
yt-dlp --dump-json "yahoosearch5:{검색어}"
```

### 채널/플레이리스트 목록 (다운로드 없이)

```bash
yt-dlp --flat-playlist --dump-json "채널_URL"
```

title, id, url, duration 반환. 채널 전체 영상 목록을 초고속 수집.

### 댓글 추출 (YouTube)

```bash
yt-dlp --write-comments --skip-download --write-info-json \
  --extractor-args "youtube:max_comments=20" \
  -o "/tmp/%(id)s" "URL"
```

## 지원 플랫폼 카테고리

### 영상

| 사이트 | 메타데이터 | 자막 | 검색 | 비고 |
|--------|----------|------|------|------|
| YouTube | O | O (자동생성 포함) | `ytsearch` | 최고 지원 |
| Vimeo | O | O (사이트 제공 시) | X | 학술/다큐 콘텐츠 풍부 |
| Twitch | O (VOD/클립) | X | X | 기술 스트리밍 |
| TikTok | O | X | X | 공개 계정만 |
| Dailymotion | O | O | `dailymotionsearch` | |
| Rumble | O | X | X | |
| PeerTube | O | X | X | 탈중앙화 |

### 오디오/팟캐스트

| 사이트 | 메타데이터 | 검색 | 비고 |
|--------|----------|------|------|
| SoundCloud | O | `scsearch` | 검색까지 가능 — 최고 |
| Apple Podcasts | O | X | RSS 기반 |
| TuneIn | O | X | |
| acast | O | X | 채널 단위 지원 |
| Spreaker | O | X | |
| Audius | O | X | 블록체인 기반 |

### 한국 플랫폼

| 사이트 | Extractor | 비고 |
|--------|-----------|------|
| Naver TV | `Naver`, `Naver:live` | |
| Kakao | `Kakao` | |
| SBS | `SBS`, `sbs.co.kr` | |
| JTBC | `JTBC`, `JTBC:program` | |
| Chzzk | `chzzk:video`, `chzzk:live` | 네이버 스트리밍 |
| Soop (구 AfreecaTV) | `soop`, `soop:live` | |
| Daum | `daum.net`, `daum.net:clip` | |
| Weverse | `Weverse`, `WeverseLive` | K-팝 팬덤 |

### 뉴스 VOD

| 사이트 | 비고 |
|--------|------|
| BBC | 공개 VOD |
| ABC (호주) | iview |
| CBS News | |
| NBC News | 차단 많음 |

> 뉴스 사이트는 직접 URL보다 **YouTube 공식 채널 경유**가 더 안정적.
> 예: `ytsearch:BBC News {키워드}`

## 주의사항

- 자동 생성 자막은 행간 중복 → 후처리 필요
- generic extractor는 성공률 ~30% — 전용 extractor 있는 사이트 우선
- 페이월/로그인 사이트는 대부분 실패
- `--dump-json`이 가장 안전한 범용 명령 (다운로드 없음, 메타데이터만)