概要
1688のキーワード検索では、同じ購入ニーズに対してさまざまなデザイン、素材、商品バリエーションが見つかります。商品情報をまとめることで、元の商品名や詳しく確認するためのリンクを残したまま、品ぞろえを見渡せます。
このデータは商品情報と検索時の文脈を組み合わせたものです。調達調査や比較の出発点として利用でき、商品ページの確認や、実際の購入に向けた仕入先との相談を置き換えるものではありません。
データについて
データは1688のキーワード検索から収集した商品掲載情報です。結果は収集日時の昇順で提供され、収集対象を選ぶ際の並び順とは異なります。複数ページに同じ商品IDがある場合はまとめられます。
商品名、掲載状態、価格と販売数の文字列は元の値を保持します。価格と販促価格は別の通貨に換算せず、税金、送料、購入条件を推測しません。販売数の集計期間と収集日時のタイムゾーンは指定されていません。
地域、販売者、ショップの情報が欠けている場合、商品名などから推測して補完しません。プレビューの空欄は、取得元の値が空文字列であることを意味しません。確認済みの仕入先名簿や、特定の注文に対する見積もりとして扱わないでください。
結果の例
各行は1つの商品掲載情報です。例では元の商品名を保持し、引用符付きの価格と販売数は数値変換していない文字列です。
| 商品ID | 商品名 | 価格 | 販売数 | キーワード |
|---|---|---|---|---|
| 1065208644543 | Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16 | "85" | "0" | iphone 18 pro max |
| 816387948239 | 适用苹果18promax手机壳插卡包翻盖iPhone17防摔16商务15真皮套14 | "158" | "0" | iphone 18 pro max |
このほかに、商品URL、画像URL、販促価格、収集日時などの列があります。
活用例
- 品ぞろえの比較:商品名に繰り返し現れる素材やデザインの語で分類し、商品IDと商品URLで各グループの個別商品を確認します。
- 表示価格の確認:商品名が似ている商品の価格と販促価格を比較します。元の価格文字列を保持し、結論を出す前に購入条件を確認します。
- 調達候補の整理:キーワード、商品名、画像URLを組み合わせて候補を選び、収集日時を残して後の調査と区別します。
適用範囲と境界
1回につき1キーワード。収集目標は1~2,000商品で、結果件数の厳密な上限ではありません。ページ単位の収集により、目標を下回る場合も上回る場合もあります。取得保護上限は110ページ/2,200件で、この上限への到達は完全性を保証しません。
- 適している用途
- キーワードを使った商品調達や比較のために1688の商品情報を探す場合。
- 適さない用途
- リアルタイム価格の保証、完全な仕入先プロフィール、厳密な件数制限が必要な用途には適しません。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1送信がタイムアウトした場合や受付結果が不明な場合は、再送信前に既存の実行を確認してください。再送信すると別の処理が作成される場合があります。
- 2入力や認証情報が拒否された場合は、入力またはアクセス設定を修正してから再試行してください。
- 3結果が空でも、取得元がデータなしと明示したとは限りません。部分成功や取得保護上限への到達時は、結果の完全性を確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須string1688の商品検索キーワードを1~512文字で1つ入力してください。例iphone 18 pro max - 希望商品数
target_count必須string1~2000の整数を数字のみで入力してください。これは収集目標であり厳密な上限ではなく、ページ単位の収集により結果が前後する場合があります。例25 - 収集時の並び順
sort任意string(enum)収集時の商品順序を選択します。既定は関連度順で、取得結果は引き続き収集日時の昇順です。選択可能な値関連度順bid価格の高い順bid2価格の安い順_bid2販売数の多い順saleデフォルトbid - 収集開始ページ
startPage任意string収集を開始するページ番号を指定します。正の整数を入力してください。省略した場合はデフォルトで1ページ目から開始します。この値は期待する商品数を変更しません。デフォルト1例2
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- 商品ID
productIdstring1688の商品識別子。例1065208644543 - 商品名
productTitlestring翻訳せずに収集した商品名。例Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16 - 商品URL
productUrlstring1688の商品掲載ページへのリンク。例https://detail.1688.com/offer/1065208644543.html - 画像URL
imageUrlstring収集した商品画像へのリンク。例https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"productId": "1065208644543",
"productTitle": "Alcantara欧缔兰磁吸手机壳适用苹果iPhone17Pro Air 18ProMax 16",
"productUrl": "https://detail.1688.com/offer/1065208644543.html",
"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01zUS1BK23KbTlWHRvp_!!2222667757237-0-cib.jpg",
"price": "85",
"promotionPrice": "85",
"saleCount": "0",
"keyword": "iphone 18 pro max",
"sourceItem": "iphone 18 pro max",
"status": "有效",
"tagPercent": "25%",
"area": "<area>",
"pageNum": "<pageNum>",
"sellerName": "<sellerName>",
"shopId": "<shopId>",
"shopName": "<shopName>",
"crawlTime": "2026-10-10T18:07:09",
"createdAt": "1791626829270",
"task_item": "iphone 18 pro max",
"task_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": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/alibaba1688-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。