Etsy 商品视频发布审计

适用场景

当成片视频准备上传到 Etsy 商品 listing 前，需要集中检查数量、格式、大小、时长、分辨率、比例、音频和素材授权登记时使用。

输入与输出

• - 输入：脱敏 listing 标识，以及每条视频的文件名、格式、大小、时长、宽高、音频状态、用途和授权确认。
• 输出：etsy_listing_video_audit.json，包含逐项 findings、汇总状态、人工动作和固定的 publish_ready=false。

执行

运行 python scripts/audit_video.py examples/input.json --output etsy_listing_video_audit.json。硬限制失败会生成 block；比例不符合 2:1 或 1:2、分辨率低于理想值或授权未确认会生成 review。

安装与恢复

只需 Python 3.9+ 标准库。遇到缺字段或 JSON 错误时修正登记后重跑；脚本不删除或覆盖视频源文件。

权限与隐私

脚本只审计登记的元数据，不打开 Etsy 账号、不上传、不创建 listing、不判断版权归属，也不接触买家信息。最终上传必须由卖家人工确认。

验收

使用示例运行后检查视频数量为 2、阻断数为 0、音频为 false、总状态为 pass，但 publish_ready 仍为 false；把一个视频改为 101 MB 后重跑，应得到 block 和非零退出码。