Skip to main content

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

Project description

CLI Market

27 retailers 4 lines 8 countries 15 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 (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.

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


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.0.25.tar.gz (39.0 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.25-py3-none-any.whl (41.0 kB view details)

Uploaded Python 3

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

Hashes for cli_market-1.0.25.tar.gz
Algorithm Hash digest
SHA256 b55f715701dba52055d8ce3b3bcb8a5330b0c0cb4a91f28db5c243d31cfe491c
MD5 4713a26c372c8d845abe96184cb6880e
BLAKE2b-256 676d5ca5eb5e192071fc7ebc15bab8a69fddc0803d3d6fb697166d0df553d277

See more details on using hashes here.

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

Hashes for cli_market-1.0.25-py3-none-any.whl
Algorithm Hash digest
SHA256 7c22c947db7cdba21c7bc4d1d17458c07fa0bdbd882dda170a2f81ad6f5b9d4e
MD5 978f2529fb2c16a1f9c4b8369eb9b40c
BLAKE2b-256 f860a30cb4b516cf8d03b4d95aaa5be477e7df3455ba4938744fb804221bc417

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