liyupi/ai-promo-video-maker

一句话让 AI 帮你做产品宣传片！把产品名或网址告诉 Cursor、Claude Code、Codex 等 AI 编程工具，它会自己调研产品、画出多种风格样图让你挑选、截取 4K 真实页面、按音乐节拍卡点剪辑、生成 AI 旁白并逐句转写校验、自动审图，最后交付一支 4K 商业宣传视频和可在线播放的网页版。App、网站、SaaS、开源项目、课程、AI 模型都能做，你只需确认需求、试听配乐。不用学剪辑软件，也不用花钱找外包。基于 Remotion + ElevenLabs，可直接克隆使用，也能一键安装为 Agent Skill。

ai-promo-video-maker – AI 기반 제품 프로모 비디오 생성기

한 문장 설명 – LLM에게 홍보하고 싶은 것을 말하면 조사하고, 후속 질문을 하고, 스크린샷을 캡처하고, 음악을 작곡하고, 음성 해설을 생성하고, 편집하여 4K 상업 비디오를 제공합니다.

무엇인가

짧은 텍스트 브리프를 완성된 프로모션 비디오로 바꾸는 자체 포함 워크플로우입니다. 핵심 로직은 AGENTS.md에 있으며, AI 코딩 어시스턴트(Claude, Cursor, Codex 등)가 읽고 실행할 수 있는 상세 사양입니다. 저장소에는 Remotion 비디오 프로젝트 템플릿과 다음을 자동화하는 헬퍼 스크립트(Python, Node, Playwright, FFmpeg) 모음이 포함되어 있습니다:

제품 조사 및 스타일 제안
각 스타일에 대한 샘플 키프레임 생성
제품 UI의 4K 스크린샷 캡처
음악 선택/작곡(ElevenLabs 또는 무료 Mixkit 라이브러리)
음성 해설 합성(ElevenLabs 선택 사항)
장면 조립, 타이밍 확인, 최종 렌더링
다단계 검증(자막 가독성, 브랜드 이름 철자, 오디오 믹스 레벨)

이 도구는 저장소를 클론하여 사용하거나 Vercel "스킬"로 설치하여 모든 프로젝트가 "이 저장소의 프로모 비디오를 만들어 줘"와 같은 단일 명령으로 호출할 수 있습니다.

주요 기능(README에 설명됨)

자연어 입력 – 한 문장이면 전체 파이프라인을 시작하기에 충분합니다.
AI 안내 스타일 탐색 – 시스템이 3~4개의 뚜렷한 비주얼 스타일을 제안하고, 각각에 대한 샘플 프레임을 렌더링하며, 사용자가 선택하거나 혼합할 수 있습니다.
자동 4K UI 캡처 – Playwright 기반의 모든 웹 페이지(로그인 보호 페이지 포함) 스크린샷을 3840×2160으로 캡처합니다.
오디오 생성 – 선택적 ElevenLabs TTS 및 AI 음악; 무료, 상업적으로 안전한 Mixkit 트랙으로 폴백.
엄격한 타이밍 및 오디오 검사 – 자막 가독성 임계값, 수정 시 변경된 부분만 자동 재렌더링.
Remotion 기반 렌더링 – 프로그래밍 방식 비디오 생성을 위한 오픈소스 Remotion 프레임워크 활용.
스킬 통합 – npx skills add를 통해 Claude Code, Cursor, Codex 등에 추가하여 모든 코드베이스 내에서 즉시 사용할 수 있습니다.
광범위한 문서 – AGENTS.md(워크플로우 사양), references/(함정, 사례 연구), 샘플 출력 디렉토리.

빠른 시작(README에서)

사전 요구 사항 – Node ≥ 18, Python ≥ 3.9, FFmpeg, Playwright용 브라우저 엔진.

클론 및 설치

git clone https://github.com/liyupi/ai-promo-video-maker.git
cd ai-promo-video-maker
pip install -r template/requirements.txt
playwright install chromium

헬스 체크 스크립트 실행(선택 사항) 환경 검증:
```
python3 template/scripts/doctor.py
```
AI 코딩 어시스턴트에서 폴더 열기(Cursor, Claude Code 등) 및 자연어 명령 실행(예:
```
给我的开源项目做一支 1 分钟的介绍视频，仓库地址是 https://github.com/xxx/yyy
```
AI는 다음을 수행합니다:
- 제품 조사
- 선택할 스타일 프레임 제안
- 스크린샷 캡처, 음악/음성 생성, 장면 조립
- 4K 비디오를 outputs/<프로젝트 이름>/에 렌더링

스킬 설치(선택 사항)

npx skills add liyupi/ai-promo-video-maker -g

이후 모든 프로젝트는 동일한 자연어 프롬프트로 스킬을 트리거할 수 있습니다. 출력은 宣传片/ 폴더에 배치됩니다.

구성 참고 사항

ElevenLabs – .env에 API 키를 추가(또는 ELEVENLABS_API_KEY 설정)하여 AI 생성 내레이션 및 맞춤 음악을 활성화합니다.
폴백 – ElevenLabs가 없으면 시스템은 무료 Mixkit 트랙과 화면 자막을 음성 해설 대신 사용합니다.
지원 모델 – README는 워크플로우가 긴 컨텍스트 추론과 미적 판단을 필요로 하므로 최상의 결과를 위해 Claude Opus 5.5 이상을 권장합니다.

라이선스

MIT(LICENSE 참조).

누가 사용할까요

스튜디오를 고용하지 않고 세련된 프로모 비디오를 원하는 인디 개발자.
프로젝트를 빠르게 소개하려는 오픈소스 유지 관리자.
소셜 플랫폼(예: TikTok, YouTube Shorts)용 제품별 비디오를 빠르고 반복 가능하게 생성해야 하는 마케팅 팀.

결론

ai-promo-video-maker는 LLM 기반 계획과 자동화된 비디오 제작 도구를 결합하여 모든 소프트웨어 제품의 간단한 설명을 게시 가능한 4K 프로모션 비디오로 바꾸는 완전한 기능의 오픈소스 파이프라인입니다.