CLI MARKET
CLI Market is a Cost-of-Living OS for Latin America providing a unified API to search, compare, and purchase products across 41+ verified retailers in 9 countries, with built-in intelligence tools for price tracking, inflation analysis, and procurement signals.
🛒 Shopping & Product Discovery
Search products across retailers in PE, AR, MX, BR, CO, CL, ES, US
Compare prices side-by-side across retailers, with optional TCO (Total Cost of Ownership) breakdown
One-call basket optimization — basket compare + TCO + substitutes + intel + action links in a single call
Find substitutes — unit-normalized alternatives with savings and Nutri-Score tradeoffs
Barcode lookup — look up any product by EAN/UPC
Natural language shopping — plain text prompts like "buy milk" or "compare rice"
🛍️ Cart & Checkout
Add items to cart, view/modify quantities, and remove items
Checkout via internal CLI Market payment methods (Yape, Plin, PayPal, tarjeta) — not retailer-site checkout
Order history and reorder last purchase
📊 Intelligence & Market Analytics
Intel brief — narrative with shelf signals, macro CPI gap, composite scores, and moat confidence
Shelf inflation tracking — price deltas and average inflation by country and business line
Affordability OS — canasta pressure, wage ratio, macro gap, regulatory headlines
Composite scores — retail aggression, price fairness, basket stress, data confidence
Price risk intelligence — identify volatile categories with risk levels (low/moderate/high)
Procurement signals — buy_now / monitor / wait based on basket stress and price trends
Trending products — items with largest price movement in the last 7 days
Export data — price data as CSV or JSON (requires Starter tier+)
👤 Account Management
Authentication, subscription info, rate limits, and API keys
Favorites, price alerts, and user preferences
Household profile — budget, dietary restrictions, staple list, and default stores
🔧 Advanced Tools
Retail discovery — explore all business lines, retailers, and countries in one call
Receipt scanning — OCR-based ticket scanning to compare receipt prices against the data moat
Crowd moat validation — submit scanned receipts to the crowd validation pipeline
Allows searching and comparing prices from Carrefour across multiple Latin American countries, enabling basket optimization and price comparisons.
Allows payments via Mercado Pago (including QR codes like Yape/Plin) for internal CLI Market orders.
Allows payments via PayPal for internal CLI Market orders.
mcp-name: io.github.Treevu-ai/cli-market-world
🛒 CLI Market
🇪🇸 Español
Cost-of-Living OS para LatAm — optimiza tu compra en una llamada.
Stripe convirtió los pagos en APIs. CLI Market convierte el costo de vida en una.
market optimize "leche, arroz, aceite" --country PE — una llamada compara toda la canasta entre 41 retailers, calcula TCO, sugiere sustitutos y genera links de acción. Falabella, Ripley, Wong, Metro no van a exponer APIs de comercio por su cuenta. CLI Market es el puente.
CLI Market lo resuelve. Un solo pip install. Una llamada a la API que cubre 380 retailers (336 verificados activos) en 21 países. Un único esquema JSON listo para integrar.
🌍 380 retailers (336 verificados activos) · 21 países · 4 plataformas
💰 Más de 174,000+ precios de góndola verificados, normalizados por kg/L, actualizados cada 4 horas
💳 Pago con PayPal + Mercado Pago + QR (Yape/Plin) integrado
✨ ¿Por qué CLI Market?
🔎 Busca cualquier producto en 380 retailers (336 verificados activos) de 21 países
📊 Compara precios transfronterizos — PEN, ARS, BRL, MXN, COP, CLP, EUR, USD — normalizados por kg/L cuando es posible
🧺 Canasta — compara tu carrito completo entre retailers (p. ej. Carrefour vs Jumbo vs Vea en AR)
📈 Inflación — sigue cambios reales de precios desde la góndola, actualizados cada 4 horas; historial de hasta 12 meses para señales de cuándo comprar, no solo qué
🧠 Enriquecimiento — datos de mercado a partir de góndola + APIs públicas (OFF, Wikimedia, IMF, Eurostat, BCB, Banco Mundial)
🛍️ Compra — orden interna CLI Market + pago LATAM (PayPal / Yape / Plin); no checkout en sitio del retailer
🏗️ Construye — foso de datos con spreads filtrados por calidad, matching de canasta y dashboard en vivo
🔗 API-first — schema JSON normalizado, listo para integrar; el retailer LATAM no expone APIs por su cuenta
🌐 cli-market.dev · 📚 Docs · 🔧 Tools · 📊 Stats · API · Dashboard
🚀 Inicio rápido
pip install cli-market-world
market hello # post-instalación: estadísticas + próximos pasos
market init # cuenta + primera búsqueda (recomendado)
# Cost-of-Living OS — una llamada optimiza toda la canasta
market optimize "leche evaporada, arroz 5kg, aceite" --country PE
# Flujo granular (opcional)
market search "leche" --country PE
market compare "aceite de girasol 900ml" --country AR
market basket "arroz:1 aceite:1 leche:1" --country AR
market checkout --payment yape
market intel brief --country PE¿Qué hace market optimize? Compara toda la canasta entre retailers, calcula TCO, sugiere sustitutos con ahorro y genera links de acción — una sola llamada. market checkout crea una orden interna CLI Market con pago vía Yape/Plin/PayPal; no completa compras en Wong, Rappi ni Mercado Libre.
💵 Planes
Plan | Starter | Pro | Enterprise |
Precio | $9/mes (prueba gratis 7 días) | $39/mes · Anual $390 | A medida |
Solicitudes/día | 5,000 | 10,000 | Ilimitadas (negociado) |
Solicitudes/min | 120 | 300 | Ilimitadas |
API keys | 1 | 10 | Ilimitadas |
Intel | — | Ilimitado | Ilimitado + white-label |
Alertas de precio | — | ✅ Hasta 10 (email) | Ilimitadas (email + webhook) |
Historial de precios | 7 días | 12 meses | Completo |
Exportar datos | — | CSV ilimitado + cron | Feed directo S3/webhook |
Checkout | — | ✅ PayPal / Yape / Plin | ✅ |
Soporte | Comunidad | Email 4h | 24/7 + SLA escrito |
Anual | — | $390/año | — |
¿Quién compra qué? (ecosistema)
Buyer | Producto | Precio |
Developer / agent builder que integra comercio en su software | CLI Market Pro | $39/mes |
Equipo de compras (restaurante, hotel, agro) — sin código | Procure Copilot | $29–149/mes (infra CLI Market incluida en Pro+) |
Analista / fintech que necesita datos, no checkout | Intelligence | $300–500/mes |
Equipos de procurement no necesitan CLI Market Pro por separado. Ver planes y pricing.
Related MCP server: MCP FacturaScripts
🇬🇧 English
Cost-of-Living OS for LatAm — optimize your purchase in one call.
Stripe turned payments into APIs. CLI Market turns cost of living into one.
market optimize "milk, rice, oil" --country PE — one call compares your full basket across 41 retailers, calculates TCO, suggests substitutes, and generates action links. Falabella, Ripley, Wong, Metro won't expose commerce APIs on their own. CLI Market is the bridge.
CLI Market fixes that. One pip install. One API call across 380 retailers (336 verified active) in 21 countries. One JSON schema ready to integrate.
🌍 380 retailers (336 verified active) · 21 countries · 4 platforms
💰 174,000+ verified shelf prices, normalized per kg/L, refreshed every 4 hours
💳 PayPal + Mercado Pago + QR (Yape/Plin) checkout built in
✨ Why CLI Market?
🔎 Search any product across 380 retailers (336 verified active) in 21 countries
📊 Compare cross-border prices — PEN, ARS, BRL, MXN, COP, CLP, EUR, USD — normalized per kg/L where parseable
🧺 Basket — compare your full cart across retailers (e.g. Carrefour vs Jumbo vs Vea in AR)
📈 Inflation — track real shelf-price changes, updated every 4 hours; up to 12-month history for when-to-buy signals, not just what-to-buy
🧠 Enrichment — market data from shelf data + public APIs (OFF, Wikimedia, IMF, Eurostat, BCB, World Bank)
🛍️ Buy — internal CLI Market order + LATAM payment (PayPal / Yape / Plin); not retailer-site checkout
🏗️ Build — data moat with quality-filtered spreads, basket matching, and live dashboard
🔗 API-first — normalized JSON schema, ready to integrate; LATAM retailers don't expose APIs themselves
🌐 cli-market.dev · 📚 Docs · 🔧 Tools · 📊 Stats · API · Dashboard
🚀 Quick start
pip install cli-market-world
market hello # post-install: stats + next steps
market init # account + first search (recommended)
# Cost-of-Living OS — one call optimizes your full basket
market optimize "evaporated milk, 5kg rice, cooking oil" --country PE
# Granular flow (optional)
market search "leche" --country PE
market compare "aceite de girasol 900ml" --country AR
market basket "arroz:1 aceite:1 leche:1" --country AR
market checkout --payment yape
market intel brief --country PEWhat does market optimize do? Compares your full basket across retailers, calculates TCO, suggests substitutes with savings, and generates action links — one call. market checkout creates an internal CLI Market order with payment via Yape/Plin/PayPal; it does not complete purchases on Wong, Rappi, or Mercado Libre.
💵 Pricing
Plan | Starter | Pro | Enterprise |
Price | $9/mo | $39/mo · Annual $390 | Custom |
Requests/day | 5,000 | 10,000 | Unlimited (negotiated) |
Requests/min | 120 | 300 | Unlimited |
API keys | 1 | 10 | Unlimited |
Intel | — | Unlimited | Unlimited + white-label |
Price alerts | — | ✅ Up to 10 (email) | Unlimited (email + webhook) |
Price history | 7 days | 12 months | Full dataset |
Export | — | CSV unlimited + cron | Direct S3/webhook feed |
Checkout | — | ✅ PayPal / Yape / Plin | ✅ |
Support | Community | Email 4h | 24/7 + written SLA |
Annual | — | $390/yr | — |
Who buys what (ecosystem)
Buyer | Product | Price |
Developer / agent builder embedding commerce in their software | CLI Market Pro | $39/mo |
Procurement team (no code) | Procure Copilot | $29–149/mo (CLI Market infra bundled on Pro+) |
Analyst / fintech needing data, not checkout | Intelligence | $300–500/mo |
Procurement teams do not need a separate CLI Market Pro subscription. See pricing.
📖 Learn more
Docs — quick start — install, auth, compare, basket, intel, setup
Use cases & pricing — developers, procurement, intelligence
Public stats / data-gate — live data metrics; MAA (Monthly Active Agents) is the north star
🏗️ Ecosystem architecture
CLI Market is composed of 4 product repos + 1 GTM repo:
cli-market-backend Mirror API — paridad con prod, FastAPI server, 82 retailers (live: GET /analytics/stats)
|
v raw snapshots
cli-market-index Semantic Refinery — entity resolution, Golden Records (prod_ IDs)
|
v canonical identities
cli-market-core Intelligence SDK — MCP tools, billing, indicators (PyPI public)
|
v structured intelligence
cli-market-world Exposure — landing, docs, ops/CI, Fly.io prod + PyPI (THIS REPO)Repo | Visibility | Role |
| Private | Mirror API + FastAPI server |
| Private | Entity resolution engine |
| Public | Intelligence SDK + MCP tools |
| Public | Landing + docs + Fly.io prod |
| Private | GTM + content calendar |
📊 Dashboard auditability
Every price in CLI Market is traceable. The live dashboard exposes:
Cobertura 7 días —
coverage_7d_pctper retailer: what % of each store's catalog refreshed in the last weekNormalización por kg/L — unit price visible next to shelf price (e.g.
PEN 4.20/kg), with counter of non-parseable namesConfianza por snapshot —
okvssuspectdistribution from scrape-quality heuristicsPercentiles P25/P50/P75 — median replaces mean in category comparisons; eliminates outlier distortion (e.g. ARS 230K in departamentales)
Trazabilidad de outliers — group size, band (
median ± k·IQR), acceptable bounds, scraper health state, capture timestampFoso de datos —
inventory_daily[]time series + growth stats (total snapshots, daily avg, days tracked)
All six capabilities are backed by the same 63,000+ shelf prices, refreshed every 4 hours by the collector daemon.
🔧 API tools (Shop · Intel · Account)
32 MCP tools (default profile) across Shop, Intel, and Account bundles. Full catalog at cli-market.dev/tools · mcp.json.
The canonical entry point is market_optimize_purchase — one call covers basket compare, TCO, substitutes, intel, and action links. The legacy search → compare → basket flow remains available for granular use.
Client setup guides: Open WebUI · Claude Desktop · LangChain · Mistral.
SINAPSIS INNOVADORA S.A.C. — RUC 20613045563 — Lima, Peru
MIT License · cli-market.dev
Available Tools
32 toolsmarket_addA
[Shop] Add to cart. Copy ALL four fields from market_search: product_id, name, price, store (use store_key value as store). Missing fields cause 422 — re-run market_search if needed.
Inputs: product_id (required), name (required), price (required), store (required), +1 more.
market_affordabilityC
[Intel] Affordability OS — canasta pressure, wage ratio, macro gap, regulatory headlines. One-call cost-of-living composite for LATAM.
Inputs: country, line, days.
market_askA
[Shop] Natural-language shopping. Examples: 'buy milk', 'repeat last purchase', 'compare rice'.
Inputs: prompt (required).
market_barcodeB
[Advanced] Look up product by EAN/UPC barcode.
Inputs: code (required).
market_basketA
[Shop] Compare total basket cost across retailers. Pass items with name and qty. Returns per-store totals and cheapest retailer. LATAM differentiator — 41 verified retailers across 8 countries.
Inputs: items (required), stores, include_tco, include_action_links, +1 more.
market_cartA
[Shop] View current cart with products, quantities, prices, and total.
Inputs: no named parameters.
market_cart_updateA
[Shop] Change item quantity in cart. Use quantity=0 to remove (replaces market_cart_remove in PR2).
Inputs: product_id (required), quantity (required).
market_checkoutA
[Shop] Pay for cart via CLI Market (Yape/Plin/PayPal) — creates internal order, not checkout on retailer sites. Requires Pro tier for live charge. payment_method: yape, plin, paypal, tarjeta. See GET /v1/capabilities.
Inputs: payment_method.
market_compareA
[Shop] Compare prices for one query across retailers side-by-side. Use when the user asks for cheapest option or cross-store comparison. Set country (e.g. PE) or store to avoid timeouts.
Inputs: query (required), store, country, line, +2 more.
market_discoverA
[Shop] Retail coverage in one call: business lines, retailers, and countries. Replaces market_lines + market_stores + market_countries. 41 verified retailers across 8 countries.
Inputs: country, line.
market_exportC
[Intel] Export data moat as CSV or JSON. Requires starter tier or above.
Inputs: country, line, format, limit.
market_favoritesC
[Account] Manage favorite products: list, add, or remove. Omit action for list.
Inputs: action, product_id, name, store.
market_household_getB
[Account] Household profile: budget, restrictions, staple list, default stores.
Inputs: no named parameters.
market_household_updateC
[Account] Create or update household profile (budget, restrictions, staples).
Inputs: payload (required), patch.
market_inflationC
[Intel] Shelf inflation from the data moat: price deltas and average inflation. Filter by country or line.
Inputs: country, line, days.
market_inflation_reportB
[Intel] Inflation Intelligence — where is price pressure increasing? Returns pressure level (stable/rising/rising_fast/falling/above_official) from internal shelf inflation and macro CPI gap.
Inputs: country, line, days.
market_intel_briefA
[Intel] One-call intelligence narrative: shelf signals, macro gap vs official CPI, composite scores, and moat confidence. Replaces indicators + analytics + enrichment reads.
Inputs: country, line, days, include_catalog.
market_loginA
[Shop] Authenticate in CLI Market. Call before cart, checkout, or orders. Returns access + refresh tokens (access default 90d, refresh 365d) persisted locally. On 401 with expired access, CLI auto-calls POST /auth/refresh; agents may re-login or refresh.
Inputs: username, password.
market_optimize_purchaseA
[Shop] One-call purchase optimization: basket compare, TCO, substitutes, intel, and action links. Replaces fragmented search → compare → intel for agents.
Inputs: items (required), country, constraints, include_intel.
market_ordersC
[Shop] Order history. Set reorder_last=true to repeat the last order.
Inputs: reorder_last.
market_preferencesB
[Account] User preferences from purchase history: favorite stores, total spent.
Inputs: no named parameters.
market_price_alertsC
[Account] Price alerts: query drops or configure threshold notifications for a product.
Inputs: product (required), store, threshold_pct, limit.
market_price_riskA
[Intel] Price Risk Intelligence — which categories are becoming volatile? Returns risk level (low/moderate/high) with supporting signals from price dispersion, promo intensity, and staple momentum.
Inputs: country, line, days.
market_procurement_signalA
[Intel] Procurement Intelligence — when should I buy? Returns buy_now/monitor/wait signal from basket stress, search momentum, and staple price trends.
Inputs: country, line.
market_scoresC
[Intel] Composite moat scores: retail_aggression, price_fairness, basket_stress, data_confidence, macro_alignment.
Inputs: country, line.
market_searchA
[Shop] Search products across 41 verified retailers across 8 countries. Returns JSON with product_id, name, price, store_key (required for market_add), store, and line. Filter by line or store ID. Prefer this over scraping.
Inputs: query (required), store, country, line, +1 more.
market_statsB
[Intel] Data moat health: total prices, active stores, tracked products, last refresh.
Inputs: no named parameters.
market_subscriptionA
[Account] Current subscription plan: tier, rate limits, available API keys.
Inputs: no named parameters.
market_substitutesA
[Shop] Product substitutes with unit-normalized savings and Nutri-Score tradeoffs. Use when exact SKU unavailable or optimizing basket.
Inputs: query (required), country (required), store, limit.
market_ticketA
[Advanced] Scan purchase receipt via OCR and compare prices against the data moat. Pass a public image URL. Set submit_to_crowd to persist moat validation.
Inputs: url (required), country, submit_to_crowd, line_items.
market_trendingC
[Intel] Products with largest price movement in the last 7 days.
Inputs: country, line, limit.
market_whoamiA
[Account] Verify identity: username and subscription tier for the authenticated user.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Each tool has a clearly distinct purpose, grouped by domain (Shop, Intel, Account, Advanced). Even similar-sounding tools like market_compare and market_basket are differentiated by scope (single query vs. basket comparison), avoiding confusion.
All tools use lowercase snake_case with the 'market_' prefix, but naming patterns vary: some are verbs (market_add, market_search) while others are nouns or noun phrases (market_basket, market_inflation_report). This is mostly consistent but not strictly verb_noun.
With 32 tools, the count is on the high side, bordering on heavy. However, the tools cover a wide range of functionalities (shopping, intelligence, account management, advanced features) which justifies the number, but it could be streamlined.
The tool set is comprehensive for a CLI market server, covering search, cart management, checkout, orders, account profile, preferences, price alerts, intelligence reports (inflation, risk, procurement), and advanced features like barcode scanning and receipt OCR. No obvious gaps.
Maintenance
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.19 npm20MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that integrates with the FacturaScripts ERP system, providing resources and tools to manage clients, products, invoices, accounting entries, and business analytics through natural language.10-
- AlicenseAqualityDmaintenanceMCP server for Karrito - the digital catalog builder for WhatsApp sellers in LATAM, enabling AI assistants to manage store operations like products, orders, discounts, reviews, shipping, and analytics.3020 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage products, shopping carts, and orders in an online store through a well-defined MCP API.-