heygen-webhook-listenlisted

Run a short-lived local webhook receiver for HeyGen async render callbacks during a batch, updating segment manifest as videos complete. Use when polling is undesirable or rate-limited.
huodebing-alt/Agentic-Headshot-Video-Studio · ★ 0 · AI & Automation · score 73

Install: claude install-skill huodebing-alt/Agentic-Headshot-Video-Studio

# HeyGen Webhook Listen / 监听 HeyGen 回调 ## When to use / 何时使用 Large batches where polling is wasteful or HeyGen rate-limits status calls. 大批量渲染、轮询低效或被限流时使用。 ## Inputs / 输入 - `--port` default 8787, `--public-url` (e.g., from `ngrok`). - `workspace/aroll/manifest.json` to update. ## Output / 输出 - Live updates to `workspace/aroll/manifest.json`. - `workspace/logs/heygen.webhook.log`. ## Steps / 步骤 1. Start a tiny Python/Node HTTP server on `--port`. 2. Register `--public-url` as HeyGen callback for active jobs. 3. On callback, fetch MP4, update manifest, validate-lip-sync. 4. Shut down when all pending jobs complete or `--timeout-min` elapses. ## Examples / 示例 ``` claude run heygen-webhook-listen --port 8787 --public-url https://abc.ngrok.io/hg ``` ## Failure recovery / 失败回退 - On port collision, retry on `--port+1` up to 5 times. - If webhook never fires for > 5 min, fall back to polling via `mcp__heygen__video_status`.