Infraestructura para agentes de IA y equipos de pricing en LatAm

CLI Market entrega precios de retail verificados vía REST y CLI. Diseñado para agentes autónomos y equipos comerciales que necesitan spreads, canasta e inflación con refresh cada 4 h.

Requisitos previos: ver Quickstart.

Detalle en Billing · Ver planes.

# Python 3.11+
pip install cli-market-world
market --version   # esperado: cli-market-world 1.11.43

De pip install a precios reales en ~5 min. Recomendado: onboarding guiado.

pip install cli-market-world
market init
market search "leche" --country PE
market doctor

market init verifica API, crea cuenta con prueba Starter de 7 días si no hay sesión, muestra readiness %.

# Python 3.11+
pip install cli-market-world
market init        # prueba 7 días + readiness %
# o: market register && market login

Cuenta con prueba Starter de 7 días vía CLI o HTTP. Registro en 2 pasos: email + código de verificación (OTP). La API key (sk-...) se muestra una sola vez, al final del paso 2.

CLI

market register --email [email protected]
# → Código enviado a [email protected]
Código de verificación: 123456
# ✓ Email verificado — cuenta creada
# Usuario: user-abc123...
# API key: sk-...   ← guárdela ahora

HTTP

# 1. Solicitar código
curl -X POST https://cli-market-api.fly.dev/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

# 2. Verificar código y crear la cuenta
curl -X POST https://cli-market-api.fly.dev/auth/verify-email \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","code":"123456"}'

RESPONSE

{
  "username": "user-abc123...",
  "api_key": "sk-...",
  "next_steps": [...]
}

Si ya tiene credenciales: market login.

Authorization: Bearer sk-...

# Python 3.11+
pip install cli-market-world
market register    # sk-... (guárdela)
market upgrade --plan starter   # o pro

Build (API/MCP): Starter ($9/mes, 7 días gratis), Pro ($49/mes o $490/año).

Sinapsis Innovadora S.A.C. (RUC 20613045563) factura suscripciones Build y Procure en dólares (USD) con PayPal y en soles (PEN) con Yape, Plin o tarjeta vía Mercado Pago. El comprobante se emite en la moneda del pago.

Canales: PayPal (USD) · Yape · Plin · Mercado Pago (soles)

CHECKOUT EN LA WEB

Pro estándar: elige PayPal (USD) o soles (Mercado Pago · Yape · Plin). En Perú, soles aparece recomendado.

CHECKOUT PROGRAMÁTICO

curl -X POST https://cli-market-api.fly.dev/billing/build-checkout \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "starter",
    "email": "[email protected]",
    "return_url": "https://cli-market.dev/build#pricing",
    "cancel_url": "https://cli-market.dev/build#pricing"
  }'

Valores de plan: starter | pro | pro_annual. La respuesta incluye approve_url para redirigir al usuario.

CLI

market register
market upgrade --plan starter
market upgrade --plan pro

Precios completos: Ver planes.

Requisitos previos: ver Quickstart.

Diagnóstico local: URL de API, salud, auth, tier, país por defecto y market-mcp en PATH.

market doctor
market --json doctor

Requisitos previos: ver Quickstart.

POST /products/compare — fuzzy match multi-retailer.

REQUEST

{
  "query": "aceite de girasol 900ml",
  "country": "AR",
  "limit": 8
}

RESPONSE

{
  "results": [
    {"store": "carrefour_ar", "name": "...", "price": 2100.5, "currency": "ARS"},
    {"store": "jumbo_ar", "name": "...", "price": 2050.0, "currency": "ARS"}
  ]
}

Requisitos previos: ver Quickstart.

POST /v1/basket/compare — canasta multi-ítem por cadena.

market basket "arroz:1 aceite:1 leche:1" --country AR

Requisitos previos: ver Quickstart.

Export CSV (`market_export`) requiere Starter o superior. Checkout retail requiere Pro.

Endpoints comerciales: /v1/intel/brief, /v1/intel/scores, /v1/intel/inflation.

# Python 3.11+
pip install cli-market-world
market init
market mcp-setup --ide cursor   # cursor | claude | windsurf | vscode

Perfil default: 35 herramientas (Shop · Intel · Account). Legacy: 60 con aliases. Configs en /tools · mcp.json.

VS Code: usa stdio local en .vscode/mcp.json (clave servers, type stdio). Ejecuta market mcp-setup --ide vscode. No uses la URL remota /mcp.

Cobertura, búsqueda, comparación, canasta y checkout.

• market_discovercanónica

  Retail coverage in one call: business lines, retailers, and countries. Replaces market_lines + market_stores + market_countries. 37 verified retailers across 9 countries.

• market_optimize_purchasecanónica

  One-call purchase optimization: basket compare, TCO, substitutes, intel, and action links. Replaces fragmented search → compare → intel for agents.

• market_add

  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.

• market_ask

  Natural-language shopping. Examples: 'buy milk', 'repeat last purchase', 'compare rice'.

• market_basket

  Compare total basket cost across retailers. Pass items with name and qty. Returns per-store totals and cheapest retailer. LATAM differentiator — 37 verified retailers across 9 countries.

• market_cart

  View current cart with products, quantities, prices, and total.

• market_cart_update

  Change item quantity in cart. Use quantity=0 to remove (replaces market_cart_remove in PR2).

• market_checkout

  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.

• market_compare

  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.

• market_login

  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.

• market_orders

  Order history. Set reorder_last=true to repeat the last order.

• market_search

  Search products across 37 verified retailers across 9 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.

• market_substitutes

  Product substitutes with unit-normalized savings and Nutri-Score tradeoffs. Use when exact SKU unavailable or optimizing basket.

Requisitos previos: ver Quickstart.

• Starter — 5,000 consultas / día · 1 clave API · export CSV · USD 9/mo · prueba gratis 7 días
• Pro — 10,000 consultas / día · 10 claves (lectura/escritura) · checkout · Intel MCP · USD 49/mo o 490/año
• Enterprise — límites y SLAs a medida

Planes completos en Ver planes. Datos comerciales sujetos al ALD/DLA.

Requisitos previos: ver Quickstart.

401 token inválido · 429 rate limit · 503 collector degradado. OpenAPI completo: https://cli-market-api.fly.dev/docs