Communitygithub.com

AI 바이브 툴킷

YouTube 장편 동영상을 TikTok, Reels, Shorts용 숏폼 클립으로 변환하는 파이프라인입니다. 다운로드, Whisper 자막 변환, AI 기반 구간 선택(Claude), 세로 크롭, 캡션 삽입을 자동화합니다.

AI 바이브 툴킷란 무엇인가요?

이 스킬은 YouTube 장편 동영상을 입맛에 맞는 바이럴 숏폼 클립(TikTok, Reels, Shorts)으로 변환하는 완전 자동화 파이프라인입니다. yt-dlp로 동영상과 자막을 다운로드하고, OpenAI Whisper로 정밀한 타임스탬프를 생성하며, Claude AI가 후킹 점수 7/10 이상인 최적의 30~60초 구간을 2~5개 선별합니다. MediaPipe를 이용한 얼굴 인식 기반의 레이아웃 자동 감지(토킹 헤드, 화면 공유, 분할 화면 등)로 세로 크롭을 수행하고, TikTok 스타일의 워드 하이라이트 캡션을 FFmpeg로 실시간 렌더링합니다. 모든 주요 OS와 Python 환경에서 동작하며, CLI 기반으로 CI/CD 파이프라인에도 쉽게 통합할 수 있습니다. 특히 마케터, 콘텐츠 크리에이터, 소셜 미디어 매니저에게 유용하며, 수동 편집 시간을 80% 이상 절감할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tano2026/AI-Vibe-Toolkit/tree/HEAD/skills/short-form-pipeline

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

숏폼 동영상 파이프라인

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"

파이프라인 단계

  1. 다운로드 — yt-dlp가 동영상 + VTT 자막을 가져옴
  2. 자막 변환 — Whisper가 단어 수준 타임스탬프 생성
  3. 구간 분할 — Claude가 후킹 점수 7/10 이상인 최적의 3060초 구간 25개 선택
  4. 자르기 — FFmpeg로 클립 추출
  5. 세로 크롭 — 레이아웃 인식 16:9 → 9:16 변환 (MediaPipe 얼굴 감지 활용)
  6. 캡션 삽입 — 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 환경 변수 필요

관련 스킬