cli-market 1.0.24

CLI Market — 3,760+ retailers VTEX, 67 countries, 12 lines. Commerce infrastructure for AI agents.

CLI Market

Commerce infrastructure for AI agents.
27 retailers · 4 lines · 8 countries · 1 API.

---

What is CLI Market?

The problem: AI agents can't comparison-shop autonomously today. 27 verified VTEX retailers — Carrefour, Wong, Motorola, HEB — 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 27 retailers in 8 countries
• Compare prices cross-border in real time
• Basket — compare full shopping carts across retailers, find the cheapest total
• Inflation — track price changes across countries from the data moat
• Purchase autonomously via 15 MCP tools (basket, inflation, categories)
• Build on our data moat — 4,500+ prices every 4h, historical snapshots, 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

27 retailers across 12 business lines in 8 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: 8 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

Data Moat

The SQLite database is fed by an automated price collector. It queries 40 canonical products (milk, rice, oil, eggs, paracetamol, sneakers, jeans, TVs, laptops, etc.) across all 27 retailers every 4 hours.

# One-time run
python collect_prices.py

# Continuous daemon
python collect_prices.py --daemon --interval 4

# View stats
python collect_prices.py --status
python collect_prices.py --report

Feature	Spec
Parallelism	50 stores simultaneous
Queries	40 seed products across 4 lines
Circuit breaker	5 consecutive failures = 5 min cooldown
Dedup	UNIQUE(product_id, store) upsert
Rate limit	150ms between queries per store
Tables	price_snapshots, collector_runs, store_health

Architecture

AI Agents (Claude, DeepSeek, GPT)
        |
   CLI Market API    ← You are here
        |
   26 VTEX retailers across 8 countries
        |
  SQLite data moat — price snapshots, search history

Why this exists

E-commerce is optimized for clicks, not agents. VTEX powers 27 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