Amazon标题合规审计

适用场景与前置条件

适用于需要批量检查 Amazon Seller Central 商品标题和 Item Highlights 的卖家、品牌方与代运营团队。前置条件：Python 3.10 或更高版本；买家有权导出的脱敏 CSV，包含 SKU 或 ASIN、itemname 和可选 itemhighlights。媒体类商品的标题例外必须由买家在 policy.json 中明确标记。

输入与输出

输入：脱敏 CSV 与 policy.json。CSV 可以包含 sku、asin、parentasin、marketplace、itemname、itemhighlights、categoryis_media。policy.json 控制 75 字符标题上限、125 字符 Item Highlights 上限和高风险字符检查。

输出：amazontitleaudit.json 与 amazontitlereview.csv，逐行给出 PASS、REVIEW 或 BLOCK、字符数、重复词、发现代码、安全预览标题和不自动写回声明。

安装与执行

无需第三方依赖。运行 python scripts/audit_titles.py --csv examples/listings.csv --policy examples/policy.json --json-output examples/amazon_title_audit.json --csv-output examples/amazon_title_review.csv。

错误恢复

CSV 表头缺失或文件编码错误时，先复制为 UTF-8 CSV 并补齐 item_name；不要猜测媒体类例外。出现 BLOCK 或 REVIEW 时保留原始文件，人工核对 Amazon 后再改写或上传。

权限与隐私边界

只处理买家有权使用且已脱敏的本地文件，不登录 Seller Central，不读取 Cookie、密码或令牌，不调用 SP-API，不修改标题，不上传 Flat File，不批准 Review Listings Changes。

验收

使用 examples 中的脱敏 CSV 运行脚本，确认超长标题被识别为 BLOCK、超长 Item Highlights 或重复词被识别为 REVIEW、输出 CSV/JSON 可解析，原始 CSV 未被改写，auto_write=false。