숏폼 동영상 파이프라인
YouTube 동영상 → 바이럴 숏 클립 (TikTok, Reels, Shorts).
사전 요구 사항
pip install -r "D:/AI Store/digital-marketing-repos/ai-marketing-skills/requirements.txt"
# yt-dlp + ffmpeg 필수
사용법
전체 파이프라인 (Claude 기반 구간 분할)
python "D:/AI Store/digital-marketing-repos/ai-marketing-skills/short-form-pipeline/scripts/shortform_pipeline.py" \
--url "https://www.youtube.com/watch?v=VIDEO_ID" \
--max-clips 3 \
--output-dir ./output
독립형 클리퍼 (Claude 미사용, 휴리스틱 점수 기반)
python "D:/AI Store/digital-marketing-repos/ai-marketing-skills/short-form-pipeline/scripts/video_clipper.py" \
--url "https://www.youtube.com/watch?v=VIDEO_ID"
파이프라인 단계
- 다운로드 — yt-dlp가 동영상 + VTT 자막을 가져옴
- 자막 변환 — Whisper가 단어 수준 타임스탬프 생성
- 구간 분할 — Claude가 후킹 점수 7/10 이상인 최적의 30
60초 구간 25개 선택 - 자르기 — FFmpeg로 클립 추출
- 세로 크롭 — 레이아웃 인식 16:9 → 9:16 변환 (MediaPipe 얼굴 감지 활용)
- 캡션 삽입 — TikTok 스타일 단어 강조 캡션
레이아웃 유형 (자동 감지)
| 레이아웃 | 전략 |
|---|---|
| talking_head | 얼굴 감지 기반 중앙 크롭 |
| screen_share_overlay | 화면 위, 웹캠 아래 배치 |
| side_by_side | 화면 위, 얼굴 아래로 쌓기 |
| gallery_view | 활성 발언자 구역 표시 |
출력
- 1080×1920 (9:16 세로)
- H.264 + AAC
- 단어 강조 캡션 포함
- TikTok/Reels/Shorts 즉시 업로드 가능
팁
- FFmpeg 오류:
-filter_complex사용 시-c:v copy플래그 사용 금지 - 캡션 동기화: 원본이 아닌 자른 클립에 Whisper 실행
- 긴 클립: 90초 초과 시 자동으로 75초로 자름
- AI 구간 분할을 위해
ANTHROPIC_API_KEY환경 변수 필요