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

# 1688 Product Master

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

## Run

```bash
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

```bash
# 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](references/1688-product-master.md).