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

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.16.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.16-py3-none-any.whl (36.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cli_market-1.0.16.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.16.tar.gz
Algorithm Hash digest
SHA256 36542d8bcbaf2af4c004ebd3dc02e32d530f89f1f0dc2943e070b9f70fcd07f7
MD5 e201b27652d94f9f4c5d2cdb298b3432
BLAKE2b-256 cb1c9517df5e2674bda1649821dff40f99a5b57b6669dd6decea2af991a35aee

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cli_market-1.0.16-py3-none-any.whl
  • Upload date:
  • Size: 36.4 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.16-py3-none-any.whl
Algorithm Hash digest
SHA256 89febe4f3386b16b5507ecfce4fd2f2ad99c9cf67cbab7e78642d5acac444049
MD5 56e48e762ec1bdcf2e83c7c262c37cec
BLAKE2b-256 8cf01a1662265a549f9e72eab719c4b4db5455c6731191c76c34db167aced4bb

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