skill-listing-image-optimizer

Amazon 出品画像オプティマイザー

Amazon の出品に使用されている正方形でない商品画像を自動修正します。画像をダウンロードし、白い背景の 2000×2000 にパディングしてから、SP-API を通じて出品中の商品に反映します。セラーセントラルでの手動作業は不要です。

---

このツールが必要な理由

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 に送信します。その後、Amazon が画像を取得する時間として 15 分待ってから、サーバーを自動的に終了します。

fix_title.js — 出品タイトルを修正

node scripts/fix_title.js --sku "MY-SKU" --title "New optimized title here"

---

一括処理（1 つのコマンド）

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	サブ画像

---

注意事項

• Amazon は ACCEPTED レスポンスを受信してから 15～30 分以内に画像の更新を処理します
• 一時 HTTP サーバーを使用するには、VPS に外部からアクセス可能な IP アドレス／ポートが必要です（または S3／Cloudflare を使用してください）
• PIL は、サイズ変更時に最高品質を得るため LANCZOS リサンプリングを使用します
• 画像は 10MB 未満にしてください。目安は 2000×2000px、JPEG 品質 95% です

関連項目

• skill-amazon-spapi — SP-API の認証と注文を扱うコア機能