logo
languageJPdown
menu

Amazonキーワード検索

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

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

概要

買い物客は商品ページを開く前に、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 から生成されています。

フィールド業務名称型必須デフォルト列挙値/制約例説明
search_urlAmazon検索結果URLstringはい——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日本以外のマーケットプレイス向けの、完全なHTTPSのAmazon検索結果ページURL。検索結果ページである必要があり、最大512文字、amazon.co.jpは使えません。
crawl_count期待結果件数stringはい——1期待する検索結果の商品数を1~10000で指定します。結果は20件単位の完全なバッチで返るため、実際の件数は切り上げられる場合があります。

出力

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

フィールド業務名称型例説明
ad_tag広告タグbooleanfalse検索結果カードが広告として表示されているかどうか。
biz_idビジネスIDstringhttps://www.amazon.com/s?k=laptopレコードに紐づく業務識別子。現在のデータ形では検索結果URLです。
crawl_rate収集ステータスstringrunningソースレコードとともに返る収集ステータスのテキスト。
crawl_time収集日時string2026-09-15T14:46:17この商品カードの収集時刻。ソースはタイムゾーンを示しません。
current_price現在価格string$899.99検索結果カードに表示される現在価格のテキスト。表示された通貨記号を含みます。
delivery配送stringFREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon.検索結果カードに表示される配送時期と条件。
image_url画像URLstringhttps://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg検索結果カードに表示される商品画像のURL。
in_stock在庫情報stringOnly 10 left in stock - order soon.検索結果カードに表示される在庫テキスト。
item_idアイテムIDstringhttps://www.amazon.com/s?k=laptopこのレコードが属する検索結果ページの収集項目識別子。
keywordキーワードstringlaptopこの商品カードに対応する検索キーワード。
original_price元の価格string$1,799.99検索結果カードに表示される元の価格または取消線価格のテキスト。表示された通貨記号を含みます。
product_id商品IDstringB0HG365ZZV-USこの検索結果出品の商品識別子。
product_title商品タイトルstringHP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD検索結果カードに表示される商品名。
rating_count評価数string12検索結果カードに表示される評価件数。
rating_score評価スコアstring4.8検索結果カードに表示される評価スコア。
recent_purchase最近の購入string500+ bought in past month検索結果カードに表示される最近の購入テキスト。
search_front_category先頭カテゴリstringElectronicsカードに表示される場合の検索先頭カテゴリ。
shipping_free送料無料stringFREE delivery検索結果カードに表示される送料無料のテキスト。
shipping_price送料string$0.00検索結果カードに表示される送料テキスト。
site_codeサイトコードstringUSこの出品のAmazonマーケットプレイスサイトコード。例: US。
sku_idSKU IDstringB0HG365ZZV-USこの検索結果とともに返るSKU識別子。
source_crawl_timeソース時刻string1789454777823出品とともに返るソース側の収集タイムスタンプ(テキスト)。
listing_status出品ステータスstring有效レコードとともに返る出品ステータスの原文。
source_itemソース項目stringhttps://www.amazon.com/s?k=laptopこのレコードを生んだ収集項目に対応する検索結果URL。
no_dataデータなしフラグbooleanfalse収集項目が一致する商品カードを返さなかったかどうか。

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "ad_tag": {
      "type": "boolean",
      "title": "広告タグ",
      "description": "検索結果カードが広告として表示されているかどうか。",
      "prefill": false
    },
    "biz_id": {
      "type": "string",
      "title": "ビジネスID",
      "description": "レコードに紐づく業務識別子。現在のデータ形では検索結果URLです。",
      "prefill": "https://www.amazon.com/s?k=laptop"
    },
    "crawl_rate": {
      "type": "string",
      "title": "収集ステータス",
      "description": "ソースレコードとともに返る収集ステータスのテキスト。",
      "prefill": "running"
    },
    "crawl_time": {
      "type": "string",
      "title": "収集日時",
      "description": "この商品カードの収集時刻。ソースはタイムゾーンを示しません。",
      "prefill": "2026-09-15T14:46:17"
    },
    "current_price": {
      "type": "string",
      "title": "現在価格",
      "description": "検索結果カードに表示される現在価格のテキスト。表示された通貨記号を含みます。",
      "prefill": "$899.99"
    },
    "delivery": {
      "type": "string",
      "title": "配送",
      "description": "検索結果カードに表示される配送時期と条件。",
      "prefill": "FREE delivery Tomorrow, Sep 16 Only 10 left in stock - order soon."
    },
    "image_url": {
      "type": "string",
      "title": "画像URL",
      "description": "検索結果カードに表示される商品画像のURL。",
      "prefill": "https://m.media-amazon.com/images/I/81bCsTL5XWL._AC_UY218_.jpg"
    },
    "in_stock": {
      "type": "string",
      "title": "在庫情報",
      "description": "検索結果カードに表示される在庫テキスト。",
      "prefill": "Only 10 left in stock - order soon."
    },
    "item_id": {
      "type": "string",
      "title": "アイテムID",
      "description": "このレコードが属する検索結果ページの収集項目識別子。",
      "prefill": "https://www.amazon.com/s?k=laptop"
    },
    "keyword": {
      "type": "string",
      "title": "キーワード",
      "description": "この商品カードに対応する検索キーワード。",
      "prefill": "laptop"
    },
    "original_price": {
      "type": "string",
      "title": "元の価格",
      "description": "検索結果カードに表示される元の価格または取消線価格のテキスト。表示された通貨記号を含みます。",
      "prefill": "$1,799.99"
    },
    "product_id": {
      "type": "string",
      "title": "商品ID",
      "description": "この検索結果出品の商品識別子。",
      "prefill": "B0HG365ZZV-US"
    },
    "product_title": {
      "type": "string",
      "title": "商品タイトル",
      "description": "検索結果カードに表示される商品名。",
      "prefill": "HP 17 Inch FHD Laptop Computer for Business & Students 32GB RAM 1TB SSD"
    },
    "rating_count": {
      "type": "string",
      "title": "評価数",
      "description": "検索結果カードに表示される評価件数。",
      "prefill": "12"
    },
    "rating_score": {
      "type": "string",
      "title": "評価スコア",
      "description": "検索結果カードに表示される評価スコア。",
      "prefill": "4.8"
    },
    "recent_purchase": {
      "type": "string",
      "title": "最近の購入",
      "description": "検索結果カードに表示される最近の購入テキスト。",
      "prefill": "500+ bought in past month"
    },
    "search_front_category": {
      "type": "string",
      "title": "先頭カテゴリ",
      "description": "カードに表示される場合の検索先頭カテゴリ。",
      "prefill": "Electronics"
    },
    "shipping_free": {
      "type": "string",
      "title": "送料無料",
      "description": "検索結果カードに表示される送料無料のテキスト。",
      "prefill": "FREE delivery"
    },
    "shipping_price": {
      "type": "string",
      "title": "送料",
      "description": "検索結果カードに表示される送料テキスト。",
      "prefill": "$0.00"
    },
    "site_code": {
      "type": "string",
      "title": "サイトコード",
      "description": "この出品のAmazonマーケットプレイスサイトコード。例: US。",
      "prefill": "US"
    },
    "sku_id": {
      "type": "string",
      "title": "SKU ID",
      "description": "この検索結果とともに返るSKU識別子。",
      "prefill": "B0HG365ZZV-US"
    },
    "source_crawl_time": {
      "type": "string",
      "title": "ソース時刻",
      "description": "出品とともに返るソース側の収集タイムスタンプ(テキスト)。",
      "prefill": "1789454777823"
    },
    "listing_status": {
      "type": "string",
      "title": "出品ステータス",
      "description": "レコードとともに返る出品ステータスの原文。",
      "prefill": "有效"
    },
    "source_item": {
      "type": "string",
      "title": "ソース項目",
      "description": "このレコードを生んだ収集項目に対応する検索結果URL。",
      "prefill": "https://www.amazon.com/s?k=laptop"
    },
    "no_data": {
      "type": "boolean",
      "title": "データなしフラグ",
      "description": "収集項目が一致する商品カードを返さなかったかどうか。",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

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

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

クライアント設定

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

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

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の 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 件から