JD Keyword Search

概要

Keyword searches on JD mix official stores, authorized sellers and accessory listings behind the same buying intent. Seeing those search-result cards together makes it easier to judge which products, shops and price points actually appear for a query, without opening every listing one by one.

This collection keeps the original product titles, displayed prices and listing links from JD search results. It is useful when assortment, ranking and list-page pricing are the input to a sourcing or competitive review, rather than replacing a product-detail check or a purchase decision.

Data notes

The data describes product cards collected from public JD keyword search results. Results are delivered in ascending collection-time order, which is separate from the sorting used to select products during collection. Repeated SKU IDs are consolidated across the delivered pages.

Product title, Price, Review count and Sales count retain their source text. Price is not converted into another currency, and no assumptions are made about taxes, promotions or purchasing conditions. Business ID, Keyword and Submitted keyword can carry the same search phrase; none of them is a unique product identifier. The time zone of Collection time is not specified.

Missing brand, sales-count and listing-status values remain missing rather than being inferred. A blank preview does not assert that the corresponding source value is an empty string. Search-desc flag is kept as a yes/no marker as collected. The collection should not be treated as a complete JD catalog, a stock snapshot, or a verified offer for a particular order.

What the results look like

Each row represents one JD search-result listing. Quoted Price and Review count values are text, not converted numbers.

SKU ID	Product title	Price	Review count	Shop name
10235644935262	苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸勃艮第酒红色 256GB【全新未激活+全国联保】	"12888.00"	"2000+"	星盟3C数码买手店
10234915484680	Apple/苹果 iPhone 18 Pro Max 支持移动联通电信 5G 双卡双待手机勃艮第酒红色 256GB 授权正品【需现场签收激活】官方标配	"10999.00"	"500+"	Apple产品萌宠主题旗舰店

Additional columns include Product URL, Image URL and Collection time.

Use cases

Compare search assortment: group Product title by recurring product or accessory terms, then use SKU ID and Shop name to separate distinct listings behind the same keyword.
Review displayed pricing: compare Price and Review count for listings with similar Product title wording, keeping the original text before drawing conclusions about competitiveness.
Prepare a shortlist: combine Keyword, Product title, Product URL and Shop name to identify relevant candidates, and retain Collection time so later reviews can distinguish collection snapshots.

適用範囲と境界

One JD search keyword per task with an expected result count from 1 to 2000; results are collected in source pages and may return fewer or more than requested; fetch protection is 110 pages / 2,200 records; reaching this capacity does not establish completeness; coverage is limited to public JD search listings.

適している用途
When you need JD search-result products for a brand, product, or category keyword.
When you need a structured list that connects each matched listing with its shop, price, and product link.

適さない用途
When you need a full product page, variants, reviews, or price history — this App only returns search-result listing information.
When you need a strictly capped result count or an immediate single-record lookup.

失敗時の処理

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

1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
2If no matching records are returned, try a shorter or broader search phrase and resubmit.
3Keep completed records after a partial success; resubmit the same input after a failed or expired task.
4Retry later after rate limiting, temporary service unavailability, or a timeout.
5If authentication fails, verify the API Key configured for the execution environment.

入力

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

Search keywordkeyword必須string
Enter one JD product search keyword, from 1 to 512 characters.
例iphone 18 pro max
Expected product counttarget_count必須string
Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; source-page collection can return fewer or more listings.
例25
Collection sort ordersort必須string(enum)
Choose how products are ordered during collection. Default is the JD default ranking. Delivered results remain in ascending collection-time order.
選択可能な値Default0Comprehensive1Sales2Review count3Newest4Price: low to high51Price: high to low52デフォルト0例0

出力

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

SKU IDskuIdstring
JD product identifier used to distinguish listings.
例10235644935262
Business IDbizIdstring
Search keyword retained on the listing; not a unique product identifier.
例iphone 18 pro max
Product titleproductTitlestring
Product title as collected, without translation.
例苹果18promax【新品限售】Apple iphone18promax 18promax 手机apple 18Promax 6.9英寸勃艮第酒红色 256GB【全新未激活+全国联保】
Pricepricestring
Price text as collected; no currency or numeric conversion is applied.
例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

料金

Task submission

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

$0.0001/ 回

Returned record

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

$0.05/ 48 件

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

Credits を確認

今すぐ試す

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

サンプル

パラメータは送信前に input.schema で検証されます

Search keywordkeyword*Enter one JD product search keyword, from 1 to 512 characters.

Expected product counttarget_count*Enter a whole number from 1 to 2000 as digits only. This is a collection target, not a strict cap; source-page collection can return fewer or more listings.

Collection sort ordersort*Choose how products are ordered during collection. Default is the JD default ranking. Delivered results remain in ascending collection-time order.

概要