Skip to main content

CLI Market — 27 verified VTEX retailers across 8 countries, 4 lines. Commerce infrastructure for AI agents.

Project description

CLI Market

30 retailers 6 lines 8 countries 19 MCP tools py MIT build Vercel

PyPI version PyPI downloads GitHub stars ProductHunt featured

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 (17 MCP tools)
  • Build — data moat with thousands of verified prices, historical snapshots, SKU normalization

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

cli-market.dev


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

17 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 market_barcode market_enrich

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

17 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


Legal

Software: MIT License. Data: Proprietary — Data License Agreement.

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.1.0.tar.gz (39.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.1.0-py3-none-any.whl (39.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cli_market-1.1.0.tar.gz
  • Upload date:
  • Size: 39.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.1.0.tar.gz
Algorithm Hash digest
SHA256 ba58df799f6fc88e658ff99a4ce49a020066def43df153c8e1bd49b114a13b7b
MD5 0cf62af63405835aec48286e9c8ee6a1
BLAKE2b-256 d4182e5273884a9b46d94b59d8cfad34ff098e508c5d81ca7be3b18eca93e3f3

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cli_market-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 39.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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 838f9d51d1a6847dbe6d96c70732dbacd03c2fe6882fd76b1ade6df01ff20fed
MD5 7e5969079d6e81b4806c18434ef3831f
BLAKE2b-256 7177e4d22463d1cb473f4f4aa3c33a3d2ba3b8d17282862bd85cf17e0f648227

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