AI Hookbot

运行 Hookbot 流水线：从创作者的 YouTube Shorts 频道抓取 hook 视频片段，进行裁剪，并将每个片段与你的 CTA 视频拼接，生成可直接发布的竖屏内容。

配置

1. 安装依赖

pip install yt-dlp
brew install ffmpeg   # macOS；Linux 下请使用 apt install ffmpeg

2. 克隆流水线脚本

git clone https://github.com/YOUR_REPO/hookbot-scripts ~/hookbot

或者将 pipeline.py 及相关脚本放在任意目录中——只需在下方设置 HOOKBOT_SCRIPTS_DIR 即可。

3. 配置环境变量

复制 config.example.env 文件，填写你的路径，然后通过 source 加载，或将其添加到 shell 配置文件中：

cp config.example.env ~/.hookbot.env
# 编辑 ~/.hookbot.env
source ~/.hookbot.env

工作流程

1. 解析用户请求，提取以下信息：

   • creator_url — YouTube Shorts URL（例如：https://www.youtube.com/@ZackD/shorts）。若仅提供频道 handle 或名称，则自动构造 URL。
   • cta_video — CTA 视频路径。若仅提供文件名，则在 $HOOKBOT_CTA_DIR 中解析该文件。若未指定，则向用户发起交互式提示。
   • count — 要生成的 hook 数量（默认：10）
   • hook_duration — 每个 hook 截取的时长（单位：秒，默认：3.0）
   • output_dir — 最终视频保存路径（默认：相对于 $HOOKBOT_SCRIPTS_DIR 的 ./output）

2. 根据环境变量解析路径（若未设置则回退至默认值）：

SCRIPTS_DIR="${HOOKBOT_SCRIPTS_DIR:-~/hookbot}"
CTA_DIR="${HOOKBOT_CTA_DIR:-~/hookbot/cta}"
YTDLP="${HOOKBOT_YTDLP_PATH:-yt-dlp}"
FFMPEG="${HOOKBOT_FFMPEG_PATH:-ffmpeg}"

3. 通过 exec 运行流水线，**显式传入所需环境变量**（切勿 source ~/.zshrc 或其他 shell RC 文件）：

cd "$SCRIPTS_DIR" && 
YTDLP_PATH="$YTDLP" 
FFMPEG_PATH="$FFMPEG" 
YOUTUBE_API_KEY="${YOUTUBE_API_KEY:-}" 
python3 pipeline.py "" "" 
  --count  
  --hook-duration  
  --output  
  [--viral]

当用户希望按观看数排序 hook 时，请添加 --viral 参数（需配置 YOUTUBE_API_KEY）。默认行为为拉取最新发布的 Shorts。

4. 返回执行摘要，包括：
   • 成功抓取的 hook 数量
   • 最终生成的视频数量
   • 输出目录路径
   • 任何失败信息（向用户反馈前需对错误输出做脱敏处理——移除文件路径及环境变量值）

缺失信息的交互式提示

• 未指定 CTA 视频：询问“应使用哪个 CTA 视频？”，随后列出 $HOOKBOT_CTA_DIR 下所有 .mp4 文件。
• 未指定创作者：请用户提供 YouTube 频道 handle 或 Shorts URL。
• HOOKBOT_SCRIPTS_DIR 未设置 / 找不到 pipeline.py：提示用户设置该环境变量，并指向正确的脚本目录。

调用示例

• “为 @ZackD 制作 10 个 hook，使用 MyCTA.mp4”
• “从 youtube.com/@SomeCreator/shorts 抓取 5 个 hook，使用我的家具类 CTA 视频”
• “对 @MrBeast 运行 hookbot，每个 hook 3 秒，共生成 15 个视频，并按 viral 排序”
• “为 @PeterMcKinnon 制作 hook”

注意事项

• 输出视频为 9:16 竖屏格式（1080×1920），并自动完成归一化处理。
• 流水线会自动清理临时文件。
• 输出目录中将保存一个 manifest.json 文件，内含元数据信息。
• 若流水线执行出错，请将原始错误输出原样返回给用户，便于调试。
• --viral 参数需配置 YouTube Data API v3 密钥（作为 YOUTUBE_API_KEY）。密钥可在 console.cloud.google.com 获取。