CLI Market — 3,760+ retailers VTEX, 67 countries, 12 lines. Commerce infrastructure for AI agents.
Project description
CLI Market
Commerce infrastructure for AI agents.
3,760+ retailers · 12 lines · 67 countries · 1 API.
What is CLI Market?
The problem: AI agents can't comparison-shop autonomously today. 3,760 VTEX retailers — Nike, Carrefour, Samsung, Motorola — all share the same public API. But every retailer requires separate auth, separate search logic, no unified cart state, no cross-retailer pricing. Agents fail before the first query.
CLI Market fixes this. One API call across all retailers. One pip install. One JSON schema.
- Search any product across 3,760 retailers in 67 countries
- Compare prices cross-border in real time
- Purchase autonomously via 12 MCP tools
- Build on our data moat — SQLite snapshots of pricing history, SKU normalization, cross-retailer intelligence
Stripe turned payments into APIs. We turn commerce into APIs.
cli-market.dev — full landing, live coverage, MCP docs
Quick start
Linux / macOS / WSL
# 1. Install
pip install cli-market
# 2. Start backend
market-server &
# 3. Use the CLI
market login
market search "leche" --country PE
market compare "aceite"
market add 3 --qty 2
market checkout --payment yape
# 4. Agent mode
market ask "compra arroz"
market --json
Windows (PowerShell)
# 1. Install
pip install cli-market
# 2. Start backend (in a separate terminal)
Start-Process -NoNewWindow python -ArgumentList "-m", "market_server"
# 3. Use the CLI
market login
market search "leche" --country PE
market compare "aceite"
market add 3 --qty 2
market checkout --payment yape
# 4. Agent mode
market ask "compra arroz"
market --json
Windows (CMD)
:: 1. Install
pip install cli-market
:: 2. Start backend (in a separate terminal)
start python -m market_server
:: 3. Use the CLI
market login
market search "leche" --country PE
market compare "aceite"
market add 3 --qty 2
market checkout --payment yape
:: 4. Agent mode
market ask "compra arroz"
market --json
Features
| For humans | For AI agents |
|---|---|
| Terminal CLI | REST API + JSON |
| Rich tables | 12 MCP Tools |
| Spanish / English | CSV export |
market search "milk" |
Autonomous workflows |
Commands
login lines search compare add cart cart-update cart-remove cart-clear checkout orders reorder ask --json
MCP Server
python market_mcp.py
12 tools: market_login market_lines market_search market_compare market_add market_cart market_cart_update market_cart_remove market_checkout market_orders market_reorder market_ask
Compatible with DeepSeek TUI, Claude, Cursor, and any MCP client.
Coverage
3,760+ retailers across 12 business lines in 67 countries.
| Line | Count | Key retailers |
|---|---|---|
| 👕 Fashion | 1,560 | Louis Vuitton · Gucci · Prada · Chanel · Dior · Zara · H&M · Levi's · Nike · Adidas · Renner · Lamborghini · Ferrari |
| 📱 Electronics | 571 | Samsung · Apple · Sony · LG · Panasonic · Dell · HP · Lenovo · Yamaha · Dyson |
| 🏠 Home | 314 | IKEA · Homecenter · Sodimac · Miele · Bosch · Smeg · Tefal · KitchenAid |
| ⚽ Sports | 306 | Nike · Adidas · Reebok · Puma · Under Armour · Decathlon · Foot Locker · Patagonia |
| 🛒 Supermarkets | 252 | Wong · Carrefour · Jumbo · Coto · Costco · Sainsbury's · Edeka · Albert Heijn |
| 🍔 Food | 176 | Nestle · Unilever · Coca-Cola · Pepsi · Lindt · Heineken · Nespresso |
| 💄 Beauty | 170 | Sephora · MAC · Clinique · Estee Lauder · Lancome · Lush · Yves Rocher |
| 🏬 Department Stores | 136 | Mercado Libre · El Corte Ingles · Otto · Miniso · Lego · Americanas |
| 💊 Pharmacies | 51 | Droga Raia · Drogasil · Boots · DM · Rossmann |
| 🔧 Auto Parts | 50 | BMW · Mercedes-Benz · Audi · Tesla · Harley Davidson · Ducati |
| 📚 Stationery | 11 | Staples · Office Depot |
Countries: 67 countries across LATAM, Europe, and global
API
Base URL: https://cli-market-api.onrender.com
Swagger: /docs
llms.txt: https://cli-market.dev/llms.txt
Endpoints
# Status
GET /
# Data Feed
GET /v1/feed/prices?query=cafe&country=PE&format=csv
GET /v1/feed/stats?period=7d
# Competitive Intelligence (CIaaS)
GET /v1/intel/competitor?product=leche&store_a=wong&store_b=plazavea
GET /v1/intel/delta?product=cafe&country_a=PE&country_b=CO
GET /v1/intel/alerts?product=arroz&threshold_pct=5
# Pricing
GET /v1/pricing
Rate limits
| Tier | Requests/min | Requests/day | CIaaS |
|---|---|---|---|
| Free | 10 | 100 | No |
| Paid | Contact | Contact | Yes |
Architecture
AI Agents (Claude, DeepSeek, GPT)
|
CLI Market API ← You are here
|
3,760+ VTEX retailers across 67 countries
|
SQLite data moat — price snapshots, search history
Why this exists
E-commerce is optimized for clicks, not agents. VTEX powers 3,760+ retailers with the same public API — yet no one has built a unified agentic layer on top. CLI Market is that layer.
Links
- Landing: cli-market.dev
- API: cli-market-api.onrender.com
- Telegram: @climarketbot
- llms.txt: cli-market.dev/llms.txt
Legal
Software: MIT License. Use, modify, distribute freely.
Data: Pricing data, SKU mappings, historical snapshots, and retailer indexes are proprietary. Licensed under the Data License Agreement. The software is open. The data moat is protected.
Documents:
- Terms of Service
- Privacy Policy
- Data License Agreement
- Acceptable Use Policy
- Service Level Agreement
MIT © 2026 CLI Market · Treevu AI
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cli_market-1.0.21.tar.gz.
File metadata
- Download URL: cli_market-1.0.21.tar.gz
- Upload date:
- Size: 35.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c2b5f3297374557ad3bf2d785d2ee975baec2cf00760ae02289d6ac2b3caae7
|
|
| MD5 |
a8a998b4365260b78ef654a5ee3761f9
|
|
| BLAKE2b-256 |
91294e93d28aa5109d5403b490b0946299066b27b588c2098e215d9f67839933
|
File details
Details for the file cli_market-1.0.21-py3-none-any.whl.
File metadata
- Download URL: cli_market-1.0.21-py3-none-any.whl
- Upload date:
- Size: 37.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d50f67bfcb976e896f7a69a3473101f29791cf7a970db9dba615e3f83e80cd45
|
|
| MD5 |
f59a4f697d46a46a3badce7709f3cd68
|
|
| BLAKE2b-256 |
082f7be27b465024b462dff27b1d4b3df682b29d646336e64f64f8e4844a0dc2
|