1688-product-master/SKILL.md

1.7 KiB

name description
1688-product-master Scrape 1688 product pages and return structured product data.

1688 Product Master

Scrape 1688 product pages with image/title/variant optimization.

Run

bun dist/run.js <command> [args] [--dry-run]

Commands

Command Description
session Get session token
scrape-url <url> [translate] Scrape a 1688 URL
scrape-payload <json> Scrape with custom payload

Examples

# Scrape a product URL
bun dist/run.js scrape-url 'https://detail.1688.com/offer/852504650877.html'

# With translation
bun dist/run.js scrape-url 'https://detail.1688.com/offer/852504650877.html' true

# Dry run
bun dist/run.js scrape-url 'https://detail.1688.com/offer/852504650877.html' --dry-run

Output

Returns structured JSON with product data:

  • Product info (title, price, description)
  • Images (optimized)
  • Variants/SKUs
  • Supplier info

Rules — MUST follow

  1. Execute only, do not reason about internals. Run the CLI command and return the output. Do NOT attempt to understand, debug, or bypass the scrape/query/polling logic inside the tool.
  2. No fallback strategies. If the command fails, report the error as-is. Do NOT try alternative approaches such as browser scraping, direct HTTP calls, or different API endpoints.
  3. No retry loops. If authentication or the scrape call fails, report the failure. Do NOT re-check configs, re-acquire tokens, or retry on your own.
  4. Trust the tool's output. The CLI handles session management, retries, and error formatting internally. Your job is to invoke it and relay the result — nothing more.

Reference

See references/1688-product-master.md.