Shopify商品视频SEO打包

场景与前置条件

用于接收商品视频媒体审计结果，生成简短、描述性、可人工复核的媒体 alt text 与 Shopify 商品页交接字段。需要 Python 3.9+；不需要 Shopify 账号、API 或网络。

输入与输出

输入为 media_audit.json、产品标题、场景标签、颜色/材质字段和 approver。输出 video_seo_pack.json 与 video_seo_pack.md，包含 alt text、poster 字段、推荐展示位置、缺口和固定 publish_ready: false。

安装与导入

将本目录导入智能体环境；运行 python scripts/build_video_seo_pack.py --input examples/input.json --output-dir out。

执行步骤

1. 1. 读取媒体审计结果和产品上下文。
2. 组合产品名称、场景和关键属性，生成不超过 125 字符的候选 alt text。
3. 输出人工复核的媒体 SEO 交接包，任何 block、review 或缺审批都不会标记为可发布。

错误恢复

缺少 audit、product 或 scene_labels 时返回非零退出码；补齐脱敏数据后重跑。输出目录可重建，不覆盖输入。

权限与隐私边界

不调用 Shopify、不保存客户信息、不修改媒体、不上传 alt text、不改主题。生成的 alt text 是候选文案，必须由人工确认其准确性、语言和展示上下文。

验收

示例运行应生成 JSON/Markdown，alt text 不超过 125 字符，并固定 publish_ready: false。