linkfox-walmart-search

Walmart 商品検索

このスキルを使うと、Walmart の商品リスティングデータを検索・取得できます。これにより、EC セラーや研究者は Walmart のマーケットプレイスから、実用的なインサイトを抽出できます。

主な概念

Walmart 商品検索は、Walmart のマーケットプレイスからリアルタイムの商品リスティングデータを取得します。キーワード検索、カテゴリの閲覧、価格フィルター、並べ替えオプション、デバイス別の検索結果に対応しています。Walmart.com に表示されている最新の商品リスティングを返す、直接検索するツールです。

検索モード：キーワード、カテゴリ ID、またはその両方を組み合わせて検索できます。keyword または categoryId の少なくとも一方を指定する必要があります。

並べ替えオプション：結果は best_seller、best_match、price_low（価格の昇順）、price_high（価格の降順）で並べ替えられます。並べ替えを指定しない場合は、デフォルトの関連度順で表示されます。

ページネーション：結果はページ分割され、デフォルトのページ番号は 1 です。ページ番号の上限は 100 です。

パラメーターガイド

パラメーター	型	必須	説明
keyword	string	いいえ*	検索キーワード（最大 1024 文字）。*keyword または categoryId の少なくとも一方を指定する必要があります
categoryId	string	いいえ*	閲覧するカテゴリ ID。*keyword または categoryId の少なくとも一方を指定する必要があります。すべての部門を対象にする場合は 0 を使用します
sort	string	いいえ	並べ替え順：best_seller、best_match、price_low、price_high
page	integer	いいえ	ページ番号（1～100、デフォルトは 1）
minPrice	number	いいえ	最低価格フィルター
maxPrice	number	いいえ	最高価格フィルター
spelling	boolean	いいえ	スペル修正を有効にします（デフォルトは true）
softSort	boolean	いいえ	関連度順に並べ替えます（デフォルトは true）。無効にするには false に設定します
storeId	string	いいえ	店舗別の結果を取得するための店舗 ID
device	string	いいえ	デバイスの種類：desktop（デフォルト）、tablet、mobile
facet	string	いいえ	key:value 形式のフィルターファセット。|| で区切ります
nextDayEnabled	boolean	いいえ	NextDay 配送の結果のみを表示します（デフォルトは false）
jsonRestrictor	string	いいえ	返されるフィールドを制限する JSON フィールドリストリクター

商品データのフィールド

フィールド	説明
productId	Walmart の商品 ID
usItemId	米国の商品 ID
title	商品タイトル
description	商品の説明
price	現在の価格
wasPrice	割引前の価格
currency	通貨コード
minPrice	最低価格（複数のオプションがある商品の場合）
pricePerUnitAmount	単価
pricePerUnit	単価のラベル
rating	平均評価スコア
reviews	レビューの合計数
sellerName	販売者名
sellerId	販売者 ID
imageUrl	商品サムネイルの URL
productPageUrl	商品詳細ページの URL
sponsored	リスティングがスポンサー広告かどうか
outOfStock	商品が在庫切れかどうか
freeShipping	無料配送が利用可能かどうか
twoDayShipping	2 日配送が利用可能かどうか
freeShippingWithWalmartPlus	Walmart Plus 会員向けの無料配送
shippingPrice	配送料
multipleOptionsAvailable	商品に複数のバリエーションがあるかどうか
variantSwatches	名前と画像を含むバリエーションのリスト

使用例

1. 基本的なキーワード検索 キーワードに一致する商品を検索します：

{"keyword": "wireless earbuds"}

2. 価格で絞り込んだ検索 指定した価格帯の商品を検索します：

{"keyword": "laptop stand", "minPrice": 10, "maxPrice": 50}

3. カテゴリー内のベストセラー 人気順に並べ替えて、売れ筋商品を閲覧します：

{"keyword": "coffee maker", "sort": "best_seller"}

4. 予算重視のショッピング -- 価格の安い順 商品の最安値の候補を検索します：

{"keyword": "phone case", "sort": "price_low"}

5. ページネーションを使ったカテゴリーの閲覧 複数のページにわたって特定のカテゴリーを閲覧します：

{"categoryId": "976759_976787", "page": 2}

6. 特定店舗の在庫確認 特定のWalmart店舗で購入可能な商品を検索します：

{"keyword": "tent", "storeId": "1862"}

7. モバイル検索結果のシミュレーション モバイル端末で表示される検索結果を確認します：

{"keyword": "water bottle", "device": "mobile"}

8. 複数のフィルターの組み合わせ 複数のフィルターを適用して、検索結果を正確に絞り込みます：

{"keyword": "running shoes", "minPrice": 30, "maxPrice": 80, "sort": "best_match"}

表示ルール

1. データを明確に提示する：検索結果は、主要な項目（タイトル、価格、評価、レビュー、販売者）を含む、構成の整った表で表示します。ユーザーが分析を求めない限り、主観的な購入推奨を追加しないでください。
2. 価格の表示形式：価格は常に通貨記号を付けて表示します。wasPrice がある場合は、割引がわかるように現在価格と元の価格の両方を表示します。
3. 評価の補足情報：ユーザーが信頼性を判断できるよう、評価はレビュー件数とあわせて表示します（例：「1,230件のレビューで星4.5」）。
4. 在庫状況：在庫切れの商品を見落とさないよう、明確に示します。
5. スポンサー表示：ユーザーがオーガニック掲載と有料掲載を区別できるよう、スポンサー商品であることを表示します。
6. ページネーションの案内：検索結果の総件数が多い場合は、総件数を伝え、page パラメーターを使ってページを切り替えると、さらに結果を確認できることを案内します。
7. エラー処理：クエリが失敗した場合は、エラーの内容を明確に説明し、パラメーターの調整（キーワードの範囲を広げる、フィルターを変更するなど）を提案します。
8. 商品リンク：検索結果を表示する際は、ユーザーがWalmartの商品ページに直接移動できるよう、productPageUrl を含めます。

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

該当 -- Walmartの商品一覧に関するクエリ：

ユーザーの発言	シナリオ
「WalmartでXXを検索して」	キーワード検索
「Walmartで安いXXを探して」	価格で絞り込んだ検索
「Walmartで一番売れているXXは？」	ベストセラー順
「WalmartでXXの価格を比較して」	価格比較
「WalmartにXXの在庫はある？」	在庫確認
「Walmartで50ドル未満の商品を見せて」	価格帯での検索
「Walmartで評価の高いXXは？」	評価に基づく絞り込み
「WalmartのXXの競合商品」	競合調査

該当しない -- Walmartの商品一覧を超えるニーズ：

• Walmartの販売者アカウント管理や広告
• Walmartの注文追跡や購入履歴
• 商品レビュー本文の分析（評価と件数のみ利用可能）
• 過去の価格追跡や価格推移の分析
• WalmartのアフィリエイトやAPIキーの管理

適用範囲の判断：Walmartに関する文脈で、ユーザーが「商品調査」や「競合分析」と言い、現在の商品一覧、価格、評価、販売者情報の検索を必要としている場合、このスキルが該当します。広告戦略、アカウント指標、過去の販売データについて尋ねている場合は該当しません。

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

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決します：

異常な状況

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

計算リソースの消費ルール

計算リソースを15消費します。

ユーザーは計算リソースの消費に応じて料金を支払います。十分に評価してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

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