Pinterest商品视频目录审计

场景与前置条件

用于 Pinterest 商品目录和商品 Pin 上线前的本地字段审计。需要 Python 3.9+ 与脱敏的商品目录 JSON；不需要 Pinterest 登录、API 或网络。

输入与输出

输入为 products 数组，支持商品 ID、标题、描述、落地页、主图、价格、库存、变体组和商品视频链接。输出 pinterest_feed_audit.json，逐项给出 PASS/REVIEW/BLOCK、缺失字段、可修复建议和稳定哈希。

安装与导入

将本目录导入智能体环境，运行 python scripts/audit_pinterest_feed.py --input examples/input.json --output pinterest_feed_audit.json。

执行步骤

1. 1. 读取商品目录登记和视频链接元数据。
2. 校验 Pinterest 目录必填字段、URL、价格/库存值、变体组以及 MP4/MOV/M4V 视频链接和 2GB 登记边界。
3. 输出可交给下一步的审计 JSON；不把“目录已上传”或“视频可访问”当作本地事实。

错误恢复

输入不是 JSON 或缺少 products 数组时返回非零退出码；修复脱敏目录后重跑。不会上传目录、访问商品页或更改店铺数据。

权限与隐私边界

只处理买家提供的商品字段和视频文件元数据，不读取账号、不访问客户数据、不上传目录、不调用 Pinterest API。买家需自行确认图片、视频、品牌、价格、库存及落地页的真实性与授权。

验收

示例运行应输出必填字段 findings，并能识别缺少 id、落地页、主图、价格/库存、变体组、视频扩展名、超长 URL 和视频大小登记等问题，默认 publish_ready=false。