キーワードで1688を検索し、価格、販売数、元ページへのリンクを含む商品情報を収集します。
概要
1688の店舗ページは、その商家が現在出している商品を見る窓口になりますが、タイトル、価格、画像、掲載リンクがページ上にまとまっており、比較できるカタログとして残しにくいものです。このアプリは1件の店舗IDを、商品単位の構造化リストに変換します。調達や商品企画の担当者が、手作業で行をコピーせずに、その店舗の見える品揃えを確認できます。
すでに知っている商品を調べるのとは異なり、店舗リストはその店に並んでいる品揃えそのものを示します。商品の識別情報、表示価格、画像、店舗コンテキストを同じ行に置くことで、価格帯の把握、掲載が続く商品の確認、1商家からの候補セット作成がしやすくなります。
データ説明
各レコードは、指定した1688店舗の公開商品掲載です。返却データセット内ではSPU IDで重複を除きます。ビジネスID、店舗ID、送信した店舗IDは店舗コンテキストを保持し、同一タスクの複数商品で繰り返されることがあります。掲載は収集時刻の昇順で安定して返されます。
価格は別通貨フィールドのない生の文字列で、単位変換も行いません。商品タイトルは元の言語のままです。データなし表示は、該当店舗から一致商品が得られなかった場合と、通常の掲載行とを区別します。
収集対象は指定店舗の公開掲載のみです。他店舗、商品詳細スペック、コメント、注文データは含まれません。
結果の形
各行は、送信した店舗に紐づく1688店舗の商品掲載1件です。
| 商品タイトル | SPU ID | 価格 | 店舗ID | 商品URL |
|---|---|---|---|---|
| 亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套 | 990457060220 | 9 | b2b-28504255504b611 | https://m.1688.com/offer/990457060220.html |
| MOQ50适用三星Z Flip 6折叠连体透明亚克力套啤保护套上下防摔 | 796735982163 | 7 | b2b-28504255504b611 | https://m.1688.com/offer/796735982163.html |
画像URL、ビジネスID、送信した店舗ID、データなし表示も、レコードに含まれる場合は利用できます。商品タイトルは元の言語のまま残ることがあります。
利用シーン
- 品揃えの把握では、店舗IDで行をまとめ、商品タイトルと価格を比べて、店舗の見えるミックスと価格帯を確認します。
- 調達ショートリストでは、SPU ID、商品URL、画像URLを一緒に残し、後から同じ掲載を開けるようにします。
- カタログ監視では、後続の収集結果でSPU IDと店舗IDを比べ、店舗リストから再掲載または脱落した商品を確認します。
適用範囲と境界
1回の実行につき1688店舗IDは1件。収集目標は1~500商品で、結果件数の厳密な上限ではありません。収集結果は目標より少ない場合も多い場合もあります。取得保護上限は25ページ/500件で、この上限への到達は完全性を保証しません。
- 適している用途
- 特定の1688店舗の商品カタログスナップショットが必要なとき。
- 同一店舗内の掲載タイトル、表示価格、元ページリンクを比較したいとき。
- 適さない用途
- 店舗掲載データではなく、商品詳細スペック、サプライヤー概要、顧客レビューが必要なとき。
- 保証されたリアルタイム見積や、結果件数の厳密な上限が必要なとき。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1送信がタイムアウトした、または結果が不明な場合は、再送信する前に既存の実行を確認してください。繰り返し送信すると別のジョブが作られることがあります。
- 2商品が返らない場合は店舗IDを確認してください。空の結果だけでは、ソースが明確にデータなしと報告したことにはなりません。
- 3部分成功後は取得済みレコードを残し、失敗または期限切れのタスクでは同じ店舗を再送信してください。
- 4取得保護上限に達した場合も、完全性の確認が必要です。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 1688 店舗ID
shop_id必須string商品リストを収集したい1688店舗IDを1件入力してください。1~512文字です。例b2b-28504255504b611 - 期待する商品数
target_count必須string1から500までの整数を数字のみで入力してください。これは収集目標であり厳密な上限ではありません。実際の件数はそれより少ない場合も多い場合もあります。例25
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- ビジネスID
bizIdstring掲載に紐づくタスクのビジネス識別子です。同一店舗の複数商品で繰り返されることがあります。例b2b-28504255504b611 - 画像URL
imageUrlstring収集された商品画像リンクです。例https://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg - 価格
pricestring収集された価格テキストです。通貨換算や数値変換は行いません。例9 - 商品タイトル
productTitlestring収集された商品タイトルです。翻訳しません。例亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"bizId": "b2b-28504255504b611",
"imageUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg",
"price": "9",
"productTitle": "亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套",
"productUrl": "https://m.1688.com/offer/990457060220.html",
"shopId": "b2b-28504255504b611",
"spuId": "990457060220",
"task_item": "b2b-28504255504b611",
"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-shop-product-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。