Skip to content

1688.md

Latest commit

 

History

History
61 lines (43 loc) · 2.58 KB

1688.md

File metadata and controls

61 lines (43 loc) · 2.58 KB

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

# 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

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.