2.3 KiB

Raw Blame History

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/logistics data. Use when the user provides a 1688 product URL and needs logistics specs.

1688 Logistics Scraper

Capture 1688 product pages for vision-based extraction of weight, size, and logistics data.

Run

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

Examples

bun scripts/run.ts scrape 'https://detail.1688.com/offer/852504650877.html'
bun scripts/run.ts scrape 'https://detail.1688.com/offer/852504650877.html' --dry-run

What It Does

Opens the 1688 product URL in the browser (default port 18800)
Scrolls through the entire page, capturing full-page screenshots section by section
Downloads all product detail images (large images only, skips icons)
Saves everything to /tmp/1688-logistics/<offer-id>/

No DOM parsing or regex. The model reads the screenshots and images directly to extract logistics data.

Output

{
  "status": "success",
  "url": "https://detail.1688.com/offer/...",
  "offerId": "852504650877",
  "screenshots": [
    "/tmp/1688-logistics/852504650877/screenshots/page_001.png",
    "/tmp/1688-logistics/852504650877/screenshots/page_002.png",
    "/tmp/1688-logistics/852504650877/screenshots/page_003.png"
  ],
  "detailImages": [
    "/tmp/1688-logistics/852504650877/images/img_001.jpg",
    "/tmp/1688-logistics/852504650877/images/img_002.jpg"
  ]
}

After Running

Read the screenshots and images to extract:

Weight (重量/毛重/净重/单件重量) — normalize to kg
Dimensions (尺寸/长宽高) — normalize to cm
Volume (体积/容积)
Package info (包装信息) — packaging type, box weight, box dimensions, units per box
Piece weight/size (商品件重尺) — per-piece logistics specs
Variant-specific weight/size if shown per SKU
Shipping info — method, cost, origin

Output the extracted data as structured JSON.

Rules

If the browser is not running, report the error. Do not try to launch it.
No retries. If it fails, report as-is.
Read ALL screenshots — logistics data can appear anywhere on the page.
Read detail images too — weight/size is often baked into product photos.

2.3 KiB Raw Blame History