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宣传视频。