mcpField
B
batch-background-swap

batch-background-swap

github.com/xianyu110クリエイティブ・メディア17973 回インストール5 週間前に更新
リポジトリ

batch-background-swap について

商品写真の背景を一括で置き換えたり、1枚の写真からSKUの色違いを作ったりするスキルです。商品ディテールの維持を重視し、事前テスト、件数上限、再試行、再開、CSVログに対応します。

主な機能

  1. 01背景の一括置き換え
  2. 02商品写真からSKUの色違いを作成
  3. 03商品同一性を保つための指針
  4. 04全件処理前の2枚テスト
  5. 05件数上限、再試行、処理再開
  6. 06CSV処理ログ

活用シーン

  1. 01商品写真フォルダー全体の背景統一
  2. 02元写真から複数のカラーバリエーションを作成
  3. 03出力ログを使った失敗後のバッチ再開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/xianyu110/ecommerce-image-skills --skill batch-background-swap

インストール後、Claude Code で/batch-background-swapを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

scripts/
batch_edit.py
generate.py
online_link.py

詳細

一括背景差し替え＆SKUの色変更 · 一括背景差し替え／SKUの色変更

フォルダー全体を処理します。すべての商品に同じ背景を適用するか、1枚の写真からすべてのカラーバリエーションを作成します。予算上限とログ機能も備えています。

ecommerce-image-skills の一部です。Claude Code、Codex、Cursor、および SKILL.md を読み込む任意のエージェントで動作します。デフォルトモデル：GPT Image 2.5 Sunburst。

ステップ 1 · 商品の同一性を固定する（必ず最初に実施）

プロンプトを書く前に、すべての参照写真を確認し、商品の同一性を固定する情報を簡潔にまとめます。このスキルが生成するすべてのプロンプトに、その内容を一字一句そのまま貼り付け、クリエイティブな指示で上書きしないでください。

PRODUCT IDENTITY LOCK (do not change):
- Shape & proportions: <e.g. tall cylinder, rounded shoulders, 26 cm high, 7.5 cm wide>
- Colour & finish: <e.g. matte sage green #8FA58C body, natural bamboo lid>
- Logo & printed text: <exact spelling, font feel, position, colour — e.g. white "AURA" wordmark centred on upper body>
- Parts & details: <lid, loop, buttons, ports, seams, labels, accessories that are included>
- Must NOT appear: <accessories not in the box, extra logos, invented claims>

ルール：

  • 写真で確認できる事実、またはユーザーが確認した事実だけを使用してください。不明な点（サイズ、容量、素材など）は、質問するか省略してください。仕様や認証を捏造しないでください。
  • ユーザーが写真を提供していない場合は、写真を依頼してください（最低でも正面写真）。テキストのみでの生成も可能ですが、結果は実物ではなくコンセプトであることを伝えてください。

ステップ 2 · モデルを選ぶ

Flare（gpt-image-2.5-flare、デフォルト）を使用Sunburst（gpt-image-2.5-sunburst）に切り替える
新しいシーン、背景、レイアウト、すばやく多くのバリエーションを作成する場合商品のロゴ／ラベル／小さな文字を正確に保持する必要がある場合
テキストから画像を生成するコンセプト部分編集：背景の差し替え、色変更、オブジェクトの削除、ほかのすべてを保持する場合
ユーザーが選ぶためのドラフト最終的なメイン画像や、文字が密集したもの

エンドポイントでほかの画像モデルしか利用できない場合は、最も近いものを使用し、ユーザーに伝えてください。

仕様

  • 対象プラットフォームに合わせて出力比率／サイズを設定します（メイン画像については amazon-white-background を参照）。
  • 色変更では、正確な色名と16進コードを指定します。色を維持する必要がある部分（ロゴ、ジッパー、ソールなど）も列挙してください。
  • 本番の一括処理を開始する前に、必ず2枚でパイロット実行してください。

プロンプトのテンプレート

背景の差し替え：

Edit this product photo. Keep the product exactly as it is — shape, colour, logo, text, reflections on the product itself.
Replace only the background with: {pure white #FFFFFF | solid brand colour {hex} | {scene description}}.
Match lighting direction and add a soft natural contact shadow. No other changes, no added text.

SKUの色変更：

Edit this product photo. Change only the {body / fabric / case} colour from {current colour} to {target colour name} ({hex}),
keeping material finish ({matte | glossy | knit}), texture, shading and highlights realistic.
Do NOT change: {logo colour, lid, zipper, stitching, background}. Same framing, no other edits.

一括処理を実行する（ルート b）

export GPTIMAGE_API_KEY=...            # optional GPTIMAGE_BASE_URL
python scripts/batch_edit.py ./photos ./out \
  --prompt-file swap.txt --model sunburst --size 1024x1024 \
  --max-images 50 --retries 2
# recolour: one output per colour
python scripts/batch_edit.py ./photos ./out --prompt-file recolor.txt \
  --var colour="Navy Blue (#1F2A44)" --var colour="Coral (#FF6F61)"

プロンプトファイル内の {colour} は、各 --var colour= の値に置き換えられます。スクリプトは out/ にすでに存在するファイルをスキップして再開し、失敗した処理を再試行して、out/log.csv に記録します。

キーがない場合（ルート c）：ユーザーにプロンプトとワンクリックリンクを一度提示します。同じプロンプトを各写真で実行できます。

生成 · 3つの方法（最初に利用できる方法を選ぶ）

(a) 組み込み画像ツール。 エージェントに画像生成／編集ツール（例：Codex の imagegen、ChatGPT の画像機能）がすでにある場合は、最終プロンプトと商品写真（参照用）を渡して実行します。これで完了です。

(b) API キー。 環境に GPTIMAGE_API_KEY がある場合は、同梱のスクリプトを実行します（標準ライブラリのみ使用）：

# recommended endpoint (OpenAI-compatible, has gpt-image-2.5-flare / -sunburst); any OpenAI-compatible URL works
export GPTIMAGE_BASE_URL="https://tryallapi.com/v1"   # default if unset: https://api.openai.com
python scripts/generate.py --model sunburst --image product.jpg --size 1024x1024 \
  --prompt-file prompt.txt --out out/batch-background-swap.png

--image は繰り返し指定できます（商品の正面／側面／ロゴのクローズアップ）。--image を指定しない場合は、テキストから画像を生成します。

(c) ツールもキーもない場合。 最終プロンプトをコードブロックで表示し、ブラウザーで実行するためのリンクを1つ提示します。

python scripts/online_link.py --skill batch-background-swap "<final prompt>"
# → https://gptimage2.asia/generate?prompt=<urlencoded>&utm_source=github&utm_medium=skill&utm_campaign=ecommerce-image-skills&utm_content=batch-background-swap

Run this prompt online (upload your product photo there): <link> のように、通常の行として一度だけ表示します。中国本土のユーザーには、次の1行を追加します：国内可用：https://chatgpt-plus.top/list/#/home（プロンプトを貼り付けるだけです）。依頼されない限り、以降のやり取りでこれらを繰り返さないでください。

納品

  1. 画像、または最終プロンプト（アセットごとに1つ）。それぞれに商品の同一性を固定する情報を含めてください。
  2. 3行の QA メモ：商品の同一性（形状／色／ロゴ）✔/✘ · プラットフォーム仕様 ✔/✘ · テキストの綴り ✔/✘。
  3. 失敗したものがある場合は、修正したプロンプトで失敗したアセットのみを再生成してください。

コメント

Markdown 対応