Mercado Libre Clips 变体覆盖审计

适用场景

当 Mercado Libre 卖家需要把商品视频关联到多个刊登或颜色/尺码变体时，使用本技能检查视频是否覆盖正确的商品、是否出现跨商品复用、是否满足 Clips 的人工提交前规则。

前置条件

• - Python 3.9 或更高版本。
• 脱敏的刊登与变体 CSV。
• 每行填写视频文件名、方向、时长、音频和安全区人工检查结果。

输入与输出

输入是脱敏 CSV，至少包含 publication_id、product_id、variant_id、video_file、orientation、duration_sec、safe_zone_ok、single_product、audio_ok。输出是覆盖矩阵 JSON 和 Markdown 报告，包含按商品的变体覆盖、跨商品复用、缺失视频、时长/方向/安全区/音频问题和人工上传锁。

安装与运行

无需第三方依赖。将本目录导入支持本地 Python 技能的 Agent 环境，或直接运行：

CODEBLOCK0

脚本只处理脱敏 CSV，不登录 Mercado Libre、不上传视频、不编辑刊登、不点击发布。

处理规则

1. 1. 按 product_id 聚合刊登和变体，检查每个变体是否有视频文件。
2. 检查同一视频是否被错误地分配到不同 product_id；同一商品的不同变体可复用，但 variant_sensitive=true 且未提供变体专用视频时标记人工复核。
3. 检查是否为 vertical、时长是否不超过 60 秒、安全区、单商品展示和音频检查是否通过。
4. 生成可追踪的覆盖哈希，状态为 READY_FOR_HUMAN_UPLOAD_REVIEW 或 REVIEW_REQUIRED。

错误恢复

• - CSV 缺少必需列时退出并指出缺失列。
• 布尔字段只接受 true/false、yes/no、1/0 等明确值；其他值标记为人工复核。
• 时长无法转换为数字时标记为人工复核，不猜测媒体时长。
• 文件名只用于关联，不会读取、移动或改写原始视频。

权限、隐私与不可逆边界

仅处理用户主动提供的脱敏刊登清单和视频元数据。不得放入账号、Cookie、Token、买家信息或订单数据。脚本不执行上传、发布、删除、改名或刊登编辑；Mercado Libre 后台操作必须由有权限的卖家人工完成。

验收

使用示例运行后，应得到 clips-report.json 和 clips-report.md。JSON 必须包含 summary、items、findings、coverage_hash 和 upload_executed=false；示例应识别缺视频变体、跨商品复用或技术规则失败。