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.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

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:

MIT © 2026 CLI Market · Treevu AI

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.22.tar.gz (35.9 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.22-py3-none-any.whl (37.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cli_market-1.0.22.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

Hashes for cli_market-1.0.22.tar.gz
Algorithm Hash digest
SHA256 c0cca42a2384c97356a6a2fca70b34b03349a2fc7b02e8f21efe4b788d5f0ca0
MD5 b59e4fd27b073a1fbec59ce5b6bd0da4
BLAKE2b-256 c409fea61290d609d14fa84960c8015ae62985597dab9d6da2f9f7e6276a2060

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cli_market-1.0.22-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

Hashes for cli_market-1.0.22-py3-none-any.whl
Algorithm Hash digest
SHA256 0929e8d36f6e9edf34ea8431fbdc9d0d9fb83b91d437c7c4b9083db5e17e86ff
MD5 3c8727ab551d67c7d9e60f82a8220d1e
BLAKE2b-256 4ca863abf8f83d7a1c24a9e497facadcd508d7031bce009d596bf8eb4e793dd9

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