logo
JP

1688 店舗商品リスト

1688の店舗IDと期待する商品数を指定すると、その店舗の掲載商品をタイトル、価格、画像、元ページへのリンク付きで収集します。

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

開発者
料金
$0.04 / 20 件から
最終更新
2026-10-21

概要

1688の店舗ページは、その商家が現在出している商品を見る窓口になりますが、タイトル、価格、画像、掲載リンクがページ上にまとまっており、比較できるカタログとして残しにくいものです。このアプリは1件の店舗IDを、商品単位の構造化リストに変換します。調達や商品企画の担当者が、手作業で行をコピーせずに、その店舗の見える品揃えを確認できます。

すでに知っている商品を調べるのとは異なり、店舗リストはその店に並んでいる品揃えそのものを示します。商品の識別情報、表示価格、画像、店舗コンテキストを同じ行に置くことで、価格帯の把握、掲載が続く商品の確認、1商家からの候補セット作成がしやすくなります。

データ説明

各レコードは、指定した1688店舗の公開商品掲載です。返却データセット内ではSPU IDで重複を除きます。ビジネスID、店舗ID、送信した店舗IDは店舗コンテキストを保持し、同一タスクの複数商品で繰り返されることがあります。掲載は収集時刻の昇順で安定して返されます。

価格は別通貨フィールドのない生の文字列で、単位変換も行いません。商品タイトルは元の言語のままです。データなし表示は、該当店舗から一致商品が得られなかった場合と、通常の掲載行とを区別します。

収集対象は指定店舗の公開掲載のみです。他店舗、商品詳細スペック、コメント、注文データは含まれません。

結果の形

各行は、送信した店舗に紐づく1688店舗の商品掲載1件です。

商品タイトルSPU ID価格店舗ID商品URL
亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套9904570602209b2b-28504255504b611https://m.1688.com/offer/990457060220.html
MOQ50适用三星Z Flip 6折叠连体透明亚克力套啤保护套上下防摔7967359821637b2b-28504255504b611https://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. 1送信がタイムアウトした、または結果が不明な場合は、再送信する前に既存の実行を確認してください。繰り返し送信すると別のジョブが作られることがあります。
  2. 2商品が返らない場合は店舗IDを確認してください。空の結果だけでは、ソースが明確にデータなしと報告したことにはなりません。
  3. 3部分成功後は取得済みレコードを残し、失敗または期限切れのタスクでは同じ店舗を再送信してください。
  4. 4取得保護上限に達した場合も、完全性の確認が必要です。

入力

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

  • 1688 店舗IDshop_id必須string
    商品リストを収集したい1688店舗IDを1件入力してください。1~512文字です。
    例b2b-28504255504b611
  • 期待する商品数target_count必須string
    1から500までの整数を数字のみで入力してください。これは収集目標であり厳密な上限ではありません。実際の件数はそれより少ない場合も多い場合もあります。
    例25

出力

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

  • ビジネスIDbizIdstring
    掲載に紐づくタスクのビジネス識別子です。同一店舗の複数商品で繰り返されることがあります。
    例b2b-28504255504b611
  • 画像URLimageUrlstring
    収集された商品画像リンクです。
    例https://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg
  • 価格pricestring
    収集された価格テキストです。通貨換算や数値変換は行いません。
    例9
  • 商品タイトルproductTitlestring
    収集された商品タイトルです。翻訳しません。
    例亚马逊适用小米17 Promax银盾肤感磨砂透磁吸壳 TPU+PC全包保护套

サンプルデータ

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

output.example
{
  "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 config
{
  "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 回ごとに課金されます。

$0.0001/ 回
返却20件

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

$0.04/ 20 件

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

Credits を確認

今すぐ試す

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

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