web2clip · 웹사이트를 AI 음성 클립으로 변환
대화형 웹 페이지(가장 이상적)를 챕터별 짧은 클립 시리즈 + 1개의 종합 클립으로 변환합니다. 세로 9:16 또는 가로 16:9 비율로 제작되며, AI 호스트(ElevenLabs 음성), 내레이션에 맞춰 웹 페이지에 적용되는 효과(강조 테두리, 클릭 커서, 스크롤바 드래그, 자막 등)가 포함되며, 실제 페이지를 녹화하므로 데이터가 100% 정확합니다.
하위 명령어 (특정 단계만 필요할 때 사용)
| 명령어 | 단계 |
|---|---|
/web2clip-setup | 1–2 · 연결, 도구, 네트워크 권한, 계정 확인 |
/web2clip-plan | 3 · 웹사이트 분석, 아이디어 제안, 시나리오 + 대시보드 작성 |
/web2clip-voice | 4–5 · 음성 제안, 각 클립 음성 생성, 파일 다운로드 |
/web2clip-record | 4 · 음성에 맞춰 동기화 녹화, 각 클립 내보내기 |
/web2clip-merge | 6 · 종합 클립 편집, 이름 지정, 파일 전달, 보관 |
/web2clip 실행 = 아래 7단계를 순서대로 진행합니다. 단계를 건너뛰지 마십시오.
핵심 규칙 (실제 프로젝트 경험 기반)
- 텍스트 먼저 승인, 비용은 나중에: 시나리오는 음성 생성(크레딧 소모) 전에 반드시 승인을 받아야 합니다.
- 먼저 1개의 클립을 시범 제작(파일럿)하여 사용자가 음성과 효과 스타일을 승인한 후, 나머지를 대량 제작합니다.
- 음성은 내레이터 역할이며, 웹 페이지의 텍스트를 단순히 읽지 않습니다. 역할 이름(예: "철수 씨의 비서, 칩")이 있고, 친근한 호칭을 사용하며, 질문이나 상황 설명으로 시작하여 다음 부분으로 자연스럽게 이어집니다.
- 짧은 클립을 챕터별(1-2분)로 나누어 제작한 후 종합 클립으로 편집합니다. 처음부터 긴 클립 하나를 만들지 않습니다.
- 화면은 내레이션에 맞춰 움직입니다: 특정 부분을 언급하면 그 부분이 정확히 그 시간에 강조됩니다. 동기화 녹화 도구(
scripts/w2c/record.py)를 사용하며, 수동으로 추정하지 않습니다. - 사용자에게 한 번에 최대 1-3개의 질문을 하고, 선택 옵션을 미리 제공합니다. 제한 사항이 있으면 솔직하게 알립니다.
7단계 프로세스
1. 연결 확인 → /web2clip-setup 참조
python -m w2c.check_env 실행(scripts/ 디렉토리에서). 표로 표시: 사용 가능한 도구, 연결 상태(ElevenLabs, Drive, Canva, 브라우저), 누락된 항목은 설치 방법 및 계정 생성 안내를 제안합니다.
2. MCP / API / 권한 준비
네트워크 권한 부족 → 사용자가 올바른 도메인(설정에 목록 있음)을 열도록 안내합니다. ElevenLabs 연결이 없으면 연결을 요청합니다. 도구 권한 요청 창이 나타나면 **"항상 허용"**을 선택하도록 안내합니다.
3. 아이디어 구상 → /web2clip-plan 참조
웹사이트를 읽고, 챕터/섹션을 나열하고, 화면 비율, 길이, 음성, 호스트, 클립 수를 제안합니다. 2열 시나리오(내레이션 · 웹 효과)를 작성합니다. 대시보드(w2c.dashboard)를 생성하고 링크를 보내 사용자가 전체 개요를 파악하고 각 클립을 승인할 수 있도록 합니다.
4. 시나리오 → 음성 → 녹화 → 각 클립 편집
음성: /web2clip-voice. 녹화: /web2clip-record. 각 클립 후 대시보드를 업데이트합니다.
5. 음성 제안
언어, 성별, 연령대, 지역에 따라 음성을 필터링하고, 이유를 포함한 2-3가지 옵션을 제시하며, 기본값은 자연스러운 스토리텔링 음성입니다.
6. 종합 클립 → /web2clip-merge 참조
순서대로 편집하고, 파일 이름을 <프로젝트>_Clip<번호>_<섹션명>.mp4로 지정하며, 종합 클립은 0. ..._TONG-HOP으로 지정하여 디렉토리 맨 위에 오도록 합니다.
7. 100% 만족할 때까지 전달
파일을 보내고 대시보드를 업데이트하며, 보내기 전에 자체적으로 화면을 검토(클립당 4-6 프레임 추출)하고, 자체 발견된 오류를 나열하고, 사용자가 승인할 때까지 수정합니다. 시나리오, 음성, 사양을 저장하여 빠르게 수정할 수 있도록 합니다.
참고 자료
references/loi-thuong-gap.md— 과거 오류와 방지 방법(녹화 전 필수 읽기).references/viet-kich-ban.md— 매력적인 내레이션 작성 방법 + 시나리오 템플릿.references/chon-giong.md— 음성 제안 방법, 크레딧 예상, ElevenLabs 요금제.examples/spec_example.json(저장소 루트에 있음) — 시나리오 파일 예시.