youtube-generate

name	youtube-generate
description	유튜브 영상 올인원 생성 - 소재 파일 → 리서치 → 대본 → 재료 생성 → 블로그
argument-hint	<소재파일경로>
allowed-tools	Bash(python *), Read, AskUserQuestion

YouTube 영상 제작 프로세스

소재 파일 하나로 유튜브 영상 제작에 필요한 모든 재료를 생성합니다.

프로세스

Step 1: 경쟁 영상 리서치 (Gemini)

소재와 유사한 인기 유튜브 영상을 검색하고 대본/구조를 분석합니다. youtube-transcript-api로 자막을 추출하고, yt-dlp로 메타데이터를 가져온 뒤, Gemini가 구조 분석을 수행합니다.

python orchestrator.py --research $ARGUMENTS

실행 디렉토리: C:\YouTube

완료 후 사용자에게 보고:

• 검색된 영상 수와 제목
• 분석 결과 요약
• output/research/[타임스탬프]/ 폴더 경로

사용자에게 "리서치 결과를 확인하셨나요? 대본 생성으로 넘어갈까요?" 확인 후 Step 2로.

Step 2: 올인원 스크립트 생성 (Claude)

소재 + Step 1 리서치 결과를 참고하여 제목, 썸네일 문구, 대본을 한 번에 생성합니다.

python orchestrator.py --write $ARGUMENTS

완료 후:

1. 생성된 title.txt 내용을 사용자에게 보여주기
2. 생성된 thumbnail.txt 내용을 사용자에게 보여주기
3. 생성된 script.txt 내용을 사용자에게 보여주기
4. 반드시 "대본 내용이 괜찮으신가요? 수정할 부분이 있으면 말씀해주세요." 확인

사용자가 수정 요청하면 script.txt를 수정합니다. 사용자가 OK하면 Step 3으로.

Step 3: 영상 재료 생성

확정된 대본을 장면별로 분리한 뒤, 각 장면에 맞는 이미지 프롬프트, 음성, 편집 가이드, 업로드 정보(제목/설명/태그)를 생성합니다.

사용자에게 롱폼/숏폼 여부를 확인합니다.

# 롱폼
python orchestrator.py output/scripts/[타임스탬프]/script.txt

# 숏폼
python orchestrator.py output/scripts/[타임스탬프]/script.txt --short

원본 소재 파일이 있으면 --source 옵션으로 지정합니다 (블로그 생성 시 사용):

python orchestrator.py output/scripts/[타임스탬프]/script.txt --source input/topic.txt

완료 후 사용자에게 보고:

• 생성된 파일 목록 (음성, 이미지 프롬프트, 편집 가이드, 업로드 정보)
• output 폴더 경로
• "영상 편집 후 유튜브에 업로드하세요. 업로드 후 블로그 글이 필요하면 유튜브 URL을 알려주세요."

Step 4: 블로그 글 생성 (선택)

사용자가 유튜브 URL을 제공하면 원본 소재를 기반으로 블로그 글을 생성합니다. (대본이 아닌 원본 소재 + 유튜브 URL로 블로그를 작성합니다.)

python orchestrator.py --blog <유튜브URL> output/[Step3 폴더경로]

완료 후 사용자에게 보고:

• 생성된 블로그 글 미리보기
• 파일 경로

사용 예시

/youtube-generate input/topic.txt
/youtube-generate C:\YouTube\input\건강정보_소재.txt

관련 파일

• 오케스트레이터: orchestrator.py
• 경쟁 분석: modules/competitor_analyzer.py
• 스크립트 생성: modules/script_writer.py
• 음성 생성: modules/voice_generator.py
• 이미지 프롬프트: modules/prompt_generator.py
• 편집 가이드: modules/guide_generator.py
• 업로드 정보: modules/metadata_generator.py
• 블로그: modules/blog_generator.py
• 설정: config/settings.yaml