Skip to main content

API · API de compras para IA

35 API tools para agentes de comercio

API de comercio para agentes de IA — Shop, Intel y Account en 37 retailers. Copie una config, ejecute pip install cli-market-world, conecte su IDE.

Perfil default (35 tools) · legacy: 60 tools con aliases

Requisitos previos

# Python 3.11+
pip install cli-market-world
market init
market mcp-setup --ide cursor   # cursor | claude | windsurf | vscode
{
  "mcpServers": {
    "cli-market": {
      "command": "market-mcp",
      "args": [],
      "env": {
        "MARKET_API_URL": "https://cli-market-api.fly.dev",
        "MCP_TOOL_PROFILE": "default"
      }
    }
  }
}

Requiere pip install cli-market-world · Manifest: mcp.json · Docs: llms.txt

Bundles (Shop · Intel · Account)

Perfil con 35 herramientas. Use MCP_TOOL_PROFILE=legacy para 60 tools (aliases incluidos).

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.

+ 25 herramientas más en perfil legacy (advanced, admin, aliases)

Flujos recomendados por ICP →