cli-market-world 1.9.16

mcp-name: io.github.Treevu-ai/cli-market-world - CLI Market: commerce API for AI agents. 22 curated MCP tools (46 legacy), 34 indicators, 38 verified retailers in 8 countries. MIT.

mcp-name: io.github.Treevu-ai/cli-market-world

🛒 CLI Market

🌐 Español · English

---

🇪🇸 Español

Infraestructura de comercio para agentes de IA — un solo pip install, una API, cero scraping.

Stripe convirtió los pagos en APIs. CLI Market convierte el comercio en una.

Los agentes de IA todavía no pueden comprar en el mundo real. Cada retailer exige su propia autenticación, su propia lógica de búsqueda y no comparten carrito — así que los agentes fallan antes de la primera consulta.

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.

• 🌍 68 retailers (38 verificados activos) · 8 países · 4 plataformas · 22 herramientas MCP (46 legacy) · 34 indicadores
• 💰 Más de 52,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
• 🧠 Enriquecimiento — 34 indicadores de mercado a partir de datos de góndola + APIs públicas (OFF, Wikimedia, IMF, Eurostat, BCB, Banco Mundial)
• 🛍️ Compra — checkout con PayPal o QR (Yape / Plin)
• 🏗️ Construye — foso de datos con spreads filtrados por calidad, matching de canasta y dashboard en vivo

🌐 cli-market.dev · 📚 Docs de 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

💵 Planes (simplificado — foco en 1 ICP principal: AI Agent Builders)

Plan	Free	Pro	Enterprise
Precio	$0	$39/mes	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 docs/pricing-strategy.md.

---

🇬🇧 English

Commerce infrastructure for AI agents — one pip install, one API, zero scraping.

Stripe turned payments into APIs. CLI Market turns commerce into one.

AI agents still can't shop in the real world. Every retailer means separate auth, separate search logic, no shared cart — so agents fail before the first query.

CLI Market fixes that. One pip install. One API call across 68 retailers (38 verified active) in 8 countries. One JSON schema.

• 🌍 68 retailers (38 verified active) · 8 countries · 4 platforms · 22 curated MCP tools (46 legacy) · 34 indicators
• 💰 52,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
• 🧠 Enrichment — 34 market indicators from shelf data + public APIs (OFF, Wikimedia, IMF, Eurostat, BCB, World Bank)
• 🛍️ Buy — checkout with PayPal or QR (Yape / Plin)
• 🏗️ Build — data moat with quality-filtered spreads, basket matching, and live dashboard

🌐 cli-market.dev · 📚 API docs · 📊 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

💵 Pricing (simplified — focus on 1 primary ICP: AI Agent Builders)

Plan	Free	Pro	Enterprise
Price	$0	$39/mo	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 docs/pricing-strategy.md.

---

📖 Learn more

• Use Cases — AI agent builders, data scientists, retailers. Who is this for?
• Terminal Demo — 8-command walkthrough: search → compare → basket → checkout.

---

🏗️ 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, 45k 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_pct per 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 — ok vs suspect distribution 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 46,000+, refreshed every 4 hours by the collector daemon.

---

🔧 22 MCP tools (default profile) · 34 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