유튜브 리텐션 데이터로 고객 반응 좋은 구간을 자동 감지해 세로 숏폼으로 만드는 파이썬 툴킷
중간맛 분석
Python 스택 기반으로 faster-whisper(로컬 전사)·ffmpeg·Google YouTube Analytics 를 조합합니다. 난이도는 중상 수준( 세팅 필요)이며, 설정 후엔 로 한 줄씩 실행하면 됩니다. 데모: 영상 ID 입력 → 리텐션 수집 → 전사 → 9:16 리프레이밍 → 헤더·자막 합성 → 세이프존 검수 이미지 자동 생성. 로컬에서만 처리되므로 영상 업로드 비용이 0원입니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 유튜브 롱폼 콘텐츠를 인스타그램 릴스·틱톡용 세로 숏폼으로 대량 변환
- 시청자 반응 좋은 구간만 자동으로 골라내 채널의 클립/하이라이트 콘텐츠 제작
- 수십 개 숏폼을 손수 편집하던 작업을 자동화해 제작 시간 단축
핵심 기능
대안 대비 차별점
기존 숏폼 자동화 도구와 달리 임의 구간 자르기가 아닌 유튜브 시청 지속률 데이터로 실제 고객 반응 좋은 구간을 선정하고, 페이오프 지점을 훅으로 재구성하며, 릴스 UI 가림 여부를 자동 검수하는 데이터 기반 파이프라인을 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- ffmpeg (libass 자막 번인 지원 빌드)
- Python 3.7+
- Google Cloud Console 프로젝트 + YouTube Analytics API 인증
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/choigpt-ai/retention-shorts.git && cd retention-shorts && uv venv && uv pip install -r requirements.txt
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- ffmpeg 설치 (자막 번인용 libass 필포):
brew install ffmpeg
ffmpeg -filters | grep subtitles
- 파이썬 의존성 설치:
pip install -r requirements.txt
- 스타일 설정 파일 복사 및 커스터마이징 (폰트·색·푸터):
cp config/style.example.json config/style.json
-
Google Cloud OAuth 세팅 (1회): Console에서 YouTube Analytics API 활성화 후 클라이언트 ID JSON을
config/client_secret.json으로 저장 -
리텐션 수집:
python helpers/fetch_retention.py <YOUTUBE_VIDEO_ID>
- 로컬 전사 (단어 타임스탐프):
python helpers/transcribe.py longform.mp4 --language ko
- 원하는 구간 커팅:
ffmpeg -ss <start> -to <end> -i longform.mp4 -c:v libx264 -c:a aac cut.mp4
- 9:16 리프레이밍:
python helpers/reframe916.py cut.mp4 -o cut916.mp4 --mode crop --focus 0.5
- 헤더·자막·푸터 합성:
python helpers/compose.py cut916.mp4 -o final.mp4 --title "훅 1줄?!|해결 1줄!" --srt subs.srt --config config/style.json
- 세이프존 검수:
python helpers/reels_guide_qc.py final.mp4
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try choigpt-ai/retention-shorts
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「AI 미디어 생성」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/choigpt-ai/retention-shorts)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기