gift-genius

# Gift Genius — Valentine's Day Gift Finder

Find the perfect Valentine's gift based on location, budget, and recipient. Returns 2-3 curated options with Decision Packs — not endless scrolling.

## When to Use

Activate when the user wants to:
- Find a Valentine's Day gift
- Get gift recommendations for a partner/spouse/friend
- Find flowers or wellness gifts
- Ask "what should I get for Valentine's?"

## Merchant IDs (Critical!)

Always use `merchant_ids` filter:

| Location | Merchant | ID | Products |
|----------|----------|-----|----------|
| US | UrbanStems | `cmlj83avd0000nighc559g9fv` | 105 flowers ($25-$280) |
| Singapore | Avea Life | `cmhvyt9w10000i5fg23ztinkd` | 286 supplements (€29-€199) |

## Quick Reference: Flower Types

| Type | Query | Price Range | Best For |
|------|-------|-------------|----------|
| Peonies | `q=peony` | $110-280 | Luxury, classic elegance |
| Orchids | `q=orchid` | $66-88 | Long-lasting, elegant |
| Roses | `q=rose+valentine` | $76-229 | Traditional romance |
| Mixed | `q=bouquet+romantic` | $60-200 | Variety, color |

## Recipient Matching Guide

**For Wife/Long-term Partner:**
- Query: `romantic+elegant` or `peony`
- Budget: $100-200 (shows you put thought in)
- Picks: The Peony ($110), The Passion ($98), The Classic Affair ($115)

**For New Girlfriend:**
- Query: `romantic+valentine`
- Budget: $75-120 (thoughtful but not overwhelming)
- Picks: The Valentine ($90), The First Date ($82), The Blushing Beauty ($82)

**For Mom/Family:**
- Query: `orchid` or `elegant`
- Budget: $66-100
- Picks: The Orchid Garden ($88), The Neutral Orchids ($74)

**For Friend:**
- Query: `bright+cheerful` or `unicorn`
- Budget: $60-90
- Picks: The Unicorn ($72), The Flounce ($82)

## API Calls

**Basic search:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=QUERY&merchant_ids=MERCHANT_ID&min_price=MIN&max_price=MAX&limit=5"
```

**Examples:**
```bash
# Wife, $150 budget
curl -s "https://dashboard.airshelf.ai/api/search?q=romantic+eleg...