mcpField

skill-listing-image-optimizer

github.com/zero2ai-hub营销与增长48 次安装
代码仓库

关于 skill-listing-image-optimizer

用于 Amazon 卖家和运营人员的图片处理技能，可审计商品图片、补白至 2000 × 2000 并通过 SP-API 上传至商品页面，也可修改标题。

主要功能

  1. 01审计 SKU 图片尺寸
  2. 02将图片补白为正方形
  3. 03通过 SP-API 上传图片
  4. 04修改商品标题
  5. 05按报告执行批量处理

适用场景

  1. 01找出非正方形商品图片
  2. 02批量统一图片画布尺寸
  3. 03将修复图片提交至商品页面

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zero2ai-hub/skill-amazon-listing-optimizer --skill skill-listing-image-optimizer

安装后在 Claude Code 中输入/skill-listing-image-optimizer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
scripts/
audit.js
pad_to_square.py
push_images.js

详细介绍

Amazon 列表图片优化器

自动修复 Amazon 列表中的非正方形商品图片——下载图片，填充至 2000×2000 白色背景，然后通过 SP-API 上传回线上列表。无需手动操作 Seller Central。

为什么需要这个工具

Amazon 会降低非正方形图片（宽高比 ≠ 1:1）的列表排名。常见问题包括：

  • 横向的 16:9 或 4:3 商品照片
  • 纵向主图
  • 分辨率过低的小图

此工具可自动检测、修复并重新上传。

设置

1. 安装依赖项
pip3 install Pillow
npm install amazon-sp-api
2. 创建 SP-API 凭据文件
{
  "lwaClientId": "amzn1.application-oa2-client.YOUR_CLIENT_ID",
  "lwaClientSecret": "YOUR_CLIENT_SECRET",
  "refreshToken": "Atzr|YOUR_REFRESH_TOKEN",
  "region": "eu",
  "marketplace": "YOUR_MARKETPLACE_ID",
  "sellerId": "YOUR_SELLER_ID"
}

设置 AMAZON_SPAPI_PATH 环境变量，指向该文件（默认值：./amazon-sp-api.json）。

脚本

audit.js — 检测非正方形图片
node scripts/audit.js --sku "MY-SKU"          # audit single SKU
node scripts/audit.js --all                    # audit all FBA SKUs
node scripts/audit.js --all --out report.json  # save report

输出：不符合要求的图片槽位列表及其尺寸。

pad_to_square.py — 在本地修复图片
# After audit.js downloads originals to ./image_fix/
python3 scripts/pad_to_square.py ./image_fix/

将所有 *_orig.jpg 文件填充至 2000×2000 白色背景，并输出 *_fixed.jpg。

push_images.js — 将修复后的图片上传至 Amazon
node scripts/push_images.js --dir ./image_fix/ --sku "MY-SKU" --slots PT03,PT05

在公共端口启动本地 HTTP 服务，将图片 URL 提交至 SP-API，然后在 15 分钟后自动关闭服务（留出时间供 Amazon 抓取）。

fix_title.js — 修补列表标题
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

图片槽位参考

槽位属性说明
MAINmain_product_image_locator主图（背景必须为白色）
PT01–PT08other_product_image_locator_1 … _8辅助图片

注意事项

  • Amazon 会在收到 ACCEPTED 响应后的 15–30 分钟内处理图片更新
  • VPS 必须有可公开访问的 IP/端口，供临时 HTTP 服务使用（或使用 S3/Cloudflare）
  • PIL 使用 LANCZOS 重采样，以在调整尺寸时获得最佳画质
  • 图片应小于 10MB；建议目标尺寸为 2000×2000px，JPEG 质量设为 95%

相关项目

评论

支持 Markdown