mcpField
A
amazon-research

amazon-research

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

amazon-research について

amazon-research は Crawlora API 経由で Amazon の商品情報を調べるスキルです。商品検索、ASIN による詳細取得、価格や在庫、レビューサンプル、検索候補の確認に対応します。

主な機能

  1. 01キーワードで商品を検索
  2. 02ASIN で商品詳細を取得
  3. 03価格と在庫を確認
  4. 04レビューサンプルを取得
  5. 05Amazon の検索候補を取得

活用シーン

  1. 01Amazon 商品の価格比較
  2. 02商品候補のリスト作成
  3. 03既知の ASIN の在庫確認
  4. 04商品検索前のキーワード拡張

インストール

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

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

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

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

詳細

Amazon 商品調査

Crawlora API から、Amazon の商品を検索・照会できます。価格、在庫状況、概要データ、インラインレビュー、検索候補を、HTML スクレイピングなしで正規化された JSON として取得します。

このスキルを使用する場面

  • 「Amazon では X はいくらですか？」／「Amazon でこの商品を探してください。」
  • 「Amazon で X を検索して、候補の出品商品を返してください。」
  • 「この ASIN を調べてください」／「B0XXXXXXX の価格と在庫状況を取得してください。」
  • 「このキーワードで Amazon のオートコンプリートには何が表示されますか？」
  • Amazon に絞った競合価格やカタログの調査。

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

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

仕組み

  1. 検索 — /amazon/search にキーワード（k）を指定して、候補商品を検索します。page でページを切り替え、s で並べ替えます。
  2. 詳細 — /amazon/product/{asin} で特定商品の価格、在庫状況、概要データ、インラインレビューのサンプル、説明コンテンツを取得します。必要に応じて currency／language で絞り込みます。
  3. 候補の取得 — /amazon/suggest/{keyword} で Amazon 独自の入力中キーワード候補を取得します。詳細検索を実行する前に関連する検索語を探すのに便利です。

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

API の呼び出し

# Search Amazon (GET, key=value params):
scripts/crawlora.sh /amazon/search k="standing desk" | jq '.'

# Product detail (ASIN is a path param):
scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data'

# Search suggestions (keyword is a path param):
scripts/crawlora.sh /amazon/suggest/standing | jq '.'

すべてのリクエストに scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

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

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

使用例

  • ASIN で価格を確認： /amazon/product/{asin} を呼び出し、レスポンスから price／availability を読み取ります。
  • キーワードから出品商品を検索する流れ： /amazon/suggest/{keyword} で大まかな検索語を Amazon 独自の候補語に展開し、その後、有望な候補語で /amazon/search を実行して候補の出品商品を収集します。
  • カタログ全体の調査： キーワードを指定して /amazon/search に page を渡しながらページを切り替え、各結果から asin と price を収集して価格スナップショットを作成します。

注意事項と制限

  • クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
  • 公開データのみ — Amazon の公開商品ページおよび出品ページが対象です。Amazon の利用規約を遵守してください。
  • セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコード、クエリパラメーターへの指定、コミットは決してしないでください。
  • 結果はページ分割されています。出品商品を順に取得するには、/amazon/search に page を渡してください。
  • asin と keyword はクエリパラメーターではなく パス パラメーター（URL 内に埋め込む値）です。たとえば、asin=B0XXXXXXX ではなく、最後のパスセグメントとして /amazon/product/B0XXXXXXX のように指定してください。
  • すべてのエンドポイントは amazon.com のみを対象とします。

コメント

Markdown 対応