55 lines
1.7 KiB
Markdown
55 lines
1.7 KiB
Markdown
---
|
|
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).
|