airshelf

# AirShelf — Verified Product Search & Checkout for AI Agents

Search, compare, and buy products across verified merchants. Returns structured Decision Pack data (best_for, pros, cons, allergens, verified pricing) — not raw web scrapes.

No CAPTCHAs. No auth. No bot detection. Agent-native commerce.

## When to Use

Activate this skill when the user wants to:
- Find or search for a product ("find me a mosquito repellent for kids")
- Compare products ("compare these two printers")
- Buy or checkout a product
- Get product recommendations based on a problem ("I'm tired all the time", "my skin is dry")
- Look up verified product details, pricing, or allergens

## API Base URL

```
https://dashboard.airshelf.ai
```

All endpoints are public. No API key needed. CORS enabled.

## Step 1: Search Products

Find products by natural language query. Returns structured data with Decision Packs.

```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=QUERY&limit=5" | python3 -m json.tool
```

**Parameters:**
- `q` — Search query (natural language, e.g. "barcode printer for warehouse"). Supports intent parsing: "energy supplements under $100" auto-extracts price filter.
- `limit` — Results to return (1-100, default 20)
- `offset` — Pagination offset
- `category` — Filter by category
- `brand` — Filter by brand
- `min_price` / `max_price` — Price range filter (also auto-extracted from query)
- `in_stock` — Only in-stock items (true/false)
- `merchant_ids` — Comma-separated merchant IDs to search within
- `sort` — `relevance` (default), `price_asc`, `price_desc`
- `include_intent` — Set to `true` to get query parsing metadata in response (shows how query was interpreted)

**Response includes for each product:**
- `title`, `brand`, `price`, `availability`, `link`
- `decision_pack.primary_benefit` — Main value proposition
- `decision_pack.best_for` — Array of ideal use cases
- `decision_pack.pros` / `decision_pack.cons` — Verified trade-offs
- `decision_pack.allergens` — Safety...