# 롱폼 자동화 — 사용법

페이지: `longform.html` (허브 `index.html` 의 ② 탭). 설치 없음, 모든 데이터는 이 브라우저(localStorage·IndexedDB)에만 저장됩니다.
코드: `longform/app.js`(화면·흐름), `longform/yt.js`(YouTube Data API), `longform/gemini.js`(Gemini 호출·IndexedDB·ZIP), `longform/prompts.js`(프롬프트·채점 기준).

## 처음 한 번: 설정
- **YouTube 키**: 채널 조회 페이지와 같은 YouTube Data API v3 키
- **Gemini 키**: aistudio.google.com → Get API key. 이 키 하나로 분석·대본·이미지(나노바나나)·음성(TTS)·Veo 영상까지 씁니다
- 모델(분석·대본/심사·이미지·음성·영상)은 「모델 목록 불러오기」로 고를 수 있음
- 목표 점수(기본 100)·최대 라운드(기본 4)·장면당 이미지·비율. 목표 100점·4라운드면 대본 1편에 Gemini 호출 최대 8회
- 무료 등급은 분당·일일 한도가 있어 429 가 나오면 잠시 기다렸다가 다시

## 흐름 (6단계)
1. **채널** — 채널 주소·@핸들·영상 링크 → 최근 30/50/100편. 배수 = 조회수 ÷ 그 채널 롱폼 중앙값, 2배 이상이 '터진' 영상. 체크한 영상만 분석(기본 배수 상위 15편). YouTube 쿼터 약 3~5단위
2. **방향성·주제** — 채널 벤치마킹 분석(포지셔닝·후킹 패턴·빈틈) → 내 채널 조건을 적고 주제 추천 + 자동 채점 루프
3. **레퍼런스 해부** — 잘 된 영상을 Gemini 가 직접 보거나(공개 영상), 자막을 붙여넣어 대본 구조·비주얼 분석
4. **대본(100점 루프)** — 생성 → 7개 기준 엄격 심사 → 지적 반영 재생성을 목표 점수까지 반복. 직접 고친 뒤 「수정본 재채점」 가능. [확인] 표시는 사실 확인 필요
5. **이미지** — 화풍·고정 캐릭터로 스타일 바이블 + 장면 분할(영어 프롬프트) → 전체 장면 이미지 생성. 첫 장면에서 고른 이미지가 「앵커」가 되어 이후 장면의 일관성을 잡음. 썸네일 생성
6. **영상·내보내기** — ZIP(대본·장면·이미지·프롬프트·음성), 편집용 장면표 복사, Gemini TTS 나레이션(섹션별 WAV), Veo 장면 영상(실험, 유료 등급) 또는 Flow 프롬프트 복사

## 프로젝트
상단에서 프로젝트를 여러 개 만들고 바꿀 수 있습니다. 「JSON 저장/불러오기」로 다른 PC·브라우저로 옮기거나 백업하세요 (브라우저 데이터를 지우면 사라집니다).

## 참고
- 이 설명서는 2026-10-16 통합 배포 때 페이지 화면 문구를 바탕으로 정리한 것입니다. 원래 설계 문서가 생기면 이 파일을 교체하세요.