DEV Community

Cover image for Add Commerce to Your AI Agent in 4 Lines
Ricardo Cuba
Ricardo Cuba

Posted on

Add Commerce to Your AI Agent in 4 Lines

4 commands. 38 retailers. 8 countries. Your agent just learned how to shop.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
The problem
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

You're building an AI agent. It can search the web, reason about complex topics, generate code. But when it needs to answer a simple question like "how much does rice cost in Lima today?" — it hits a wall.

Not because it's dumb. Because every retailer has a different API, auth mechanism, schema, and checkout flow. There's no Stripe for commerce data.

Until now.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
4 lines. That's it.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

'''bash
# 1. Install
pip install cli-market-world

# 2. Guided first search + interactive tutorial
market init           # login + first query
market tutorial       # 3 exercises: search, compare, export — 60 seconds

# 3. Search — your agent just queried 38 retailers in <1s
market search "leche" --country PE --json

# 4. Connect to your AI agent via MCP
# Add to Cursor / Claude / any MCP client:
# → https://cli-market.dev/tools?utm_source=devto&utm_campaign=spike-jun09
'''
Enter fullscreen mode Exit fullscreen mode

That's the entire integration. No API keys per retailer. No HTML scraping. No schema mapping.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What happens under the hood
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

When your agent runs market search "rice" --country PE --json, CLI Market:

  1. Normalizes the query — "arroz", "rice", "arroz blanco" all map to the same product
  2. Queries our collector — 38 active retailers, refreshed every 4 hours
  3. Returns structured JSON — price per kg/L, store name, country, timestamp
  4. Handles auth — one CLI Market token, not 38 retailer tokens

What it looks like in your terminal:

![CLI Market terminal output — 60 seconds, real prices]

'''json
{
  "query": "arroz",
  "country": "PE",
  "results": [
    {
      "product": "Arroz Extra 5kg",
      "price": 18.90,
      "price_per_kg": 3.78,
      "store": "Wong",
      "country": "PE",
      "refreshed_at": "2026-06-10T08:00:00Z"
    }
  ]
}
'''
Enter fullscreen mode Exit fullscreen mode

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MCP: the missing piece
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

CLI Market exposes 22 curated MCP tools (46 legacy) — search, compare, basket, checkout paths — so your agent can:

  • Search products across all retailers
  • Compare prices between stores
  • Filter by country, category, or price range
  • Get historical price data (Pro tier)

Connect in Cursor or any MCP client in 30 seconds. Configuration at cli-market.dev/tools.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What you can build with this
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  • Price monitoring agents — track commodity prices across LATAM
  • Shopping assistants — "find the cheapest 5kg rice in Lima"
  • Competitive intelligence — benchmark your retail prices against the market
  • Supply chain optimization — auto-reorder when prices drop below threshold

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What's next
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

We're working on cart + checkout — so your agent doesn't just search, it buys. One API call to add to cart across any supported retailer.

Start building:

'''bash
pip install cli-market-world
market init
'''

**MCP tools:** [cli-market.dev/tools](https://cli-market.dev/tools?utm_source=devto&utm_campaign=spike-jun09)

**Docs for agents:** [cli-market.dev/llms.txt](https://cli-market.dev/llms.txt)

Enter fullscreen mode Exit fullscreen mode

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pricing
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

| Tier | Price | Best for |
|------|-------|----------|
| Free | $0 | 1,000 req/day — prototype with `market init` |
| **Pro** | **$39/mo** | Alerts, full MCP tools, checkout, 20k req/day, 30d history — [activate](https://cli-market.dev//#pricing?utm_source=devto&utm_campaign=week2) |
Enter fullscreen mode Exit fullscreen mode

CLI Market — Commerce infrastructure for AI agents. 38 retailers. 8 countries. MIT on PyPI.

Top comments (0)