logo
JP

1688 Shop Product List

Give one 1688 shop ID and an expected product count to collect that shop's listed products with titles, prices, images, and source links.

原文 · en-US訳文に戻す

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

概要

A 1688 shop page is a useful window into what a merchant currently offers, but titles, prices, images, and listing links sit together on the page and are hard to keep as a comparable catalog. This app turns one shop ID into a structured product-level list so sourcing and merchandising teams can review that shop's visible assortment without copying rows by hand.

Unlike looking up a product you already know, a shop list shows the assortment as it appears in the store. Keeping product identity, displayed price, image, and shop context in the same row makes it possible to map price bands, watch which items stay listed, or assemble a candidate set from one merchant.

Data notes

Each record is a public product listing from the supplied 1688 shop. SPU IDs are de-duplicated within the returned dataset. Business ID, Shop ID, and Submitted shop ID preserve the shop context and may repeat across many products from the same task. Listings are returned in a stable ascending collection-time order.

Price is the listing amount as a raw string, with no separate currency field and no conversion into another unit. Product titles remain in the original language. A No-data indicator distinguishes a shop that produced no matching products from ordinary listing rows.

The collection covers public listings for the supplied shop only. It does not include other shops, product-detail specifications, comments, or order data.

What a result looks like

Each row is one 1688 shop product listing associated with the submitted shop.

Product titleSPU IDPriceShop IDProduct 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

Image URL, Business ID, Submitted shop ID, and No-data indicator are also available when supplied with the record. Product titles may remain in the original language.

Use cases

  • For assortment mapping, group rows by Shop ID and compare Product title with Price to see the shop's visible mix and price bands.
  • For sourcing shortlists, keep SPU ID, Product URL, and Image URL together so later reviews can open the same listing.
  • For catalog monitoring, compare SPU ID and Shop ID across later collections to see which products reappear or drop out of the shop list.

適用範囲と境界

One 1688 shop ID per run; the requested collection target is 1–500 products, not a strict result limit. Collection may return fewer or more products. Fetch protection is 25 pages / 500 records; reaching this capacity does not establish completeness.

  • 適している用途
  • When you need a product-level catalog snapshot for one 1688 shop.
  • When you want to compare listed titles, displayed prices, and source links within a shop.
  • 適さない用途
  • When you need product-detail specifications, supplier profiles, or customer reviews rather than shop-listing data.
  • When you need a guaranteed real-time quote or a strictly capped result count.

失敗時の処理

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

  1. 1If submission times out or its outcome is unknown, check the existing run before submitting again: repeated submissions can create separate jobs.
  2. 2If no products are returned, check the shop ID; an empty result does not by itself mean that the source explicitly reported no data.
  3. 3Keep completed records after a partial success; resubmit the same shop after a failed or expired task.
  4. 4Reaching the fetch protection capacity also requires a completeness check.

入力

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

  • 1688 shop IDshop_id必須string
    Enter one 1688 shop ID whose product listings you want to collect, from 1 to 512 characters.
    例b2b-28504255504b611
  • Expected product counttarget_count必須string
    Enter a whole number from 1 to 500 as digits only. This is a collection target, not a strict cap; collection can return fewer or more products.
    例25

出力

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

  • Business IDbizIdstring
    Task business identifier associated with the listing; it may repeat across products from the same shop.
    例b2b-28504255504b611
  • Image URLimageUrlstring
    Product image link as collected.
    例https://cbu01.alicdn.com/img/ibank/O1CN01iWuw8p1qrxGUUNpLq_!!2850425550-0-cib.jpg
  • Pricepricestring
    Price text as collected; no currency or numeric conversion is applied.
    例9
  • Product titleproductTitlestring
    Product title as collected, without translation.
    例亚马逊适用小米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

料金

Per submitted shop task

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

$0.0001/ 回
20 returned records

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

$0.04/ 20 件

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

Credits を確認

今すぐ試す

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

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