Amazon Listing Image Optimizer 用于自动修复亚马逊商品 Listing 中的非正方形图片：下载原始图片、将图片填充至 2000×2000 白色背景，并通过 SP-API 推送回线上 Listing，无需手动在 Seller Central 中操作。
用途 亚马逊对使用非正方形图片（宽高比不等于 1:1）的 Listing 进行处罚。常见问题包括：横向 16:9 或 4:3 商品图、纵向主图、分辨率过低的图片。该技能可自动检测、修复并重新上传这些问题图片。
主要能力
- 检测非正方形图片：audit.js 脚本可审计单个 SKU 或全部 FBA SKU，输出不符合规范的图片槽位及其尺寸，可保存为报告。- 本地修复图片：pad_to_square.py 脚本将 *_orig.jpg 填充至 2000×2000 白色背景，输出 *_fixed.jpg。- 上传修复后图片：push_images.js 通过临时 HTTP 服务器向 SP-API 提交图片 URL，服务器在 15 分钟后自动关闭（留出亚马逊抓取时间）。- 修补 Listing 标题：fix_title.js 可为指定 SKU 更新标题。- 支持整条流水线一键执行：审计全部 SKU、生成报告、本地填充图片、推送图片。
使用方式
- 安装依赖：pip3 install Pillow；npm install amazon-sp-api。2. 创建 SP-API 凭证文件，包含 lwaClientId、lwaClientSecret、refreshToken、region、marketplace、sellerId 字段。3. 通过环境变量 AMAZON_SPAPI_PATH 指向该凭证文件（默认路径为 ./amazon-sp-api.json）。4. 运行脚本：审计可使用 node scripts/audit.js --sku "MY-SKU" 或 node scripts/audit.js --all --out report.json；填充使用 python3 scripts/pad_to_square.py ./image_fix/；上传使用 node scripts/push_images.js --dir ./image_fix/ --sku "MY-SKU" --slots PT03,PT05；标题修补使用 node scripts/fix_title.js --sku "MY-SKU" --title "New optimized title here"。完整流水线为：node scripts/audit.js --all --out report.json，然后 python3 scripts/pad_to_square.py ./image_fix/，最后 node scripts/push_images.js --dir ./image_fix/ --from-report report.json。
图片槽位参考 MAIN 对应 main_product_image_locator，为主图（必须白色背景）；PT01–PT08 对应 other_product_image_locator_1 至 _8，为次要图片。
适用场景 适用于需要批量检查并修复亚马逊 Listing 图片宽高比、将其调整为 2000×2000 白色背景并回传至线上 Listing 的卖家或运营人员，尤其适合存在横向、纵向或低分辨率图片问题的 FBA SKU。
限制与注意事项
- 亚马逊在收到 ACCEPTED 响应后 15–30 分钟内处理图片更新。- 临时 HTTP 服务器要求 VPS 具有公网可访问的 IP/端口，或改用 S3/Cloudflare。- PIL 在调整尺寸时使用 LANCZOS 重采样以获得最佳质量。- 图片应保持在 10MB 以下，目标为 2000×2000 像素、95% JPEG 质量。
相关技能 skill-amazon-spapi 提供核心 SP-API 认证与订单能力。