Skip to main content

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

Project description

CLI Market

3760 retailers 12 lines 67 countries MCP py MIT build Vercel

PyPI version PyPI downloads GitHub stars ProductHunt featured

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

CLI Market demo

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-production.up.railway.app
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

License

MIT © 2026 CLI Market · Sinapsis Innovadora

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cli_market-1.0.17.tar.gz (35.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cli_market-1.0.17-py3-none-any.whl (36.9 kB view details)

Uploaded Python 3

File details

Details for the file cli_market-1.0.17.tar.gz.

File metadata

  • Download URL: cli_market-1.0.17.tar.gz
  • Upload date:
  • Size: 35.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for cli_market-1.0.17.tar.gz
Algorithm Hash digest
SHA256 76965da208ba312c8b7f7b6027e081faca7e75e08b4a0fff60f5a413153bdd1e
MD5 af10a8c125e41a213e8d8665e86b8e40
BLAKE2b-256 f01b331b2918c7c5fa742d8d228ee27b3ed3f9605601aee55443c109e404f004

See more details on using hashes here.

File details

Details for the file cli_market-1.0.17-py3-none-any.whl.

File metadata

  • Download URL: cli_market-1.0.17-py3-none-any.whl
  • Upload date:
  • Size: 36.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for cli_market-1.0.17-py3-none-any.whl
Algorithm Hash digest
SHA256 d29cc199d22311e44b9cc88a687bad7982d057199600521763b22793f93575de
MD5 d161207e0dadaf8a7784896bd8159ed9
BLAKE2b-256 727591c519daf69e6eb44c33d4de420ee49c5e96303a8c52d6d6b8c788b484ab

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page