Shorts Video Maker

쇼츠 비디오 메이커 스킬

YouTube 원본 영상에서 하이라이트 구간을 추출하여 9:16 세로형 쇼츠 클립을 제작합니다.

필수 요구사항

시스템 의존성

• Python 3.8+
• yt-dlp (YouTube 다운로드)
• ffmpeg (영상 편집)
• OpenAI Whisper (음성 인식) 또는 Whisper API

설치

pip install yt-dlp openai-whisper
brew install ffmpeg  # macOS
# 또는 apt-get install ffmpeg  # Ubuntu

워크플로우

1단계: 영상 다운로드

python .claude/skills/shorts-video-maker/scripts/download_video.py \
  --url "YOUTUBE_URL" \
  --output ".claude/skills/shorts-video-maker/temp/"

• yt-dlp로 최고 화질 영상 다운로드
• 출력: .claude/skills/shorts-video-maker/temp/video.mp4

2단계: 자막 추출

python .claude/skills/shorts-video-maker/scripts/transcribe.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --output ".claude/skills/shorts-video-maker/temp/transcript.json"

• Whisper로 음성 → 텍스트 변환
• 타임스탬프 포함 JSON 출력
• 출력: .claude/skills/shorts-video-maker/temp/transcript.json

3단계: 쇼츠 대본 참조

• outputs/shorts-scripts/shorts-01.md ~ shorts-03.md 읽기
• 대본의 "원본 영상 참조" 섹션에서 구간 정보 확인
• 또는 transcript.json에서 매칭되는 구간 자동 탐색

4단계: 클립 추출 및 편집

python .claude/skills/shorts-video-maker/scripts/cut_shorts.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --transcript ".claude/skills/shorts-video-maker/temp/transcript.json" \
  --scripts "outputs/shorts-scripts/" \
  --output "outputs/shorts-videos/"

• ffmpeg로 구간 클리핑
• 9:16 비율 크롭
• 자막 하드코딩 (선택)
• 출력: outputs/shorts-videos/shorts-01.mp4 ~ shorts-03.mp4

쇼츠 스펙

영상 규격

• 해상도: 1080x1920px (세로)
• 비율: 9:16
• 길이: 15-60초
• 포맷: MP4 (H.264)

자막 스타일

• 위치: 하단 중앙 또는 상단
• 폰트: 굵은 산세리프
• 색상: 흰색 + 검정 테두리
• 크기: 화면 너비의 80%

스크립트 상세

download_video.py

• YouTube URL 입력
• 최고 화질 다운로드
• 진행률 표시
• 에러 처리

transcribe.py

• 오디오 추출
• Whisper 모델 로드
• 세그먼트별 타임스탬프 생성
• JSON 형식 출력

cut_shorts.py

• 시작/종료 시간 기반 클리핑
• 16:9 → 9:16 변환 (center crop)
• 자막 오버레이 (선택)
• 3개 클립 배치 처리

출력

최종 결과물

• outputs/shorts-videos/shorts-01.mp4
• outputs/shorts-videos/shorts-02.mp4
• outputs/shorts-videos/shorts-03.mp4

중간 파일

• .claude/skills/shorts-video-maker/temp/video.mp4: 원본 다운로드
• .claude/skills/shorts-video-maker/temp/transcript.json: 자막 데이터
• .claude/skills/shorts-video-maker/temp/audio.wav: 추출된 오디오

참조 파일

• .claude/skills/shorts-video-maker/references/shorts-spec.md: 쇼츠 플랫폼별 스펙
• .claude/agents/marketing/shorts-scriptwriter.md: 대본 에이전트 (연동)

사용 예시

# 전체 파이프라인 실행 (프로젝트 루트에서)

# 1. 다운로드
python .claude/skills/shorts-video-maker/scripts/download_video.py \
  --url "https://youtube.com/watch?v=xxxxx" \
  --output ".claude/skills/shorts-video-maker/temp/"

# 2. 자막 추출
python .claude/skills/shorts-video-maker/scripts/transcribe.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --output ".claude/skills/shorts-video-maker/temp/transcript.json"

# 3. 쇼츠 생성
python .claude/skills/shorts-video-maker/scripts/cut_shorts.py \
  --input ".claude/skills/shorts-video-maker/temp/video.mp4" \
  --transcript ".claude/skills/shorts-video-maker/temp/transcript.json" \
  --scripts "outputs/shorts-scripts/" \
  --output "outputs/shorts-videos/"

주의사항

1. YouTube 영상 저작권 확인 필요
2. 원본 영상이 16:9가 아닌 경우 크롭 조정 필요
3. Whisper 모델 크기에 따라 정확도/속도 트레이드오프
4. GPU 사용 시 처리 속도 향상