# 1688

**Mode**: 🔐 Browser · **Domain**: `1688.com`

## Commands

| Command | Description |
|---------|-------------|
| `opencli 1688 search "<query>" --limit <n>` | Search public product candidates with price, MOQ, seller link, and visible badges |
| `opencli 1688 item <url-or-offer-id>` | Read a public product detail page with price tiers, MOQ, delivery text, and seller basics |
| `opencli 1688 assets <url-or-offer-id>` | Extract product media assets visible on the item page (main images, SKU images, detail images, videos) |
| `opencli 1688 download <url-or-offer-id>` | Batch download product media assets visible on the item page |
| `opencli 1688 store <url-or-member-id>` | Read a public supplier/store page with company info, years on platform, categories, and visible service signals |

## Usage Examples

```bash
# Search products
opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10

# JSON output
opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10 -f json

# Read an item by offer id
opencli 1688 item 841141931191 -f json

# Read an item by URL
opencli 1688 item https://detail.1688.com/offer/841141931191.html -f json

# List downloadable media assets
opencli 1688 assets 841141931191 -f json

# Batch download page-visible images/videos
opencli 1688 download 841141931191 --output ./1688-downloads

# Read a supplier store
opencli 1688 store https://shop52908bfw19166.1688.com/ -f json

# Read a supplier by member id
opencli 1688 store b2b-22154705262941f196 -f json
```

## Prerequisites

- Chrome running and **logged into** `1688.com`
- [Browser Bridge extension](/guide/browser-bridge) installed

## Notes

- This adapter only returns or downloads fields and media visible on public pages. It does not send inquiries, place orders, or access seller back office data.
- `assets` / `download` currently prioritize page state and rendered DOM. They may not perfectly match every file exposed by the official 1688 extension workflow.
- Prefer stable identifiers such as `offer_id`, `member_id`, and `shop_id` for follow-up workflows.
- `search --limit` defaults to `20` and is capped at `100`.
- `search` deduplicates with key priority: `offer_id` first, then canonical `item_url`.
- `item` can be more sensitive to the active browser target than `search` or `store`.

## Troubleshooting

- If `opencli 1688 item` reports `did not expose product context`, first make sure the open page is a real `detail.1688.com` item page.
- If the browser target is too broad, retry with `OPENCLI_CDP_TARGET=detail.1688.com`.
- If you hit a slider or verification page, refresh the real page in Chrome and retry.
