1688-logistics-scraper/SKILL.md

name	description
1688-logistics-scraper	Scrape 1688 product pages via Chrome, capture full-page screenshots and detail images for vision-based extraction of weight/size data. Use when the user provides a 1688 product URL and needs logistics specs.

1688 Logistics Scraper

Capture 1688 product pages and extract weight/size data via vision.

Run

bun scripts/run.ts scrape <url> [--dry-run] [--port=9222]

What It Does

1. Opens the 1688 product URL in the browser (default port 18800)
2. Scrolls through the entire page, capturing full-page screenshots
3. Downloads all product detail images
4. Saves to /tmp/1688-logistics/<offer-id>/

After Running — MUST follow

Read ALL screenshots and detail images, then output the following JSON structure. This is the final output for API consumption.

{
  "offerId": "966107271425",
  "url": "https://detail.1688.com/offer/966107271425.html",
  "title": "商品标题",
  "weight": {
    "value": 0.15,
    "unit": "kg",
    "source": "商品属性"
  },
  "grossWeight": {
    "value": 0.2,
    "unit": "kg",
    "source": "商品件重尺"
  },
  "netWeight": {
    "value": 0.15,
    "unit": "kg",
    "source": "商品属性"
  },
  "dimensions": {
    "length": 10,
    "width": 8,
    "height": 1.8,
    "unit": "cm",
    "source": "商品属性"
  },
  "volume": {
    "value": 0.000144,
    "unit": "m³",
    "source": "商品件重尺"
  },
  "packageWeight": {
    "value": 5.0,
    "unit": "kg",
    "source": "包装信息"
  },
  "packageDimensions": {
    "length": 40,
    "width": 30,
    "height": 20,
    "unit": "cm",
    "source": "包装信息"
  },
  "unitsPerPackage": 50,
  "variants": [
    {
      "name": "12支装",
      "weight": { "value": 0.12, "unit": "kg" },
      "dimensions": { "length": 9.5, "width": 6, "height": 2.2, "unit": "cm" }
    }
  ]
}

Field rules

• All weight values normalized to kg (克÷1000, 斤×0.5)
• All dimension values normalized to cm (mm÷10)
• source: where on the page the data was found (商品属性 / 商品件重尺 / 包装信息 / 详情图片)
• variants: only include if weight/size differs per SKU. Omit if all variants share the same specs.
• Omit fields that are null — do not include fields where no data was found
• Do not guess. Only include values actually visible on the page or in images.

Rules

1. If the browser is not running, report the error. Do not try to launch it.
2. No retries. If it fails, report as-is.
3. Read ALL screenshots — logistics data can appear anywhere on the page.
4. Read detail images too — weight/size is often baked into product photos.
5. Output ONLY the structured JSON above. No extra commentary.