logo
JP

JD店舗内キーワード検索

JDの店舗ID、店舗内キーワード、期待件数を指定すると、タイトル・価格・店舗コンテキスト付きの該当商品を収集します。

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

開発者
super_ig
料金
$0.003 / 60 件から
最終更新
2026-10-19

概要

JDの店舗内キーワード検索は、1つの店舗が購買意図に対してどの商品を見せているかを切り出します。公式商品、アクセサリー、関連SKUが同じ店舗の検索ページに並ぶため、サイト全体の検索結果とは見え方が大きく変わることがあります。これらのカードを1つの表にすると、店舗が実際に見せているタイトル、価格帯、SKUを、出品を1件ずつ開かなくても判断しやすくなります。

このコレクションは、公開の店舗内検索結果から、元の商品タイトル、表示中のJD価格と元価格、画像、店舗コンテキストを保持します。店舗のキーワード品揃えと一覧ページの価格が調達や競合レビューの入力になる場合に役立ち、商品詳細の確認や購入判断の代わりにはなりません。

データについて

データは、1つの店舗と1つのキーワードに対する公開JD店舗内キーワード検索から収集した商品カードです。結果は収集時刻の昇順で届き、収集時に商品を選ぶ並び順とは別です。重複するSKU IDは配信ページ間でまとめられます。

商品タイトル、JD価格、元価格、レビュー数、売上数はソースのテキストのままです。価格は別通貨に換算されず、税・販促・購入条件についての仮定も置きません。ビジネスIDとキーワードは同じ検索語句を持つことがあり、どちらも一意の商品識別子ではありません。送信アイテムは店舗とキーワードのコンテキストを保持し、同一タスクの多くの商品で繰り返されることがあります。収集時刻のタイムゾーンは指定されていません。商品画像アドレスは完全なhttp接頭辞ではなく // で始まることがあります。

欠落したブランド、価格、売上数、出品ステータスは補完せず欠落のままです。プレビューが空白でも、ソース値が空文字であるとは限りません。データなし表示は、一致商品がなかった送信済みの店舗とキーワードを、通常の出品行と区別します。このコレクションを店舗カタログの完全版、在庫スナップショット、特定注文の確認済みオファーとして扱わないでください。

結果の見え方

各行は、送信した店舗とキーワードに対するJD店舗内検索結果の1件です。

SKU ID商品タイトルショップ名キーワード収集時刻
10106482729387ZEEHO极核插画车型主题高透亚克力钥匙扣 ae8ZEEHO官方旗舰店钥匙扣2026-10-14T17:02:03
100007662145ZEEHO极核钥匙扣挂件ZEEHO官方旗舰店钥匙扣2026-10-14T17:02:03

JD価格、元価格、画像URL、データなし表示などの列もあります。

利用シーン

  • 店舗内の品揃え比較: 商品タイトルを繰り返し現れる商品・アクセサリー語句でグループ化し、SKU ID とショップ名で同じキーワードの背後にある別出品を分けます。
  • 表示価格の確認: 似た商品タイトルの JD価格 と 元価格 を比較し、競争力を判断する前に元のテキストを保ちます。
  • 候補リスト作成: キーワード、商品タイトル、画像URL、ショップ名を組み合わせて候補を特定し、収集時刻を残して後続レビューでスナップショットを区別します。

適用範囲と境界

1回のタスクでJD店舗IDは1件、店舗内キーワードは1件、期待商品数は1~12,000件。件数は収集目標であり厳密な上限ではないため、実際は少ないことも多いこともあります。取得保護は12ページ / 12,000件で、この容量に達しても完全性は保証されません。対象は公開のJD店舗内検索結果のみです。

  • 適している用途
  • 1つのJD店舗内でキーワードに一致する商品が必要なとき。
  • 一致した出品をタイトル、表示価格、店舗コンテキストと結び付けた一覧が必要なとき。
  • 適さない用途
  • 商品詳細ページ、バリエーション、レビュー、またはキーワードなしの店舗カタログ全体が必要な場合。
  • 件数の厳密な上限や、単一レコードの即時照会が必要な場合。

失敗時の処理

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

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

入力

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

  • JD店舗IDshop_id必須string
    店舗内検索結果を収集したいJD店舗のIDです。1回のタスクにつき店舗IDを1件、1〜512文字で入力します。
    例11635291
  • 店舗内キーワードkeyword必須string
    店舗内で検索するキーワードを1つ、1〜512文字で入力します。
    例钥匙扣
  • 期待商品数target_count必須integer
    1〜12,000の整数を入力します。これは収集目標であり厳密な上限ではありません。実際の件数は収集結果に従い、少ないことも多いこともあります。
    範囲1–12000例10
  • 収集時の並び順sort_order必須string(enum)
    収集時に商品をどの順で選ぶかを指定します。デフォルト、売上順、コメント数順、新着、価格の安い順、価格の高い順があります。配信結果は収集時刻の昇順のままです。
    選択可能な値デフォルト0売上順2コメント数順3新着4価格の安い順51価格の高い順52例0

出力

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

  • SKU IDskuIdstring
    出品を区別するためのJD商品識別子です。
    例10106482729387
  • ビジネスIDbizIdstring
    出品に残る検索キーワードであり、一意の商品識別子ではありません。
    例钥匙扣
  • 商品タイトルproductTitlestring
    収集されたままの商品タイトル(翻訳なし)。
    例ZEEHO极核插画车型主题高透亚克力钥匙扣 ae8
  • JD価格jdPricestring
    収集されたJD掲載価格のテキスト。欠落値は補完しません。通貨フィールドは別途ありません。

サンプルデータ

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

output.example
{
  "skuId": "10106482729387",
  "bizId": "钥匙扣",
  "productTitle": "ZEEHO极核插画车型主题高透亚克力钥匙扣 ae8",
  "jdPrice": "<jdPrice>",
  "originalPrice": "<originalPrice>",
  "saleCount": "<saleCount>",
  "rateCount": "<rateCount>",
  "brandName": "<brandName>",
  "imageUrl": "//img12.360buyimg.com/n7/jfs/t1/224484/24/20441/30093/666a9032Fee15908b/1ef4fa11ad6ec0fc.jpg",
  "shopId": "11635291",
  "shopName": "ZEEHO官方旗舰店",
  "keyword": "钥匙扣",
  "status": "<status>",
  "crawlTime": "2026-10-14T17:02:03",
  "taskItem": "{\"keywords\":\"钥匙扣\",\"shop_id\":\"11635291\"}",
  "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-shop-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

タスク送信

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

$0.001/ 回
返却1件

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

$0.003/ 60 件

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

Credits を確認

今すぐ試す

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

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