Skip to main content

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

Project description

3760 retailers 12 lines 67 countries MCP py MIT build Vercel

CLI Market

Commerce infrastructure for AI agents.
3,760+ retailers · 12 lines · 67 countries · 1 API.


What is CLI Market?

CLI Market is the middleware between VTEX and AI agents. One API call searches, compares, and purchases across 3,760+ retailers in 67 countries. Human-friendly CLI. Agent-friendly MCP tools. JSON-parseable output.

Stripe turned payments into APIs. We turn commerce into APIs.

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.15.tar.gz (34.5 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.15-py3-none-any.whl (36.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cli_market-1.0.15.tar.gz
  • Upload date:
  • Size: 34.5 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.15.tar.gz
Algorithm Hash digest
SHA256 0df0de8894fbe4bfca4f32f2e1c35d2477180cc1568d48102ca1798b3f324c8c
MD5 b18477004cf6fb2b089d730744199baa
BLAKE2b-256 f10af8fdb1f6a7ee3c82cf466eca04ce734bc4d0ae52c783e36b537a02c378c5

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cli_market-1.0.15-py3-none-any.whl
  • Upload date:
  • Size: 36.3 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.15-py3-none-any.whl
Algorithm Hash digest
SHA256 a85295b64b7dbb2ebe712345a6867bf0a67d26af6f2de4f8c29be8a9f762016f
MD5 762447c7bdf63993cd4a50dc4d1e1d1b
BLAKE2b-256 eb70ff362e8954b5a46587b1c6fb6e8486b7eaaf583eab6446ea90cb320f0d13

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