CLI Market — 3,760+ retailers VTEX, 67 countries, 12 lines. Commerce infrastructure for AI agents.
Project description
CLI Market
Your AI agent can search, compare, and buy across 27 retailers in 8 countries.
One pip install. One API. Zero scraping.
What is CLI Market?
The problem: AI agents can't comparison-shop. Carrefour, Wong, Motorola, HEB — 27 retailers across Latin America and Europe share the same e-commerce engine (VTEX). But every retailer requires separate auth, separate search logic, no unified cart. Agents fail before the first query.
CLI Market fixes this. One pip install. One API call across all 27 retailers. One JSON schema.
- Search any product across 27 verified retailers in 8 countries
- Compare prices cross-border — ARS, BRL, MXN, PEN, COP, CLP, EUR
- Basket — compare your full shopping cart across retailers, find the cheapest
- Inflation — track real price changes from supermarket shelves, updated every 4 hours
- Buy — autonomous checkout with human approval (15 MCP tools)
- Build — data moat with thousands of verified prices, historical snapshots, SKU normalization
Stripe turned payments into APIs. We turn commerce into APIs.
Quick start
# 1. Install
pip install cli-market
# 2. Point to our cloud API (or run locally: python market_server.py)
export MARKET_API_URL=https://cli-market-api.onrender.com
# 3. Authenticate
market login
# 4. Search
market search "leche" --country AR # Argentina
market search "leite" --store carrefour_br # Brazil
# 5. Compare prices
market compare "aceite"
# 6. Add to cart and checkout
market add 3 --qty 2
market cart
market checkout --payment yape
# 7. Agent mode — natural language
market ask "compra arroz al mejor precio"
market ask "compara canasta: leche:2 arroz:1"
# 8. Machine-readable output
market --json
What you get
| You | Your AI agent |
|---|---|
pip install cli-market |
15 MCP tools |
market search "milk" |
REST API + JSON native |
| Rich terminal tables | Cross-border price intelligence |
| Spanish / English | Inflation tracking |
| Cart, checkout, reorder | Autonomous workflows |
15 MCP 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 market_basket market_inflation market_categories
Compatible with DeepSeek TUI, Claude, Cursor, Windsurf, Continue, and any MCP client. Registered on the MCP Registry.
Coverage
Every retailer below has been verified. The VTEX API responds. No dead URLs.
| Retailer | Country | Line | Currency |
|---|---|---|---|
| Carrefour | AR, BR | Supermarkets | ARS, BRL |
| Wong, Metro, Plaza Vea | PE | Supermarkets | PEN |
| Exito, Carulla, Olimpica | CO | Supermarkets | COP |
| Chedraui, HEB | MX | Supermarkets | MXN |
| Vea, Jumbo, Easy | AR | Supermarkets, Home | ARS |
| Farmatodo | MX | Pharmacies | MXN |
| Drogaria Pacheco | BR | Pharmacies | BRL |
| Motorola | AR, BR, MX, CL | Electronics | ARS, BRL, MXN, CLP |
| Electrolux | AR, CL | Electronics | ARS, CLP |
| Whirlpool | AR, IT, FR | Electronics | ARS, EUR |
| Sam's Club, Mambo | BR | Supermarkets | BRL |
8 countries. 27 retailers. 4 lines. All verified. Growing.
MCP Server
python market_mcp.py
15 tools ready for your AI agent.
API
Base: https://cli-market-api.onrender.com
Docs: /docs
GET /
POST /products/search {"query":"cafe","store":"wong"}
POST /products/compare {"query":"aceite"}
POST /v1/basket/compare {"items":[{"name":"leche","qty":2},{"name":"arroz","qty":1}]}
GET /v1/intel/inflation?country=AR
GET /v1/intel/competitor?product=leche&store_a=wong&store_b=plazavea
GET /categories/{store}
| Tier | Requests/min | Requests/day |
|---|---|---|
| Free | 10 | 100 |
| Enterprise | Contact |
Architecture
AI Agent
│
CLI Market API
│
27 verified VTEX retailers
│
Data moat — prices every 4h, deduplicated, historical
Data Moat
Price collector runs every 4 hours. Thousands of verified prices per day.
python collect_prices.py # run once
python collect_prices.py --daemon # continuous
python collect_prices.py --status # stats
python collect_prices.py --report # latest prices
PostgreSQL in production. SQLite for local dev. Circuit breaker. Parallel.
Links
- Landing: cli-market.dev
- API: cli-market-api.onrender.com
- MCP Registry:
io.github.Treevu-ai/cli-market - Telegram: @climarketbot
Legal
Software: MIT License. Data: Proprietary — Data License Agreement.
MIT © 2026 CLI Market · Treevu AI
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cli_market-1.0.25.tar.gz.
File metadata
- Download URL: cli_market-1.0.25.tar.gz
- Upload date:
- Size: 39.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b55f715701dba52055d8ce3b3bcb8a5330b0c0cb4a91f28db5c243d31cfe491c
|
|
| MD5 |
4713a26c372c8d845abe96184cb6880e
|
|
| BLAKE2b-256 |
676d5ca5eb5e192071fc7ebc15bab8a69fddc0803d3d6fb697166d0df553d277
|
File details
Details for the file cli_market-1.0.25-py3-none-any.whl.
File metadata
- Download URL: cli_market-1.0.25-py3-none-any.whl
- Upload date:
- Size: 41.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7c22c947db7cdba21c7bc4d1d17458c07fa0bdbd882dda170a2f81ad6f5b9d4e
|
|
| MD5 |
978f2529fb2c16a1f9c4b8369eb9b40c
|
|
| BLAKE2b-256 |
f860a30cb4b516cf8d03b4d95aaa5be477e7df3455ba4938744fb804221bc417
|