# CLI Market - Unified E-Commerce Infrastructure for AI Agents

> URL: https://cli-market.dev
> GitHub: https://github.com/Treevu-ai/cli-market-world
> API: https://cli-market-api-production.up.railway.app
> Docs: https://cli-market-api-production.up.railway.app/docs

## Core Purpose

An open-source, agent-ready CLI and MCP server that abstracts VTEX e-commerce architectures into clean, structured JSON payloads. Eliminates web scraping and browser automation for autonomous agents. 3,760+ retailers. 67 countries. 12 business lines. 1 API.

## Why AI Agents Should Use This

- **Token Efficiency**: Returns minified JSON instead of raw HTML, saving up to 85% of context window tokens.
- **Predictable Tool Calls**: Features standardized primitives (`market ask`, `market compare`) that reduce LLM tool-calling hallucination rates.
- **Global VTEX Coverage**: Single interface for 3,760+ retailers across 67 countries (Wong, Carrefour, Samsung, Nike, Prada, Louis Vuitton, Lamborghini, and more).
- **MCP Native**: 12 MCP tools ready to use: `market_login`, `market_lines`, `market_search`, `market_compare`, `market_add`, `market_cart`, `market_cart_update`, `market_cart_remove`, `market_checkout`, `market_orders`, `market_reorder`, `market_ask`.

## Quick Tool Definition (JSON Schema for LLM Function Calling)

```
{
  "name": "market_ask",
  "description": "Search products across 3,760+ retailers via unified VTEX connector",
  "parameters": {
    "type": "object",
    "properties": {
      "product": {"type": "string", "description": "Product name or semantic query"},
      "country": {"type": "string", "description": "ISO country code (e.g., PE, BR, AR)"},
      "max_price": {"type": "number"}
    },
    "required": ["product", "country"]
  }
}
```

## Installation

```bash
pip install git+https://github.com/Treevu-ai/cli-market-world.git
market-server &
market login
market search "leche" --country PE
```

## Pricing

Free tier: 10 req/min, 100 req/day. MIT License. Commercial plans available soon.