mcpField
W
walmart-research

walmart-research

github.com/crawlora-orgその他141 回インストール今日更新
リポジトリ

walmart-research について

Crawlora APIを通じてWalmartの商品を調査するスキルです。HTMLをスクレイピングせず、正規化されたJSONで価格、在庫、商品情報、レビューを比較できます。

主な機能

  1. 01Walmartの商品一覧を検索
  2. 02商品詳細と在庫の取得
  3. 03評価とレビュー例の集計
  4. 04ページ送りによる商品調査

活用シーン

  1. 01Walmartの商品価格の比較
  2. 02商品の現在の在庫確認
  3. 03推薦前の評価とレビュー確認
  4. 04検索結果から候補カタログを作成

インストール

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

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill walmart-research

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

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

Walmart のリサーチ

Walmart の商品、価格、レビューを調べて比較できます。すべて Crawlora API から取得した正規化済み JSON 形式で、HTML のスクレイピングは不要です。

このスキルを使う場面

  • 「Walmart で X はいくらですか？」または「Walmart で X の価格を比較して。」
  • 「Walmart で X の商品掲載を探して」／「Walmart でこの商品を検索して。」
  • 「この Walmart の商品のレビュー／評価を取得して。」
  • 「この Walmart の商品の価格／在庫状況を追跡して。」
  • Walmart の競合価格調査やカタログ調査。

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

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

仕組み

  1. 検索／検出 — /walmart/search（q が必須）で、キーワードに一致する候補商品を探します。
  2. 詳細 — /walmart/product/{item_id}（Walmart の /ip/{id} URL に含まれる数値 ID）を使って特定の商品を取得し、価格、在庫状況、ブランド、画像、評価、販売者、説明、特徴、仕様、バリエーションを確認します。
  3. レビュー — /walmart/product/{item_id}/reviews でページ上のレビュー概要を取得します。平均評価、レビュー総数、星ごとの内訳、おすすめ率、評価の高い／低いレビュー、最近のレビューのサンプルが含まれます。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Search Walmart (GET, key=value params):
scripts/crawlora.sh /walmart/search q="standing desk" | jq '.'

# Product detail (item_id is a path segment, not a query param):
scripts/crawlora.sh /walmart/product/414781783 | jq '.data'

# Product reviews:
scripts/crawlora.sh /walmart/product/414781783/reviews | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。これにより、API キーをコマンドライン引数に含めずに済みます。

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

このスキルで使う Walmart のすべてのエンドポイント（メソッド、パス、パラメーター、説明）については、reference/endpoints.md を参照してください。

例

  • 価格の確認： 商品名で /walmart/search を検索し、最も一致する商品の item_id を取得してから、/walmart/product/{item_id} で現在の価格と在庫状況を確認します。
  • レビューの要約： 推奨する前に、/walmart/product/{item_id}/reviews で商品の平均評価、評価の内訳、評価の高い／低いレビューを要約します。
  • カタログの一括調査： 複数の検索語句について /walmart/search の page を使ってページネーションし、候補リストを作成してから、各商品に対して /walmart/product/{item_id} を取得して価格を比較します。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。キーは https://crawlora.net で取得してください。
  • 公開データのみ — Walmart の公開商品ページ／検索ページを対象とします。Walmart の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY にのみ設定してください。ハードコード、クエリパラメーターへの指定、コミットはしないでください。
  • 検索結果はページネーションされます。page を指定して掲載内容を順に取得してください。
  • 詳細とレビューの取得には item_id が必要です — Walmart の /ip/{id} 商品 URL に含まれる数値 ID を指定してください。商品スラッグではありません。
  • レビューはページ上の単一スナップショットで、ページネーションされたフィードではありません — レビューのない商品は、件数がゼロでレビューリストが空になります。

コメント

Markdown 対応