product-price-research

商品・価格調査

Amazon、 eBay、Shopify のストアフロント、Shop.app、Target、Costco、Zalando、Walmart、H&M、 Kohl's、Lululemon、Macy's、Nike、Old Navy（同じエンドポイントで Gap、Banana Republic、 Athleta も利用可能）、Sam's Club、Ulta Beauty、Wayfair、Wish、 Zappos、Zara、Adidas、Best Buy、Home Depot、Sephora、SHEIN、IKEA、Chewy にわたって、商品、価格、販売者、レビューを検索・比較できます。HTML スクレイピングは不要で、すべて Crawlora API の正規化された JSON として取得できます。Walgreens は店舗検索のみ対応しており、商品カタログはありません。

このスキルの使用場面

• 「Amazon／eBay／Target／Walmart で X はいくらですか？」または「販売者／小売業者間で X の価格を比較してください。」
• 「X の出品を見つけてください」／「この Shopify ストアを検索してください」／「このコレクションには何がありますか？」
• 「この商品または販売者のレビュー／評価を取得してください。」
• 「この商品の価格／バリエーション／在庫状況を追跡してください。」
• 競合価格、カタログ、またはマーケットプレイスのレビュー調査。
• 小売業者に独自のキーワード検索機能がない場合に、「Wayfair／Kohl's／Sam's Club でカテゴリー X を閲覧してください。」
• Nike、Zara、H&M、Old Navy／Gap／Banana Republic／Athleta、Lululemon、Ulta Beauty、Adidas、Sephora にまたがるアパレル／美容商品のカタログ検索。
• Home Depot、Best Buy、IKEA、Chewy にまたがる家庭用品／電子機器／ペット用品の検索。
• 「最寄りの Walgreens を探してください」（店舗検索のみ。商品カタログはありません）。

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーの実行前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

マーケットプレイスを選び、次にジョブを選択します。

1. 検索／発見 — キーワードで候補商品を検索するには、/amazon/search、/ebay/search、/shopify/products、 /shop-app/search、/target/search、/costco/search、/walmart/search、 /hm/search、/nike/search、/oldnavy/search（brand=on|gap|br|atで Old Navy、Gap、 Banana Republic、Athleta を検索でき、既定値は on）、 /ulta/search、/wish/search、/zappos/search、/zara/search（sectionが必須です。 WOMAN／MANなどの部門を指定します）、/zalando/search（こちらは marketが必須です。de、fr、comなどの Zalando の国別ストアフロントコードを指定します。 /zalando/marketsで一覧を取得できます）を使用します。Kohl's、Lululemon、Macy's、Sam's Club、Wayfairには キーワード検索エンドポイントがありません。代わりにカテゴリを参照してください。 /kohls/category（ファセットから後続のカテゴリ文字列を取得できます）、 /lululemon/categories → /lululemon/category、/samsclub/departments → /samsclub/category、/wayfair/categories → /wayfair/categoryを使用します。 Macy'sは検索もカテゴリ参照もできません。利用できるのは、直接の productId検索（下記）と、入力補完の/macys/suggestのみです。 /adidas/search（queryまたはcategoryのどちらか一方が必須）、 /bestbuy/search（q）、/homedepot/search（q）、/sephora/search （queryに加え、brand／filter／price_minとprice_maxのペア／ rating_min／is_newのファセット）、/ikea/search （q。または、IKEAの商品番号を指定すると直接検索できます）、 /chewy/search（q。たとえば「dog food」のようにカテゴリに強く一致する検索語は、 そのカテゴリの一覧に自動的にリダイレクトされます）も検索に利用できます。 Walgreensには商品カタログがありません。利用できるのは、店舗検索用の /walgreens/stores（緯度／経度または郵便番号）のみです。
2. 詳細 — 特定の商品を取得して、価格、バリエーション、仕様を確認します （/amazon/product、/ebay/item、 /shopify/products/{handle}、/shop-app/products/{id}、 /target/product（tcin）、/costco/product/{id}、/walmart/product/{item_id}、 /zalando/product（skuとmarket）、/hm/product/{product_id}、 /nike/product（slugとstyle_color）、/oldnavy/product（pidとbrand）、 /lululemon/product/{product_id}、/macys/product/{productId}、 /samsclub/product/{id}、/ulta/product/{productId}、/wayfair/product/{id}、 /wish/product/{id}、/zappos/product/{productId}、/zara/product/{productId}、 /adidas/product（product_id）、/bestbuy/product（sku）、 /homedepot/product/{id}、/sephora/product（product_id — SKUのみではなく、 lip-sleeping-mask-P420652のような商品ページの完全なスラッグ）、 /shein/products/detail（goods_idとgoods_sn）、/ikea/product （item_no）、/chewy/product（id））。 Kohl'sには独立した商品詳細エンドポイントがありません。商品カード（下記のレビュー取得に必要な web_idを含む）は、/kohls/categoryの一覧に埋め込まれた形でのみ返されます。
3. 販売者 — eBay／Shop.appでは、販売者／ショップ（/ebay/seller/...、 /shop-app/shops/{handle}）を取得して、出品内容を比較します。
4. レビュー — 利用可能な場合は、商品のレビュー／販売者の評価を取得します （/shop-app/products/{id}/reviews、/ebay/seller/.../feedback、 /target/reviews、/costco/product/{id}/reviews、/walmart/product/{item_id}/reviews、 /kohls/product/reviews（web_id）、/macys/product/reviews（product_id）、 /nike/product/reviews（slugとstyle_color）、/oldnavy/product/reviews （pidとbrand）、/ulta/product/reviews（product_id）、/wish/product/{id}/reviews）。 H&M、Lululemon、Sam's Club、Zapposでは、レビューがある場合、独立したエンドポイントではなく、 各商品の詳細取得結果に埋め込まれます。WayfairとZaraではレビューを取得できません。 Wayfairの商品詳細には総合評価のみが含まれます。/bestbuy/product/reviews（sku）、 /sephora/product/reviews（product_id）、/ikea/reviews （item_no）では、これら3つのレビューを個別に取得できます。Home DepotとChewyでは、 レビューが各商品の詳細取得結果に埋め込まれます。Adidasのレビューと評価の概要は、 /adidas/product/reviewsで取得できます。検索結果のmodel_numberを使用してください （SKUではありません）。/adidas/product/review-topicsでモデルごとのレビューのトピックを確認できます。 ロケールによってレビューの言語が変わり、レビューのサンプルが空になる場合があります。 このカタログでは、SHEINのレビューを取得するエンドポイントはありません。
5. JSONのフィールド（価格、通貨、評価、販売者）を比較して、回答します。 エンドポイント、メソッド、パラメーターの全一覧：reference/endpoints.md。

API の呼び出し

# Search a marketplace (GET, key=value params):
scripts/crawlora.sh /amazon/search k="standing desk" | jq '.'
scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'
scripts/crawlora.sh /shop-app/search query="running shoes" | jq '.'
scripts/crawlora.sh /target/search q="standing desk" | jq '.'
scripts/crawlora.sh /walmart/search q="standing desk" | jq '.'
scripts/crawlora.sh /zalando/search q="running shoes" market=de | jq '.'
scripts/crawlora.sh /nike/search keyword="running shoes" | jq '.'
scripts/crawlora.sh /ulta/search query="retinol serum" | jq '.'
scripts/crawlora.sh /bestbuy/search q="laptop" | jq '.'
scripts/crawlora.sh /sephora/search query="retinol serum" | jq '.'
scripts/crawlora.sh /chewy/search q="salmon dog food" | jq '.'

# Product detail:
scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data'
scripts/crawlora.sh /ikea/product item_no=00263850 | jq '.'

# Category browse (no keyword search on this platform):
scripts/crawlora.sh /wayfair/category category=478390 | jq '.'
scripts/crawlora.sh /zara/category/2420463/products | jq '.'

# Store locator only (no product catalog):
scripts/crawlora.sh /walgreens/stores zip=10001 | jq '.'

すべてのリクエストに scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルで使用するすべてのエンドポイントについて、メソッド、パス、パラメーター、対応プラットフォームを含め、reference/endpoints.md を参照してください。

使用例

• マーケットプレイスをまたいだ価格比較： 同じクエリで /amazon/search と /ebay/search を検索し、それぞれから price を収集して、価格差を提示します。
• 販売者のデューデリジェンス： /ebay/seller/{seller} と /ebay/seller/{seller}/feedback を使って、購入前に販売者の評価と最近のフィードバックを要約します。
• Shopify カタログの監査： /shopify/products をページネーションで取得し、ストアのカタログと価格を一覧表示してから、しきい値を上回る商品や下回る商品にフラグを付けます。
• 検索機能のない小売業者の閲覧： キーワード検索に対応していない小売業者（Kohl's、Wayfair、Sam's Club）では、まずカテゴリ／部門の検出エンドポイント（/kohls/category のファセット、/wayfair/categories、/samsclub/departments）を呼び出してカテゴリ ID を特定し、キーワード検索を試す代わりに、そのカテゴリを直接閲覧します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開されている商品／出品ページのみを対象とし、各マーケットプレイスの利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
• 結果はページネーションで返されます。出品一覧を取得するには、page（および対応している場合は count）を指定してください。
• Zalando では常に market が必要です（デフォルトのストアフロントはありません）。不明な場合は /zalando/markets で有効なコードを確認してください。
• Macy's には検索機能もカテゴリ閲覧機能もありません — 使用できるのは /macys/product/{productId}（既知の productId が必要）と、入力に応じた候補を返す /macys/suggest のみです。
• Wayfair には検索機能もレビュー用エンドポイントもありません — 使用できるのは /wayfair/categories → /wayfair/category と /wayfair/product/{id} のみです。後者には総合評価が含まれますが、レビュー本文はありません。
• Kohl's には検索機能も独立した商品詳細エンドポイントもありません — /kohls/category を閲覧してください（category パラメーターには + で連結した分類文字列を指定し、+ は %2B としてパーセントエンコードします）。商品カードは一覧から取得してください。/kohls/product/reviews には、その一覧にある web_id が必要です。
• Sam's Club にはキーワード検索エンドポイントがありません — /samsclub/departments または /samsclub/category から開始してください。また、専用のレビュー用エンドポイントもなく、評価／レビュー件数は /samsclub/product/{id} からのみ取得できます。
• Lululemon にはキーワード検索エンドポイントがありません — /lululemon/categories → /lululemon/category を使って閲覧してください。レビューは個別の呼び出しではなく、/lululemon/product/{product_id} に含まれています。
• Zara の /zara/search では section（WOMAN などの部門）が必須です。また、Zara にはレビュー用エンドポイントがありません。
• Old Navy のエンドポイントは 4 つのストアフロントで共通です — brand=on|gap|br|at（Old Navy／Gap／Banana Republic／Athleta。デフォルトは on）を指定してください。あるブランドで見つかった cid／pid は、その同じブランドでのみ使用できます。

AliExpress の商品と属性の比較

属性 ID と値 ID を検索に適用する前に、対象のクエリに対して aliexpress_search_filters を取得してください。属性のペアはクエリごとに異なり、各グループにつき値は最大 1 つ、ペアは最大 5 つまで指定できます。他の検索で取得したファセット識別子を再利用しないでください。出品バリエーション、通貨（検索価格フィルターは USD を使用）、販売者／商品の状態に関する情報、送料の基準、返されたソース識別子を保持してください。レビューのサンプルだけでは販売者の本人確認や通常の配送所要時間の証明にはなりません。Choice／送料無料のフラグはソース側のラベルです。表示された送料や合計金額も、配送先やチェックアウト条件によって変わる場合があります。保証された最終支払額や、並べ替え順から推測した取引量ではなく、実際に確認された出品内容を比較してください。

scripts/crawlora.sh /aliexpress/search-filters q="usb c hub"
scripts/crawlora.sh /aliexpress/search q="usb c hub" page=1 sort=best_match