TSW Shorts Factory

零成本、全自动的 YouTube Shorts 内容流水线。每日稳定发布 3 条视频，全程无需调用付费 API。

技术栈：edge-tts（免费）→ Pexels 视频片段（免费 API）→ MoviePy（本地运行）→ YouTube 上传

快速部署

# 1. 安装依赖
pip install moviepy edge-tts google-api-python-client google-auth-oauthlib pillow

# 2. 设置 Pexels API 密钥（在 pexels.com/api 免费获取）
export PEXELS_API_KEY="your_key_here"

# 3. 配置 YouTube OAuth（仅需一次）
python3 scripts/yt_setup.py  # 将自动打开浏览器完成授权

# 4. 准备语录库
cp assets/sample_quotes.json quote_library.json  # 或替换为你自己的 JSON 文件

# 5. 手动运行一次以测试流程
python3 scripts/pipeline.py

# 6. 添加到 cron 定时任务（每日执行 3 次）
# 0 8,14,20 * * * cd /your/path && python3 scripts/pipeline.py >> pipeline.log 2>&1

语录库格式

{
  "motivational": [
    {"quote": "Champions keep playing until they get it right.", "author": "Billie Jean King"},
    {"quote": "The secret of getting ahead is getting started.", "author": "Mark Twain"}
  ],
  "sports_quotes": [
    {"quote": "I am the greatest.", "author": "Muhammad Ali"}
  ]
}

支持的细分领域（niches）：motivational、sports_quotes、business_quotes、film_tv_quotes、wisdom_philosophy

视频输出规范

• 格式：MP4，竖屏 1080×1920（专为 Shorts 优化）
• 时长：与 TTS 音频长度一致（约 15–45 秒）
• 文字叠加：显示语录正文 + 作者名，居中排布，白色字体带黑色描边
• 背景素材：从 Pexels 获取 4 段循环播放的免版税视频片段，并按语录所属 niche 自动匹配
• 上传状态：全部设为 未公开草稿（unlisted drafts），待人工审核后发布

配置项

成本说明

• edge-tts：免费（通过非官方接口调用 Microsoft 神经语音）
• Pexels：免费额度（每月 25,000 次请求）
• MoviePy：免费（本地调用 ffmpeg）
• YouTube API：免费（每日配额 10,000 单位）
• 总计：$0/月，可持续支撑约 90 条视频/月

参考资料

• YouTube 授权配置：参见 references/youtube-setup.md
• 新增 niche 支持：参见 references/niche-config.md
• 常见问题排查：参见 references/troubleshooting.md