JP

Amazonキーワード検索

日本以外のAmazon検索結果URLと期待件数を指定すると、商品タイトル、価格、評価、配送、出品情報を取得します。

翻訳済み · ja-JP原文を表示

開発者
料金
$0.001 / 20 件から
最終更新
2026-09-18

概要

買い物客は商品ページを開く前に、Amazonの検索カードで判断します。タイトル、表示価格、評価、配送案内、広告表示の有無です。このアプリは日本以外のAmazon検索結果リンクを、公開検索カードの表にまとめ、品揃え・価格・露出の検討を顧客が見る検索画面から始められるようにします。

データセットはキーワード、サイトコード、検索リンクを各商品の横に残すため、後からの比較もその検索に結び付けられます。検索結果の作業台であり、商品詳細ページの代わりではありません。

データについて

各行は、日本以外の公開Amazon検索結果ページにある商品カード1件です。収集時刻の早い順に並び、同じ商品IDは1回だけ残します。現在価格と元の価格はカード上のテキストで、表示された通貨記号を含みます。正規化済みの数値ではなく、後の詳細ページ価格や税・クーポンと異なる場合があります。配送、送料無料、送料、在庫情報は収集時点のカード内容です。収集日時にタイムゾーンはありません。キーワード、ビジネスID、アイテムID、ソース項目は同一検索の行で繰り返されます。出品ステータスは原文のまま返ります。

日本サイト、商品詳細、バリエーション、レビュー、注文、出品者管理画面、公開検索に出ていないカードは含まれません。データなしフラグは、カードが0件だった検索項目と通常の商品行を区別します。

結果の例

各行は検索結果の商品カード1件です。

商品ID商品タイトル現在価格評価スコアキーワード広告タグ
B0HG365ZZV-USHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD$899.994.8laptopいいえ
B0H72JH23T-USHP 14 inch Laptop, 4GB DDR5 RAM, 128GB SSD, Intel N150 Processor$299.995.0laptopいいえ

元の価格、配送、評価数、サイトコード、在庫情報も、カードに表示されている場合は利用できます。

活用例

  • 品揃え確認では、キーワードとサイトコードで行をまとめ、商品タイトルと商品IDを見て、その検索の上位にどの商品があるかを把握します。
  • 表示価格の比較では、現在価格を元の価格と評価スコアと並べ、プロモーションに見えるカードと通常価格のカードを見分けます。
  • 露出確認では、広告タグで絞り、商品タイトルと配送を読んで、スポンサー枠と通常枠の見せ方を確認します。
  • 在庫確認では、在庫情報、最近の購入、送料無料を合わせて、欠品や配送特典のシグナルを読みます。

適用範囲と境界

1タスクにつき日本以外のAmazon検索結果URLを1件、期待件数は1~10000。結果は20件単位の完全なバッチで返るため切り上げられる場合があり、amazon.co.jpは非対応、公開検索結果の出品に限定されます。

  • 適している用途
  • 日本以外のAmazonキーワード検索結果ページから商品カードが必要なとき。
  • 検索クエリの表示価格、評価、配送案内、広告掲載を比較したいとき。
  • 適さない用途
  • 商品詳細、バリエーション、レビュー、価格履歴が必要な場合。このAppは検索結果カード情報のみを返します。
  • 日本サイト、注文、出品者管理画面のデータが必要な場合。このAppは日本以外の公開検索出品のみを対象とします。

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1商品カードが0件のときは、リンクが日本以外の公開Amazon検索結果ページか確認し、より短いまたは広い検索語を試してください。
  2. 2部分成功後は完了済みレコードを保持し、失敗または期限切れ後は同じ入力で再提出してください。
  3. 3レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください。
  4. 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • Amazon検索結果URLsearch_url必須string
    日本以外のマーケットプレイス向けの、完全なHTTPSのAmazon検索結果ページURL。検索結果ページである必要があり、最大512文字、amazon.co.jpは使えません。
    例https://www.amazon.com/s?k=ipad+mini&crid=3F8PFA9JP0GNF&sprefix=ipad%2Caps%2C387&ref=nb_sb_ss_p13n-expert-pd-ops-ranker_7_4
  • 期待結果件数crawl_count必須string
    期待する検索結果の商品数を1~10000で指定します。結果は20件単位の完全なバッチで返るため、実際の件数は切り上げられる場合があります。
    例1

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

  • 広告タグad_tagboolean
    検索結果カードが広告として表示されているかどうか。
    例false
  • ビジネスIDbiz_idstring
    レコードに紐づく業務識別子。現在のデータ形では検索結果URLです。
    例https://www.amazon.com/s?k=laptop
  • 収集ステータスcrawl_ratestring
    ソースレコードとともに返る収集ステータスのテキスト。
    例running
  • 収集日時crawl_timestring
    この商品カードの収集時刻。ソースはタイムゾーンを示しません。
    例2026-09-15T14:46:17

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "ad_tag": false,
  "biz_id": "https://www.amazon.com/s?k=laptop",
  "crawl_rate": "running",
  "crawl_time": "2026-09-15T14:46:17",
  "current_price": "$899.99",
  "delivery": "FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon.",
  "image_url": "https://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg",
  "in_stock": "Only 10 left in stock - order soon.",
  "item_id": "https://www.amazon.com/s?k=laptop",
  "keyword": "laptop",
  "original_price": "$1,799.99",
  "product_id": "B0HG365ZZV-US",
  "product_title": "HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD",
  "rating_count": "12",
  "rating_score": "4.8",
  "recent_purchase": "500+ bought in past month",
  "search_front_category": "Electronics",
  "shipping_free": "FREE delivery",
  "shipping_price": "$0.00",
  "site_code": "US",
  "sku_id": "B0HG365ZZV-US",
  "source_crawl_time": "1789454777823",
  "listing_status": "有效",
  "source_item": "https://www.amazon.com/s?k=laptop",
  "no_data": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=meme_today/amazon-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。

detail.access.mcp.composeHint

料金

返却20件

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。

$0.001/ 20 件
Per task submitted

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.001 / 20 件から