linkfox-amazon-search-by-image

Amazon 画像検索

このスキルでは、画像 URL を使って Amazon で視覚的な商品検索を行う方法を説明します。Amazon の販売者や調査担当者が、複数のマーケットプレイスで見た目のよく似た商品を見つけられるようにします。

基本概念

Amazon 画像検索（ビジュアル検索）では、商品の画像 URL を送信すると、見た目のよく似た Amazon の商品リスティングを取得できます。競合分析、代替商品の調達、偽造品の特定、商品の見た目に基づく市場機会の発見に非常に役立ちます。

このツールは8 つの Amazon マーケットプレイスを検索し、ASIN、タイトル、画像、価格、評価、レビュー数、ブランドなどの Amazon ストアフロントデータを返します。Keepa データは ASIN ごとに別途クエリされるため、Keepa の障害やクォータ待ちが画像検索リクエストの失敗につながることはありません。

対応マーケットプレイス

マーケットプレイス	ドメイン	デフォルトの郵便番号
アメリカ合衆国	amazon.com	10001
イギリス	amazon.co.uk	EC1A 1BB
ドイツ	amazon.de	10115
フランス	amazon.fr	75001
イタリア	amazon.it	00100
スペイン	amazon.es	28001
日本	amazon.co.jp	100-0001
インド	amazon.in	110034

デフォルトのマーケットプレイスは amazon.com（アメリカ）です。ユーザーがマーケットプレイスを指定しない場合は、amazon.com を使用してください。

パラメーターガイド

パラメーター	必須	説明
imageUrl	はい	検索に使用する、有効で一般公開されている画像 URL
amazonDomain	はい	Amazon マーケットプレイスのドメイン（例：amazon.com、amazon.de）。デフォルトは amazon.com
sort	いいえ	検索結果の並べ替え順。使用できる値：default、price-asc-rank、price-desc-rank、rating-asc-rank、rating-desc-rank、ratings-asc-rank、ratings-desc-rank
deliveryZip	いいえ	マーケットプレイスの国における配送先の郵便番号。指定がない場合は、マーケットプレイスのデフォルト値を使用します
countryOrAreaCode	いいえ	越境配送に使用する国／地域コード（例：CN、JP、KR）。deliveryZip と同時には使用できません。注：インドのマーケットプレイスは越境配送に対応していません

aggregateByKeepaData は非推奨です。送信しないでください。月間販売数、BSR、FBA 手数料、寸法、または現在の商品詳細が必要な場合は、画像検索後に選択した ASIN を使って linkfox-keepa-product-request を使用してください。価格または BSR の履歴には、linkfox-keepa-product-series を使用してください。

並べ替えオプション

値	説明
default	デフォルトの関連性順
price-asc-rank	価格：安い順
price-desc-rank	価格：高い順
rating-asc-rank	評価：低い順
rating-desc-rank	評価：高い順
ratings-asc-rank	レビュー数：少ない順
ratings-desc-rank	レビュー数：多い順

重要：指定された並べ替え順が上記の対応リストにない場合、補うために他のツールや回避策を使用しないでください。対応している並べ替えオプションをユーザーに伝えてください。

呼び出し方法

• API エンドポイント：POST /amazon/searchByImage（完全なパラメーター／レスポンス／エラーコードは references/api.md を参照）
• Python スクリプト：python scripts/amazon_search_by_image.py '<JSON パラメーター>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッション内では、同じパラメーターの組み合わせに対してデフォルトで 1 回だけ呼び出します。スクリプトには 24 時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードの自動変更、ページ送り、郵便番号の変更による連続検索をしてはいけません。検索を続ける必要がある場合は、追加のコストが発生することを先にユーザーに伝えてください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-amazon-search-by-image-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動で集約します。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーにしてください）
• レスポンス本文が 8 KB 以下の場合：ファイルへの書き込み後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルへの書き込み後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を付けると、stdout に全量を強制出力します（同様にファイルにも書き込みます）

データの読み取りに関する推奨事項：まず要約を確認し、十分かどうか判断してください。具体的なフィールドが必要な場合は、JSON 全体をコンテキストに読み込むのを避けるため、保存された json ファイルから jqまたはConvertFrom-Json を使って必要なデータを抽出してください。

認証と計算リソースの問題の解決

次の異常が発生した場合は、references/onboarding.md に従って解決方法を案内してください：

例外的なケース

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• 401 または 402 のステータスコードが返される
• 計算リソースまたは残高が不足しているという応答：メッセージに「計算リソース残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または類似の内容が含まれている場合です。

ローカル画像のアップロード

このツールには、一般公開されている画像 URLが必要です。ユーザーがローカル画像ファイルのパス（例：C:\Users\...\photo.png、/home/.../image.jpg）を指定した場合は、まずアップロードして公開 URL を取得する必要があります。

アップロードスクリプトを実行します：

python scripts/upload_image.py /path/to/local/image.png

スクリプトから、画像 URL パラメーターとして使用できる公開 URL（24 時間有効）が返されます。

使用例

1. 米国マーケットプレイスでの基本的な画像検索

Search Amazon US for products that look similar to this image:
https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg

2. 特定のマーケットプレイスで類似商品を検索

Search Amazon Germany (amazon.de) for products visually similar to this image:
https://example.com/product-photo.jpg

3. 価格の安い順で画像検索

Find similar products on Amazon US for this image, sorted by price from low to high:
https://example.com/my-product.jpg

4. 越境配送商品の検索

Search Amazon Japan for similar products to this image, with delivery to China:
https://example.com/item.jpg

5. 競合類似商品の検索

I found this product image on a competitor's listing. Find me all similar-looking products on Amazon UK:
https://example.com/competitor.jpg

表示ルール

1. データを明確に表示する：検索結果を、適切に構成されたテーブルで表示します。優先する列は、商品画像、タイトル、ASIN、価格、評価、レビュー数、ブランドです。
2. 画像の表示：応答に商品の imageUrl が含まれている場合は、ユーザーが結果を視覚的に比較できるよう、インラインで表示します。
3. 価格と通貨：価格には必ず通貨コードを併記します（例：$29.99 USD、24.99 EUR）。
4. Keepa への引き継ぎ：トップレベルの message に従います。月間販売数、BSR、FBA 手数料、寸法、または最新の商品詳細については、選択された ASIN に対して linkfox-keepa-product-request を案内します。価格または BSR の履歴をユーザーが求めている場合に限り、linkfox-keepa-product-series に言及します。aggregateByKeepaData は渡さないでください。
5. 結果件数：見つかった結果の合計件数（total／totalCount）を必ずユーザーに伝えます。
6. エラー処理：クエリに失敗した場合は、問題を説明し、画像 URL が有効で一般公開されていることを確認するよう提案します。
7. 並べ替えの制限：ユーザーが対応リストにない並べ替え順を希望した場合は、対応している並べ替え方法を明確に説明し、未対応の回避策を試みないでください。
8. 二次処理なし：このツールの結果はデータベースに保存されないため、二次的な SQL 処理は利用できません。

ユーザーの表現とシナリオのクイックリファレンス

該当する -- Amazon のビジュアル商品検索シナリオ：

ユーザーの発言	シナリオ
「この画像に似た商品を探して」	基本的な画像検索
「画像で検索」「Amazon で逆画像検索」	ビジュアル検索
「競合の類似商品を探して」「同じスタイルの商品を探して」	外観による競合分析
「Amazon でこれに似た商品はある？」	商品発見
「見た目が同じで、もっと安い代替品を探して」	価格に基づくビジュアル比較
「この商品画像を Amazon JP／DE／UK で検索して」	マーケットプレイス横断のビジュアル検索
「類似商品の Keepa データを表示して」	まず画像検索を実行し、その後、ユーザーが選択した ASIN に適切な Keepa スキルを使用します
「この写真に似た商品を、評価順で探して」	並べ替え可能なビジュアル検索

該当しない -- 画像による商品検索の範囲を超える依頼：

• Amazon のテキストベースのキーワード検索（キーワード検索ツールを使用してください）
• ABA 検索語句データの分析
• 商品レビュー分析や商品掲載情報の最適化
• 元画像を使わない売上推定
• 画像編集や画像生成
• ローカル画像ファイルを使った検索（このツールには一般公開されている URL が必要です）

適用範囲の判断：「類似商品を探して」や「競合分析」と言われた場合でも、画像 URL が提供され、Amazon の見た目が似ている商品を探す意図であれば、このスキルが該当します。キーワード検索、売上データ分析、または画像を使わない商品調査を依頼している場合は該当しません。

計算リソース消費ルール

画像検索では、15 計算リソースを消費します。Keepa のクエリと画像検索は別々に課金されます。具体的な ASIN の検索が必要であることをユーザーが確認した場合に限り、対応する Keepa スキルの計算リソースルールに従って実行します。

重要：本スキルのサービス料金は倍数に応じて変動し、一度に大量の計算リソースを消費する可能性があります。必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、フィードバック API を通じてフィードバックを自動検出し、報告します。

1. このスキルで説明されている機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルに対する不満または称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載された方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境ECスキルをさらにご利用になるには、LinkFox Skills を設定してください。