Home/Skills/1688 CLI

Sourcing & Research · Open source on GitHub

1688 CLI

Product research, supplier vetting and procurement on 1688, as a command line built specifically for AI agents to drive.

GitHub Open-source tool TypeScript · 144 ★ MIT
superjack2050/1688-cli GitHub repository card

Upfront: I did not build this. It is an open-source project on GitHub (superjack2050/1688-cli, MIT). It is listed here on star count, maintenance activity and how well it fits day-to-day storefront operations.

What it does

How to use it

Install globally from npm; the first run asks you to log in by scanning a QR code with the 1688 app:

npm i -g 1688-cli

1688 doctor          # check the environment
1688 login           # scan the QR once

# keyword search
1688 search "phone case" --sort best-selling --price-max 50

# multi-keyword research, JSONL out
1688 research "phone case" "usb cable" --max-per-query 50 --jsonl

The session is stored locally for later commands. The JSONL output is ready to hand to an agent for filtering and scoring.

When to use it, and when not to

This is the supply-side half. Pair it with the product-research skills in eCommerce Skills for demand-side validation and you have the full loop.