JP

Amazon日本キーワード検索

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

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

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

概要

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

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

データについて

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

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

結果の例

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

商品ID商品タイトル現在価格評価スコアキーワード広告タグ
B0BKPXSKNQ-JP【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰JP¥56,5663.8ipad miniいいえ
B09G9FPHY6-JPApple iPad mini(A17 Pro)Wi-Fi 128GB スペースグレイJP¥78,8004.7ipad miniいいえ

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

活用例

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

適用範囲と境界

1タスクにつきamazon.co.jpの検索結果URLを1件、期待件数は1~10000。実際に返るカード数はこの件数を超えません。公開の日本マーケットプレイス検索結果の出品に限定されます。

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

失敗時の処理

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

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

入力

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

  • Amazon日本の検索結果URLsearch_url必須string
    完全なHTTPSのAmazon日本検索結果ページURL。amazon.co.jpの検索結果ページである必要があり、最大512文字です。
    例https://www.amazon.co.jp/s?k=ipad+mini
  • 期待結果件数crawl_count必須string
    期待する検索結果の商品数を1~10000で指定します。実際に返る件数はこの値を超えません。
    例1

出力

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

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

サンプルデータ

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

output.example
{
  "ad_tag": false,
  "biz_id": "https://www.amazon.co.jp/s?k=ipad+mini",
  "crawl_rate": "running",
  "crawl_time": "2026-09-02T10:54:24",
  "current_price": "JP¥56,566",
  "delivery": "免费配送, 预计明天, 9月3日送达",
  "image_url": "https://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpg",
  "in_stock": "<in_stock>",
  "item_id": "https://www.amazon.co.jp/s?k=ipad+mini",
  "keyword": "ipad mini",
  "original_price": "<original_price>",
  "product_id": "B0BKPXSKNQ-JP",
  "product_title": "【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰",
  "rating_count": "193",
  "rating_score": "3.8",
  "recent_purchase": "过去一个月有50+顾客购买",
  "search_front_category": "<search_front_category>",
  "shipping_free": "<shipping_free>",
  "shipping_price": "<shipping_price>",
  "site_code": "JP",
  "sku_id": "B0BKPXSKNQ-JP",
  "source_crawl_time": "1788317664075",
  "listing_status": "有效",
  "source_item": "https://www.amazon.co.jp/s?k=ipad+mini",
  "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-jp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

1回のタスク

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

$0.001/ 回
返却1件

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

$0.003/ 20 件

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

Credits を確認

今すぐ試す

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

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