elim-cli

CLI client for the Elim product sourcing API (Taobao & 1688).

Install

npm install -g elim-cli

Or link from local build:

cd elim-cli
pnpm link --global

Quick Start

# Set your API key (get it from https://in.elim.asia)
elim config set-key

# Search products
elim search "áo thun" --platform taobao
elim search "phone case" --platform alibaba --sort PRICE_ASC --lang en

# Search by image
elim search-img --img-url "https://img.alicdn.com/bao/uploaded/i3/694223667/O1CN01zSjKgp1cxXRQZsDLA_!!694223667.jpg" --platform alibaba

# Upload image then search by ID
elim upload-image ./product.jpg --platform taobao
elim search-img --img-id <image_id>

# Get product details
elim find 683802263680 --platform taobao

# Resolve shortened URL
elim unshorten "https://m.tb.cn/h.UzSKR0m"

Commands

elim search <keyword>

Search products by keyword.

elim search "áo thun"
elim search "phone case" --platform alibaba --page 2 --size 10 --sort PRICE_ASC

Option	Description
<keyword>	Search keyword
--platform, -p	Platform: taobao (default) or alibaba
--page	Page number (default: 1)
--size	Results per page (default: 20)
--sort	Sort: PRICE_ASC, PRICE_DESC, SALE_QTY_ASC, SALE_QTY_DESC
--lang	Language: vi (default) or en
--min-price	Minimum price
--max-price	Maximum price
--json	Output raw JSON
--fields	Comma-separated columns to display

elim search-img

Search products by image.

elim search-img --img-url "https://..." --platform alibaba
elim search-img --img-id "1263511231"

Either --img-url or --img-id is required.

elim find <product_id>

Get detailed product information.

elim find 683802263680 --platform taobao
elim find 683802263680 --platform alibaba --lang en --json

elim upload-image <file>

Upload a local image to get an image ID for search-img.

elim upload-image ./product.jpg --platform taobao

elim unshorten <url>

Resolve Taobao/1688 shortened URLs to full product links.

elim unshorten "https://m.tb.cn/h.UzSKR0m"

elim config

Manage CLI configuration.

elim config set-key          # Set API key (interactive)
elim config set-url <url>    # Set API base URL
elim config show            # Show current config

Output Modes

Table mode (default) — formatted table for list results, key-value layout for detail.

JSON mode (--json) — raw API response, piped to jq:

elim search "áo thun" --json | jq '.items[0].title'

Fields filter (--fields) — limit columns:

elim search "áo thun" --fields id,title,price

Configuration

Config is stored at:

• Linux/macOS: ~/.config/elim-cli/config.json
• Windows: %APPDATA%/elim-cli/Config/config.json

License

MIT