mcp-name: io.github.Treevu-ai/cli-market-world - CLI Market: commerce API for AI agents. 22 curated MCP tools (46 legacy), 44 indicators, 38 verified retailers in 8 countries. MIT.
Project description
mcp-name: io.github.Treevu-ai/cli-market-world
🛒 CLI Market
🇪🇸 Español
Infraestructura de comercio para agentes de IA — el middleware LATAM entre UCP/ACP y los retailers que aún no están listos.
Stripe convirtió los pagos en APIs. CLI Market convierte el comercio LATAM en una — middleware LATAM preparado para integración UCP y ACP cuando el comercio agéntico llegue a la región.
Los protocolos agénticos (ACP de OpenAI/Stripe · UCP de Google/Shopify/Visa/Walmart) ya están estandarizando cómo los agentes descubren y evalúan productos. Falabella, Ripley, Wong, Metro no van a implementar estos protocolos solos. CLI Market es el puente.
CLI Market lo resuelve. Un solo pip install. Una llamada a la API que cubre 68 retailers (38 verificados activos) en 8 países. Un único esquema JSON compatible con cualquier protocolo agéntico.
- 🌍 68 retailers (38 verificados activos) · 8 países · 4 plataformas · 22 herramientas MCP (46 legacy) · 44 indicadores
- 💰 Más de 55,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 68 retailers (38 verificados activos) de 8 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 — 34 indicadores de mercado a partir de datos 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
- 🔗 Protocol-ready — schema JSON normalizado, diseñado para mapear a UCP (Google/Shopify/Visa) y ACP (OpenAI/Stripe); el retailer LATAM no implementa el protocolo por su cuenta
🌐 cli-market.dev · 📚 Docs · 🔧 MCP /tools · 📊 Stats · API · Dashboard
🚀 Inicio rápido
pip install cli-market-world
market hello # post-instalación: estadísticas + próximos pasos (API prod por defecto)
market init # cuenta + primera búsqueda + MCP (recomendado)
# Solo para servidor local: export MARKET_API_URL=http://127.0.0.1:8765
# Sesión existente: market login
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 ask "compra arroz al mejor precio"
market intel indicators --country PE
market intel enrichment -c PE
¿Qué hace market checkout? Crea una orden en CLI Market y abre el pago (Yape/Plin manual, PayPal/MP vía gateway). No completa compras en Wong, Rappi ni Mercado Libre. Matriz completa: GET /v1/capabilities.
💵 Planes (simplificado — foco en 1 ICP principal: AI Agent Builders)
| Plan | Free | Pro | Enterprise |
|---|---|---|---|
| Precio | $0 | Starter $24/mes · Pro $39/mes · Founding $29 · Anual $390 | A medida |
| Solicitudes/día | 1,000 | 10,000 | Ilimitadas (negociado) |
| Solicitudes/min | 60 | 300 | Ilimitadas |
| API keys | 1 | 10 | Ilimitadas |
| Agente 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.
🇬🇧 English
Commerce infrastructure for AI agents — the LATAM middleware between UCP/ACP protocols and retailers that aren't ready yet.
Stripe turned payments into APIs. CLI Market turns LATAM commerce into one — LATAM middleware built for UCP and ACP integration when agentic commerce reaches the region.
Agentic protocols (ACP by OpenAI/Stripe · UCP by Google/Shopify/Visa/Walmart) are already standardizing how agents discover and evaluate products. Falabella, Ripley, Wong, Metro won't implement these protocols on their own. CLI Market is the bridge.
CLI Market fixes that. One pip install. One API call across 68 retailers (38 verified active) in 8 countries. One JSON schema compatible with any agentic protocol.
- 🌍 68 retailers (38 verified active) · 8 countries · 4 platforms · 22 curated MCP tools (46 legacy) · 44 indicators
- 💰 55,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 68 retailers (38 verified active) in 8 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 — 34 market indicators 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
- 🔗 Protocol-ready — normalized JSON schema designed to map to UCP (Google/Shopify/Visa) and ACP (OpenAI/Stripe); LATAM retailers don't implement the protocol themselves
🌐 cli-market.dev · 📚 Docs · 🔧 MCP /tools · 📊 Stats · API · Dashboard
🚀 Quick start
pip install cli-market-world
market hello # post-install: stats + next steps (production API by default)
market init # account + first search + MCP (recommended)
# Local server only: export MARKET_API_URL=http://127.0.0.1:8765
# Returning session: market login
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 ask "buy rice at the best price"
market intel indicators --country PE
market intel enrichment -c PE
What does market checkout do? Creates a CLI Market order and opens payment (manual Yape/Plin, PayPal/MP via gateway). It does not complete purchases on Wong, Rappi, or Mercado Libre. Full matrix: GET /v1/capabilities.
💵 Pricing (simplified — focus on 1 primary ICP: AI Agent Builders)
| Plan | Free | Pro | Enterprise |
|---|---|---|---|
| Price | $0 | Starter $24/mo · Pro $39/mo · Founding $29 · Annual $390 | Custom |
| Requests/day | 1,000 | 10,000 | Unlimited (negotiated) |
| Requests/min | 60 | 300 | Unlimited |
| API keys | 1 | 10 | Unlimited |
| Intel agent | — | 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 & MCP — install, auth, compare, basket, intel, MCP setup
- Use cases & pricing — AI agent builders, procurement, intelligence pilots
- Public stats / data-gate — live moat metrics; MAA (Monthly Active Agents) is the north star
🏗️ Ecosystem architecture
CLI Market is composed of 4 specialized repositories, each with a single responsibility:
cli-market-backend Data ingestion — VTEX scrapers, FastAPI server, 68 retailers, 52k+ prices
|
v raw snapshots
cli-market-index Semantic Refinery — entity resolution, Golden Records (prod_ IDs)
|
v canonical identities
cli-market-core Intelligence — indicators, stats, billing, connectors, 22 MCP tools (default)
|
v structured intelligence
cli-market-world Exposure — landing, docs, MCP registry, deployment configs (THIS REPO)
| Repo | Visibility | Role |
|---|---|---|
cli-market-backend |
Private | Scrapers + FastAPI API |
cli-market-index |
Private | Entity resolution engine |
cli-market-core |
Public | Intelligence + MCP tools |
cli-market-world |
Private | Landing + docs (this repo) |
cli-market-content |
Private | GTM + content calendar |
📊 Dashboard auditability
Every price in CLI Market is traceable and verifiable. The live dashboard exposes:
- Cobertura 7 días —
coverage_7d_pctper retailer: what % of each store's catalog refreshed in the last week - Normalización por kg/L — unit price visible next to shelf price (e.g.
PEN 4.20/kg), with counter of non-parseable names - Confianza por snapshot —
okvssuspectdistribution from scrape-quality heuristics - Percentiles 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 timestamp - Foso de datos —
inventory_daily[]time series + growth stats (total snapshots, daily avg, days tracked)
All six capabilities are backed by the same 52,000+ shelf prices, refreshed every 4 hours by the collector daemon.
🔧 22 MCP tools (default profile) · 44 indicators
market_whoami market_subscription market_favorites market_price_alerts market_preferences market_intel_brief market_inflation market_scores market_stats market_export market_trending market_login market_discover market_search market_compare market_add market_cart market_cart_update market_checkout market_orders market_ask market_basket
SINAPSIS INNOVADORA S.A.C. — RUC 20613045563 — Lima, Peru
MIT License · cli-market.dev
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_world-1.9.41.tar.gz.
File metadata
- Download URL: cli_market_world-1.9.41.tar.gz
- Upload date:
- Size: 164.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
576afa83249f8c18ccb176059b1bd7a2934eae83b9a215a0c40b9866a3cf1ae5
|
|
| MD5 |
926f8f8a58ef34df16ee07b5983a3f2a
|
|
| BLAKE2b-256 |
78cfb25be6555eab1b1a843daa00071177d069a87d4592f8a92b8e803a08e034
|
File details
Details for the file cli_market_world-1.9.41-py3-none-any.whl.
File metadata
- Download URL: cli_market_world-1.9.41-py3-none-any.whl
- Upload date:
- Size: 104.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba36f948bf8b94d5ad88b0a385e4bf56ae52aea66bd988a05df75aa093b02378
|
|
| MD5 |
ad61a9119e204ad65fd0d96b0a12389c
|
|
| BLAKE2b-256 |
e4d42cd4dc31d367fe072d0f6c20691e8ef13a58ce7f9f3e4b3d56d51ab8ee48
|
