logo
JP

JDキーワード検索

JDの検索キーワードと期待件数を指定すると、価格・ショップ・商品リンク付きの商品一覧を取得します。

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

データ収集E-commerce & RetailJD.comProducts
開発者
super_ig
料金
$0.05 / 48 件から
最終更新
2026-10-13

概要

JDのキーワード検索では、公式店、正規販売店、アクセサリー出品が同じ購買意図の裏に混在します。検索結果カードを並べて見ることで、どの商品・ショップ・価格帯が実際に表示されるかを、一つずつ開かずに判断しやすくなります。

このコレクションは、JD検索結果の元の商品タイトル、表示価格、出品リンクを保持します。商品詳細の確認や購買判断の代替ではなく、品揃え、順位、一覧ページ価格を調達や競合レビューの入力にする場合に役立ちます。

データについて

データは公開されているJDキーワード検索結果から収集した商品カードです。配信結果は収集時刻の昇順であり、収集時に商品を選ぶ並び順とは別です。繰り返されるSKU IDは配信ページをまたいで集約されます。

商品タイトル、価格、レビュー数、売上数はソースのテキストのままです。価格は別通貨に換算せず、税・販促・購入条件についての仮定もしません。ビジネスID、キーワード、送信キーワードは同じ検索語句を持つことがあり、いずれも一意の商品識別子ではありません。収集時刻のタイムゾーンは指定されていません。

欠落したブランド、売上数、出品ステータスは推測せず欠落のままです。プレビューが空白でも、元の値が空文字であるとは限りません。検索説明フラグは収集されたままの可否マーカーです。このコレクションをJDの完全なカタログ、在庫スナップショット、特定注文の確認済みオファーとして扱わないでください。

結果の見え方

各行はJD検索結果の1件の出品です。引用された価格とレビュー数はテキストであり、換算した数値ではありません。

SKU ID商品タイトル価格レビュー数ショップ名
10235644935262苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】"12888.00""2000+"星盟3C数码买手店
10234915484680Apple/苹果 iPhone 18 Pro Max 支持移动联通电信 5G 双卡双待手机 勃艮第酒红色 256GB 授权正品【需现场签收激活】 官方标配"10999.00""500+"Apple产品萌宠主题旗舰店

追加の列には商品URL、画像URL、収集時刻があります。

利用シーン

  • 検索の品揃えを比較する：商品タイトルを繰り返し出る商品語やアクセサリー語でまとめ、SKU IDとショップ名で同じキーワードの裏にある別出品を分けます。
  • 表示価格を確認する：似た商品タイトルの出品について価格とレビュー数を比べ、競争力を判断する前に元のテキストを保ちます。
  • 候補リストを作る：キーワード、商品タイトル、商品URL、ショップ名を組み合わせて関連候補を見つけ、後から収集スナップショットを区別できるよう収集時刻を残します。

適用範囲と境界

1回のタスクでJD検索キーワードは1件、期待件数は1～2000件。結果はソースページ単位で収集され、指定件数より少ないことも多いこともあります。取得保護は110ページ / 2,200件で、この容量に達しても完全性は保証されません。対象は公開のJD検索結果のみです。

  • 適している用途
  • ブランド、商品、カテゴリのキーワードに対するJD検索結果の商品が必要なとき。
  • 一致した出品をショップ、価格、商品リンクと結び付けた一覧が必要なとき。
  • 適さない用途
  • 商品詳細ページ、バリエーション、レビュー、価格履歴が必要な場合。このAppが返すのは検索結果カードの情報のみです。
  • 件数の厳密な上限や、単一レコードの即時照会が必要な場合。

失敗時の処理

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

  1. 1送信がタイムアウトした、または結果が不明な場合は、再送信する前に既存の実行を確認してください。繰り返し送信すると別タスクが作られることがあります。
  2. 2一致する記録が返らない場合は、より短い、または広い検索語句で再送信してください。
  3. 3部分成功後は取得済みの記録を残し、失敗または期限切れのあとは同じ入力で再送信してください。
  4. 4レート制限、一時的な利用不可、タイムアウトのあとは時間をおいて再試行してください。
  5. 5認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。

入力

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

  • 検索キーワードkeyword必須string
    JD商品検索キーワードを1つ、1～512文字で入力します。
    例iphone 18 pro max
  • 期待商品数target_count必須string
    1～2000の整数を数字のみで入力します。これは収集目標であり厳密な上限ではありません。ソースページ単位で収集されるため、実際の件数は指定より少ないことも多いこともあります。
    例25
  • 収集時の並び順sort必須string(enum)
    収集時に商品をどの順で選ぶかを指定します。デフォルトはJDの標準順位です。配信結果は収集時刻の昇順のままです。
    選択可能な値デフォルト0総合1売上2レビュー数3新着4価格の安い順51価格の高い順52デフォルト0例0

出力

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

  • SKU IDskuIdstring
    出品を区別するためのJD商品識別子です。
    例10235644935262
  • ビジネスIDbizIdstring
    出品に残る検索キーワードであり、一意の商品識別子ではありません。
    例iphone 18 pro max
  • 商品タイトルproductTitlestring
    収集されたままの商品タイトル（翻訳なし）。
    例苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】
  • 価格pricestring
    収集されたままの価格テキスト。通貨換算や数値変換はしません。
    例12888.00

サンプルデータ

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

output.example
{
  "skuId": "10235644935262",
  "bizId": "iphone 18 pro max",
  "productTitle": "苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸 勃艮第酒红色 256GB【全新未激活+全国联保】",
  "price": "12888.00",
  "saleCount": "<saleCount>",
  "rateCount": "2000+",
  "brandName": "<brandName>",
  "imageUrl": "https://img11.360buyimg.com/img/jfs/t1/514884/11/15012/128777/6aacf40fF7127ae8f/00833203200b14b8.png",
  "productUrl": "https://item.jd.com/10235644935262.html",
  "shopId": "13365898",
  "shopName": "星盟3C数码买手店",
  "keyword": "iphone 18 pro max",
  "searchDescFlag": false,
  "status": "<status>",
  "crawlTime": "2026-10-13T18:37:40",
  "taskItem": "iphone 18 pro max",
  "taskNoData": 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=super_ig/jd-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

タスク送信

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

$0.0001/ 回
返却1件

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

$0.05/ 48 件

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

Credits を確認

今すぐ試す

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

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