概要
買い物客は商品ページを開く前に、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,566 | 3.8 | ipad mini | いいえ |
| B09G9FPHY6-JP | Apple iPad mini(A17 Pro)Wi-Fi 128GB スペースグレイ | JP¥78,800 | 4.7 | ipad mini | いいえ |
元の価格、配送、評価数、サイトコード、在庫情報も、カードに表示されている場合は利用できます。
活用例
- 品揃え確認では、キーワードとサイトコードで行をまとめ、商品タイトルと商品IDを見て、日本マーケットプレイスの検索上位にどの商品があるかを把握します。
- 表示価格の比較では、現在価格を元の価格と評価スコアと並べ、プロモーションに見えるカードと通常価格のカードを見分けます。
- 露出確認では、広告タグで絞り、商品タイトルと配送を読んで、スポンサー枠と通常枠の見せ方を確認します。
- 在庫確認では、在庫情報、最近の購入、送料無料を合わせて、欠品や配送特典のシグナルを読みます。
適用範囲と境界
1タスクにつきamazon.co.jpの検索結果URLを1件、期待件数は1~10000。実際に返るカード数はこの件数を超えません。公開の日本マーケットプレイス検索結果の出品に限定されます。
- 適している用途
- Amazon日本のキーワード検索結果ページから商品カードが必要なとき。
- 日本マーケットプレイスの検索クエリについて、表示価格、評価、配送案内、広告掲載を比較したいとき。
- 適さない用途
- 商品詳細、バリエーション、レビュー、価格履歴が必要な場合。このAppは検索結果カード情報のみを返します。
- 日本以外のマーケットプレイス、注文、出品者管理画面のデータが必要な場合。このAppは公開のamazon.co.jp検索出品のみを対象とします。
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1商品カードが0件のときは、リンクが公開のamazon.co.jp検索結果ページか確認し、より短いまたは広い検索語を試してください。
- 2部分成功後は完了済みレコードを保持し、失敗または期限切れ後は同じ入力で再提出してください。
- 3レート制限、一時的な利用不可、タイムアウトのあとは後で再試行してください。
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| search_url | Amazon日本の検索結果URL | string | はい | — | — | https://www.amazon.co.jp/s?k=ipad+mini | 完全なHTTPSのAmazon日本検索結果ページURL。amazon.co.jpの検索結果ページである必要があり、最大512文字です。 |
| crawl_count | 期待結果件数 | string | はい | — | — | 1 | 期待する検索結果の商品数を1~10000で指定します。実際に返る件数はこの値を超えません。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| ad_tag | 広告タグ | boolean | false | 検索結果カードが広告として表示されているかどうか。 |
| biz_id | ビジネスID | string | https://www.amazon.co.jp/s?k=ipad+mini | レコードに紐づく業務識別子。現在のデータ形では検索結果URLです。 |
| crawl_rate | 収集ステータス | string | running | ソースレコードとともに返る収集ステータスのテキスト。 |
| crawl_time | 収集日時 | string | 2026-09-02T10:54:24 | この商品カードの収集時刻。ソースはタイムゾーンを示しません。 |
| current_price | 現在価格 | string | JP¥56,566 | 検索結果カードに表示される現在価格のテキスト。表示された通貨記号を含みます。 |
| delivery | 配送 | string | 免费配送, 预计明天, 9月3日送达 | 検索結果カードに表示される配送時期と条件。 |
| image_url | 画像URL | string | https://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpg | 検索結果カードに表示される商品画像のURL。 |
| in_stock | 在庫情報 | string | — | 検索結果カードに表示される在庫テキスト。 |
| item_id | アイテムID | string | https://www.amazon.co.jp/s?k=ipad+mini | このレコードが属する検索結果ページの収集項目識別子。 |
| keyword | キーワード | string | ipad mini | この商品カードに対応する検索キーワード。 |
| original_price | 元の価格 | string | — | 検索結果カードに表示される元の価格または取消線価格のテキスト。表示された通貨記号を含みます。 |
| product_id | 商品ID | string | B0BKPXSKNQ-JP | この検索結果出品の商品識別子。 |
| product_title | 商品タイトル | string | 【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰 | 検索結果カードに表示される商品名。 |
| rating_count | 評価数 | string | 193 | 検索結果カードに表示される評価件数。 |
| rating_score | 評価スコア | string | 3.8 | 検索結果カードに表示される評価スコア。 |
| recent_purchase | 最近の購入 | string | 过去一个月有50+顾客购买 | 検索結果カードに表示される最近の購入テキスト。 |
| search_front_category | 先頭カテゴリ | string | — | カードに表示される場合の検索先頭カテゴリ。 |
| shipping_free | 送料無料 | string | — | 検索結果カードに表示される送料無料のテキスト。 |
| shipping_price | 送料 | string | — | 検索結果カードに表示される送料テキスト。 |
| site_code | サイトコード | string | JP | この出品のAmazonマーケットプレイスサイトコード。例: JP。 |
| sku_id | SKU ID | string | B0BKPXSKNQ-JP | この検索結果とともに返るSKU識別子。 |
| source_crawl_time | ソース時刻 | string | 1788317664075 | 出品とともに返るソース側の収集タイムスタンプ(テキスト)。 |
| listing_status | 出品ステータス | string | 有效 | レコードとともに返る出品ステータスの原文。 |
| source_item | ソース項目 | string | https://www.amazon.co.jp/s?k=ipad+mini | このレコードを生んだ収集項目に対応する検索結果URL。 |
| no_data | データなしフラグ | boolean | false | 収集項目が一致する商品カードを返さなかったかどうか。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"ad_tag": {
"type": "boolean",
"title": "広告タグ",
"description": "検索結果カードが広告として表示されているかどうか。",
"prefill": false
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "レコードに紐づく業務識別子。現在のデータ形では検索結果URLです。",
"prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
},
"crawl_rate": {
"type": "string",
"title": "収集ステータス",
"description": "ソースレコードとともに返る収集ステータスのテキスト。",
"prefill": "running"
},
"crawl_time": {
"type": "string",
"title": "収集日時",
"description": "この商品カードの収集時刻。ソースはタイムゾーンを示しません。",
"prefill": "2026-09-02T10:54:24"
},
"current_price": {
"type": "string",
"title": "現在価格",
"description": "検索結果カードに表示される現在価格のテキスト。表示された通貨記号を含みます。",
"prefill": "JP¥56,566"
},
"delivery": {
"type": "string",
"title": "配送",
"description": "検索結果カードに表示される配送時期と条件。",
"prefill": "免费配送, 预计明天, 9月3日送达"
},
"image_url": {
"type": "string",
"title": "画像URL",
"description": "検索結果カードに表示される商品画像のURL。",
"prefill": "https://m.media-amazon.com/images/I/71YBUkZO2BL._AC_UL320_.jpg"
},
"in_stock": {
"type": "string",
"title": "在庫情報",
"description": "検索結果カードに表示される在庫テキスト。"
},
"item_id": {
"type": "string",
"title": "アイテムID",
"description": "このレコードが属する検索結果ページの収集項目識別子。",
"prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
},
"keyword": {
"type": "string",
"title": "キーワード",
"description": "この商品カードに対応する検索キーワード。",
"prefill": "ipad mini"
},
"original_price": {
"type": "string",
"title": "元の価格",
"description": "検索結果カードに表示される元の価格または取消線価格のテキスト。表示された通貨記号を含みます。"
},
"product_id": {
"type": "string",
"title": "商品ID",
"description": "この検索結果出品の商品識別子。",
"prefill": "B0BKPXSKNQ-JP"
},
"product_title": {
"type": "string",
"title": "商品タイトル",
"description": "検索結果カードに表示される商品名。",
"prefill": "【翻新产品】Apple iPad mini (第6代)Wi-Fi + Cellular 64GB 太空灰"
},
"rating_count": {
"type": "string",
"title": "評価数",
"description": "検索結果カードに表示される評価件数。",
"prefill": "193"
},
"rating_score": {
"type": "string",
"title": "評価スコア",
"description": "検索結果カードに表示される評価スコア。",
"prefill": "3.8"
},
"recent_purchase": {
"type": "string",
"title": "最近の購入",
"description": "検索結果カードに表示される最近の購入テキスト。",
"prefill": "过去一个月有50+顾客购买"
},
"search_front_category": {
"type": "string",
"title": "先頭カテゴリ",
"description": "カードに表示される場合の検索先頭カテゴリ。"
},
"shipping_free": {
"type": "string",
"title": "送料無料",
"description": "検索結果カードに表示される送料無料のテキスト。"
},
"shipping_price": {
"type": "string",
"title": "送料",
"description": "検索結果カードに表示される送料テキスト。"
},
"site_code": {
"type": "string",
"title": "サイトコード",
"description": "この出品のAmazonマーケットプレイスサイトコード。例: JP。",
"prefill": "JP"
},
"sku_id": {
"type": "string",
"title": "SKU ID",
"description": "この検索結果とともに返るSKU識別子。",
"prefill": "B0BKPXSKNQ-JP"
},
"source_crawl_time": {
"type": "string",
"title": "ソース時刻",
"description": "出品とともに返るソース側の収集タイムスタンプ(テキスト)。",
"prefill": "1788317664075"
},
"listing_status": {
"type": "string",
"title": "出品ステータス",
"description": "レコードとともに返る出品ステータスの原文。",
"prefill": "有效"
},
"source_item": {
"type": "string",
"title": "ソース項目",
"description": "このレコードを生んだ収集項目に対応する検索結果URL。",
"prefill": "https://www.amazon.co.jp/s?k=ipad+mini"
},
"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": {
"meme_today__amazon-keyword-list-jp": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/amazon-keyword-list-jp",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。