1688-product-detail

# 1688.com — Product Detail Extraction

> Navigate to a 1688 product page → extract 50+ fields including pricing tiers, SKU variants, seller stats, attributes, promotions

## Language

All process output to user (progress updates, process notifications) follows the user's language.

## Objective

Extract complete wholesale product data from a 1688.com offer detail page using embedded page data and network capture for supplier metrics.

## Prerequisites

- Target product detail page is open in the browser: `https://detail.1688.com/offer/{offer_id}.html`
- No login required for product detail pages (data is publicly accessible)

## Pre-execution Checks

### 1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

## Capability Components

> This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.

### DOM: Extract core product data (title, pricing, images, seller, flags)

After navigating to the product page and waiting for page load:

`eval "$(python scripts/extract-product-detail.py '{offer_id}')"`

Parameters:
- offer_id: Numeric 1688 offer/product ID (e.g., `927875250705`)

Output example:
```json
{
  "offerId": "927875250705",
  "title": "新款苹果18promax手机壳磁吸...",
  "unit": "个",
  "category": { "topCategoryId": 7, "postCategoryId": 132918005 },
  "pricing": {
    "tiers": [
      { "minQty": "30", "price": "7.99" },
      { "minQty": "100", "price": "7.79" }
    ],
    "priceDisplayType": "range",
    "minOrderQty": 30,
    "currency": "CNY"
  },
  "sales": {
    "totalSold": 308417,
    "displaySaleNum": "10万+",
    "saleCountLabel": "全网销量"
  },
  "images": ["https://cbu01.alicdn.com/img/ibank/...jpg"],
  "attributes": {
    "材质": "优质TPU",
    "款式": "后盖款",
    "功能": "防震,磁吸,防磨,防摔",
    "适用型号": "iPhone17,iphone17pro..."
  },
  "skuCount": 339,
  "skuWeightData": [
    { "weight": 40, "length": 17, "width": 7, "height": 1, "volume": 119 }
  ],
  "seller": {
    "companyName": "佛山市南海区三丰手机配件有限公司",
    "loginId": "fssf06",
    "memberId": "b2b-2850655109d72ea",
    "userId": 2850655109,
    "shopUrl": "https://shop1460393846166.1688.com",
    "cardType": "cjgc",
    "isPmPlus": true,
    "serviceScore": "4.5分",
    "buyerRepeatRate": "65.82%"
  },
  "offerFlags": {
    "isSkuOffer": true,
    "isPreSell": false,
    "isConsignMarketOffer": true,
    "isDistribution": true,
    "isChtOffer": true,
    "isBuyerProtection": true
  },
  "crossBorder": {
    "foreignLanguagePackageAvailable": true,
    "boxMarkAvailable": true,
    "fbaLabelAvailable": true
  },
  "guarantees": ["买家保障", "正品保障"],
  "descriptionUrl": "https://detail.1688.com/...",
  "offerMemberTags": [4336705, 519170],
  "sellerWinportUrlMap": {}
}
```

### DOM: Extract SKU variants (color/model combinations with weight/dimensions)

`eval "$(python scripts/extract-sku-details.py '{offer_id}')"`

Parameters:
- offer_id: Numeric 1688 offer/product ID

Output example:
```json
{
  "offerId": "927875250705",
  "skuCount": 339,
  "skuRangePrices": [
    { "price": "7.99", "beginAmount": "30" },
    { "price": "7.79", "beginAmount": "100" }
  ],
  "skus": [
    {
      "skuId": 5833485852524,
      "specId": "...",
      "attrs": { "颜色": "黑色", "适用型号": "iPhone17" },
      "saleCount": 0,
      "canBookCount": 9999,
      "isPromotionSku": false,
      "packInfo": { "weight": 40, "length": 17, "width": 7, "height": 1, "volume": 119 }
    }
  ],
  "skuImageMap": {}
}
```

### DOM: Extract coupon and promotion data

`eval "$(python scripts/extract-promotions.py '{offer_id}')"`

Parameters:
- offer_id: Numeric 1688 offer/product ID

Output example:
```json
{
  "offerId": "927875250705",
  "coupons": [
    { "couponType": "INTERACT", "couponContent": "满100减5券" }
  ],
  "promotionModel": {
    "buttonName": "领券",
    "promotionList": [
      {
        "type": "INTERACT",
        "name": "互动优惠券",
        "summary": "入会有礼券",
        "promotionItems": [
          {
            "label": "满100减5券",
            "availablePeriod": "有效期：2026.05.28 00:00:00-2026.11.24 23:59:59",
            "canApply": true
          }
        ]
      }
    ]
  },
  "activity": {
    "activityType": null,
    "activityName": null,
    "activityUrl": null,
    "countdown": null,
    "activityId": null
  },
  "bannerImage": ""
}
```

### DOM: Extract seller params (for shopcard network capture)

`eval "$(python scripts/extract-seller-params.py '{offer_id}')"`

Parameters:
- offer_id: Numeric 1688 offer/product ID

Output example:
```json
{
  "offerId": "927875250705",
  "seller": {
    "companyName": "佛山市南海区三丰手机配件有限公司",
    "loginId": "fssf06",
    "memberId": "b2b-2850655109d72ea",
    "userId": 2850655109,
    "shopUrl": "https://shop1460393846166.1688.com",
    "cardType": "cjgc",
    "serviceScore": "4.5分",
    "buyerRepeatRate3m": "65.82%"
  },
  "shopcardParams": {
    "offerId": "927875250705",
    "userId": 0,
    "offerMemberTags": [4336705, 519170, "..."],
    "sellerUserId": 2850655109,
    "sellerMemberId": "b2b-2850655109d72ea",
    "topCategoryId": 7,
    "offerModelSign": { "isBuyerProtection": true, "isDistribution": true },
    "sellerIdentity": "cjgc",
    "sellerWinportUrlMap": { "indexUrl": "...", "defaultUrl": "..." },
    "winportUrl": "https://shop1460393846166.1688.com"
  }
}
```

### Network Capture: Get shop scores and metrics (shopcard API)

The shopcard API uses dynamic `sign` tokens — let the page JS handle it, read from network traffic.

After the product detail page loads fully (wait stable), the shopcard request f