Gift Genius

SKILL.md

---
name: gift-genius
displayName: Gift Genius
description: Location-aware Valentine's Day gift finder. Routes US users to premium flowers (UrbanStems), Singapore users to wellness supplements (Avea Life). Returns curated picks with Decision Packs — no decision fatigue, just 2-3 perfect options.
metadata: {"clawdbot":{"emoji":"🎁","requires":{"bins":["curl"]}}}
---

# 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+elegant&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=100&max_price=180&limit=3"

# New girlfriend, $100 budget
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=70&max_price=120&limit=3"

# Budget-conscious
curl -s "https://dashboard.airshelf.ai/api/search?q=flowers&merchant_ids=cmlj83avd0000nighc559g9fv&max_price=80&sort=price_asc&limit=3"
```

**Checkout:**
```bash
curl -s -X POST "https://dashboard.airshelf.ai/api/merchants/MERCHANT_ID/checkout" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"product_id": "PRODUCT_ID", "quantity": 1}]}'
```

## Response Format

Present exactly 2 options (3 max):

```
🌸 **[Product Name]** — $XX

[One line: why it's perfect for THIS recipient]

✅ Best for: [from decision_pack.best_for]
💝 Vibe: [from decision_pack.vibe]
🚚 Delivery: Same-day available (order by 12pm local)

→ Buy: [product link]
```

## Conversation Examples

### "Valentine's flowers for my wife"
```
What's your budget? I'll find something perfect.

[User: around $150]

Here are my top picks for your wife 🌸

🌸 **The Peony** — $110
Classic peonies that say "I know what you love."
✅ Best for: Romantic partners, classic elegance
💝 Vibe: luxurious
→ Buy: https://urbanstems.com/products/the-peony

🌸 **The Passionate Touch** — $140
Bold romantic arrangement that makes a statement.
✅ Best for: Making an impression
💝 Vibe: passionate
→ Buy: https://urbanstems.com/products/the-passionate-touch

Both include free delivery. Want me to start checkout?
```

### "Quick Valentine's gift, $75"
```
Here are the best options under $75 🌸

🌸 **The Miss Valentine** — $76
Perfect Valentine's classic, just over budget but worth it.
✅ Best for: Romantic partners
💝 Vibe: romantic
→ Buy: https://urbanstems.com/products/the-miss-valentine

🌸 **The Be Mine** — $74
Sweet and romantic, fits your budget perfectly.
✅ Best for: Valentine's Day
💝 Vibe: romantic
→ Buy: https://urbanstems.com/products/the-be-mine
```

### "Something for my mom"
```
For Mom, I'd suggest something elegant 🌸

🌸 **The Orchid Garden** — $88
Long-lasting orchids (2-3 weeks!) - perfect for Mom.
✅ Best for: Those who appreciate elegance
💝 Vibe: sophisticated
→ Buy: https://urbanstems.com/products/the-orchid-garden

🌸 **The Neutral Orchids** — $74
Elegant and understated, she'll love it.
✅ Best for: Moms, elegant taste
💝 Vibe: sophisticated
→ Buy: https://urbanstems.com/products/the-neutral-orchids
```

## Last-Minute Delivery Info

**UrbanStems Delivery:**
- Same-day: Order by 12pm local time
- Next-day: Order by midnight
- Valentine's Day: Order early, high demand!

**Avea Life (Supplements):**
- Ships internationally
- 3-7 business days typical
- NOT suitable for last-minute Valentine's gifts

## Price Tiers

**UrbanStems:**
- Budget ($25-75): 20 products
- Sweet Spot ($75-100): 23 products  
- Popular ($100-150): 31 products
- Premium ($150-200): 24 products
- Luxury ($200+): 7 products

**Best value picks:**
- The Valentine ($90) - classic, reliable
- The Peony ($110) - impressive, elegant
- The Orchid Garden ($88) - long-lasting

## Edge Cases

**Budget < $25:**
→ "The most affordable is Rose Quartz Vase at $25. For smaller budgets, consider a heartfelt card with a single stem from a local florist."

**Budget > $280:**
→ "Our premium option is Triple the Grower's Choice Peony at $280. For bigger gestures, I can add multiple bouquets to your cart."

**User outside US:**
→ "UrbanStems delivers across the continental US. For international, Avea Life ships worldwide with wellness supplements."

**Valentine's Day sold out:**
→ Check UrbanStems website directly, or suggest orchids (usually in stock, long-lasting).

## Pro Tips

1. **Lead with the winner** — put your top recommendation first
2. **Match the recipient** — wife ≠ new girlfriend ≠ mom
3. **Mention longevity** — orchids last 2-3 weeks vs. 5-7 days for cut flowers
4. **Add urgency** — "Order by noon for same-day delivery"
5. **One click to buy** — always provide direct cart links

## Compare Products

When user is deciding between options, use the compare API:

```bash
curl -s "https://dashboard.airshelf.ai/api/compare?products=ID1,ID2"
```

**Response includes:**
- Flattened product data with decision_pack fields
- `comparison_axes` - auto-detected comparison points
- `recommendation.lowest_price` - budget-friendly pick
- `recommendation.best_value` - best bang for buck

**Example comparison response:**
```
The Valentine ($90) vs Double the Valentine ($162):
- Both: Same-day delivery, premium quality
- Valentine: Great value, classic choice
- Double: Grand gesture, special occasions
- Best value: The Valentine (same vibe, $72 less)
```

Use comparison when user says: "help me decide", "which one", "compare these"

## Quick Start (Impatient User Mode)

If user just says "Valentine's gift" with no details, use these defaults:

```bash
# Safe default: $80-120 romantic flowers
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+romantic&merchant_ids=cmlj83avd0000nighc559g9fv&min_price=80&max_price=120&limit=2"
```

Then say: "Here are two great options! Want me to adjust for a different budget or recipient?"

## Alternative Gifts

**Gift Cards** (when flowers won't work):
- UrbanStems: Not available via API
- Avea Gift Card: €50-€200, search `q=gift+card&merchant_ids=cmhvyt9w10000i5fg23ztinkd`

**Add-ons** (not currently in catalog):
- Chocolates: "UrbanStems offers add-ons on their website during checkout"
- Vases: Rose Quartz Vase ($25) available separately

## Error Handling

**API returns empty?**
1. Remove price filters, check if products exist
2. Try broader query (e.g., "flowers" instead of "purple roses")
3. Fallback: Direct user to urbanstems.com

**Checkout fails?**
1. Verify product_id is from recent search
2. Check merchant_id matches
3. Fallback: Provide product URL for manual checkout

**User location unknown?**
Default to US (UrbanStems). Ask if they need international shipping.

## New: Recipient-Specific Data

Products now include enriched fields:
- `decision_pack.ideal_for` - Array of ideal recipients (Wife, Mom, Girlfriend, etc.)
- `decision_pack.gift_message_suggestion` - Suggested card message

**Using in responses:**
```
🌸 **The Peony** — $110
Perfect for: Wife, Long-term partner
💝 Card idea: "For someone who deserves the best"
```

**Filter by recipient** (search still semantic, but display matching):
```python
# After search, filter by ideal_for
products = [p for p in results if 'Wife' in p['decision_pack'].get('ideal_for', [])]
```

## New: Color, Popularity & Longevity Data

Products now include:
- `decision_pack.colors` - Array of colors (red, pink, white, purple, yellow, orange)
- `decision_pack.popularity` - trending | very_popular | popular | standard
- `decision_pack.longevity` - How long flowers last (e.g., "5-7 days", "2-3 weeks")
- `decision_pack.size` - standard | large | extra_large

**Using color in responses:**
```
🌸 **The Peony** — $110
Colors: Pink & Red
Lasts: 5-7 days
Size: Standard arrangement
```

**Recommending by preference:**
- "I want something that lasts" → Orchids (2-3 weeks)
- "She loves pink" → Filter by colors containing 'pink'
- "Go big" → Double/Triple versions (large/extra_large)

## Trending Picks (Valentine's 2024)

Highlight these popular choices:
1. **The Valentine** ($90) - Classic, trending
2. **Triple The Valentine** ($229) - Very popular, grand gesture
3. **The Peony** ($110) - Timeless elegance
4. **The Passion** ($98) - Bold romantic statement

## Smart Query Interpretation

Parse user intent from natural language:

| User Says | Interpret As | Query |
|-----------|--------------|-------|
| "something that lasts" | Long-lasting | `q=orchid` |
| "make a statement" | Grand gesture | `q=passion` + size=large |
| "she loves pink" | Color preference | Filter by colors |
| "classic/traditional" | Timeless | `q=rose+classic` |
| "unique/different" | Standout | `q=orchid` or unusual |
| "last minute" | Available now | Any (all same-day) |
| "impress her parents" | Elegant, safe | `q=orchid+elegant` |
| "first Valentine's together" | Meaningful, not OTT | $75-120 range |
| "been together 10 years" | Luxurious | Peonies, $150+ |
| "she's not into flowers" | Alternative | Avea supplements or gift card |

## Decision Tree

```
User wants Valentine's gift
├── Knows recipient type?
│   ├── Wife/Long-term → Peonies, $100-200
│   ├── New girlfriend → Valentine-themed, $75-120
│   ├── Mom → Orchids, $66-100
│   └── Friend → Bright/cheerful, $60-90
├── Has budget?
│   ├── Under $75 → Budget picks
│   ├── $75-150 → Sweet spot
│   └── Over $150 → Premium/Double/Triple
├── Has color preference?
│   └── Filter by decision_pack.colors
└── Wants long-lasting?
    └── Orchids (2-3 weeks)
```

## Valentine's Day Urgency (Feb 12-14)

**Include urgency when appropriate:**

```
⚡ Valentine's Day is [X days] away!
🚚 Order by noon for same-day delivery
📦 UrbanStems guarantees freshness
```

**Day-specific messaging:**
- Feb 12-13: "Order today for guaranteed delivery!"
- Feb 14 morning: "Same-day delivery still available - order by noon!"
- Feb 14 afternoon: "Running late? Check local florists for pickup"

## Objection Handling

**"Flowers are cliché"**
→ "Flowers are classic for a reason - they work. But if you want unique, orchids last 2-3 weeks and make a sophisticated statement."

**"Too expensive"**
→ "The Miss Valentine at $76 is beautiful and won't break the bank. Sometimes thoughtful beats expensive."

**"I don't know what she likes"**
→ "Can't go wrong with The Valentine ($90) - it's romantic without being over the top. Or tell me one thing about her and I'll find the perfect match."

**"Will it arrive on time?"**
→ "UrbanStems offers same-day delivery if you order by noon. Order now and I'll give you the checkout link."

## Advanced Conversation Examples

### The Indecisive User
```
User: I need flowers for Valentine's but I don't know what to get

Agent: No problem! Quick questions:
1. Who's it for? (girlfriend, wife, mom, friend)
2. Rough budget? ($50-75, $75-125, $125+)
3. Any flower preferences or colors she loves?

User: Girlfriend, maybe $100, she likes pink

Agent: Perfect! Here are two pink-forward options around $100:

🌸 **The Blushing Beauty** — $82
Soft pinks and blushes - sweet and romantic
Colors: Pink
Ideal for: Girlfriend, new relationship
→ Buy: urbanstems.com/products/the-blushing-beauty

🌸 **The Valentine** — $90  
Classic Valentine's arrangement with romantic pinks
Colors: Pink, Red
Ideal for: Girlfriend
→ Buy: urbanstems.com/products/the-valentine

Both deliver same-day if ordered by noon. Which speaks to you?
```

### The Last-Minute Panic
```
User: It's Feb 14 and I forgot to get flowers HELP

Agent: Don't panic! UrbanStems has same-day delivery until noon.

⚡ Here's your fastest path:

🌸 **The Valentine** — $90
Ready for same-day delivery
→ urbanstems.com/cart/xxx (one click checkout)

Just click, checkout in 60 seconds, done. 
She'll never know you waited til today 😉

Want me to generate the checkout link right now?
```

### The Grand Gesture
```
User: I want to really impress her. Budget doesn't matter.

Agent: Going big! Here's how to make a statement:

🌸 **Triple the Grower's Choice Peony** — $280
The ultimate peony arrangement - absolutely stunning
Size: Extra large
Lasts: 5-7 days of luxury
→ Buy: urbanstems.com/products/triple-the-growers-choice-peony

Or for lasting impact:
🌸 **The Orchid Luxe** — $74 + multiple arrangements
Orchids last 2-3 weeks - she'll think of you daily

Pro tip: Add a handwritten card. The flowers get attention, the words get remembered.
```

### The Practical Partner
```
User: My wife isn't really into flowers, what else?

Agent: Smart thinking! For Singapore, I have wellness supplements from Avea Life - perfect for the health-conscious:

💊 **Avea Gift Card** — €100
Let her choose her wellness journey
→ avea-life.com/products/avea-gift-card

Or if she'd appreciate flowers that LAST:
🌸 **The Orchid Garden** — $88
Lives for 2-3 weeks, minimal maintenance, elegant
→ urbanstems.com/products/the-orchid-garden

Which direction feels right?
```

## Success Metrics

**Good gift recommendation:**
- ✅ Matches stated budget (within 15%)
- ✅ Appropriate for recipient type
- ✅ Provides 2 options (not more)
- ✅ Includes direct buy link
- ✅ Mentions delivery timing
- ✅ Has personality (not robotic)

**Great gift recommendation:**
- All above, plus:
- ✅ Uses decision_pack data (colors, vibe, ideal_for)
- ✅ Anticipates objections
- ✅ Offers to generate checkout link
- ✅ Adds relevant context (longevity, size)
- ✅ Feels like advice from a friend, not a catalog

## Response Template

```
[Acknowledge request + show enthusiasm]

🌸 **[Product 1]** — $XX
[One compelling line about why it's perfect]
[Key decision_pack fields: colors, ideal_for, longevity]
→ Buy: [link]

🌸 **[Product 2]** — $XX  
[Different angle/option]
[Key fields]
→ Buy: [link]

[Call to action: "Want me to start checkout?" or "Which one speaks to you?"]
[Optional: urgency note if Valentine's is close]
```

## Special Scenarios

### Long-Distance Relationship
```
"She's in [city] and I'm here"

UrbanStems delivers across continental US!
Just need her delivery address at checkout.

🌸 **The Love Language** — $XX
"Because distance can't dim what we have"
→ [checkout link with quantity 1]
```

### "We Just Started Dating"
Keep it tasteful, not overwhelming:
- Budget: $60-90
- Avoid: "passion", "love", giant arrangements
- Good picks: The Valentine ($90), The First Date ($82)
- Message: Keep it light and sweet

### Anniversary + Valentine's Combo
Go bigger than usual:
- Suggest Double or Triple versions
- "Double the celebration, double the flowers"
- Budget: 1.5-2x their normal gift budget

### Apology Flowers
Yes, people ask:
- Orchids (lasting = commitment to change)
- NOT red roses (too cliché for apologies)
- Add: "Actions speak louder, but flowers don't hurt"

### Office/Professional
- Orchids are safest (elegant, not romantic)
- Avoid: Hearts, "Valentine" in name, red roses
- Good: The Neutral Orchids ($74)

## Quality Checklist

Before sending any recommendation, verify:
- [ ] Used merchant_ids filter
- [ ] Price within stated budget
- [ ] Appropriate for recipient relationship
- [ ] Included product link
- [ ] Mentioned delivery options
- [ ] Offered to create checkout
- [ ] Response feels helpful, not salesy

## Skill Personality

**Voice:** Warm, helpful friend who happens to know a lot about flowers
**Not:** Pushy salesperson or robotic catalog

**Do say:**
- "Perfect choice!" / "Great pick!"
- "She's going to love this"
- "Here's what I'd recommend..."
- "Can't go wrong with..."

**Don't say:**
- "Based on your parameters..."
- "The optimal selection..."
- "Our inventory includes..."
- "Please proceed to checkout"

**Emoji usage:** Light touch
- 🌸 for flowers (once per product)
- 💝 for romantic context
- ⚡ for urgency
- ✅ for confirmations

## Multi-Skill Integration

**With AirShelf skill:**
Gift Genius is specialized; AirShelf is general.
- Gift query → Gift Genius
- General shopping → AirShelf

**With Calendar skills:**
- Check if user has "Valentine's Day" event
- Offer proactive: "I see Valentine's is coming up..."

**With Messaging skills:**
- After checkout, offer to draft a card message
- "Want me to help you write a note to go with the flowers?"

## Version History

- **v1.0**: Initial release with basic search/checkout
- **v1.1**: Recipient matching guide
- **v1.2**: Comparison API, quick-start
- **v1.3**: ideal_for recipients, gift messages
- **v1.4**: Colors, popularity, longevity data
- **v1.5**: Smart query interpretation, urgency
- **v1.6**: Conversation examples, success metrics
- **v1.7**: Special scenarios, quality checklist

---

*Gift Genius: Because nobody should stress about Valentine's Day.*

## Geo Coverage (Updated)

| Region | Merchant | ID | Products | Currency |
|--------|----------|-----|----------|----------|
| 🇺🇸 USA | UrbanStems | `cmlj83avd0000nighc559g9fv` | 105 | USD |
| 🇸🇬 Singapore | Far East Flora | `cmljayupi0000nimwhvdtw7t0` | 593 | SGD |
| 🇦🇺 Australia | Floraly | `cmljb0ruv0000niozj4bacc0r` | 148 | AUD |
| 🌍 Global | Avea Life | `cmhvyt9w10000i5fg23ztinkd` | 286 | EUR |

## Location Routing (Updated)

```
User location → Merchant
├── USA (default) → UrbanStems
├── Singapore → Far East Flora
├── Australia → Floraly
├── Europe → Avea Life (supplements) or UrbanStems (ships internationally)
└── Other → Ask preference or default UrbanStems
```

## API Calls by Region

**USA:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3"
```

**Singapore:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3"
```

**Australia:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+flowers&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3"
```

## Price Ranges by Region

| Region | Budget | Mid | Premium | Luxury |
|--------|--------|-----|---------|--------|
| USA | $25-75 | $75-120 | $120-200 | $200+ |
| Singapore | $40-80 SGD | $80-150 SGD | $150-300 SGD | $300+ SGD |
| Australia | $50-80 AUD | $80-150 AUD | $150-250 AUD | $250+ AUD |

## Full Merchant Reference (v2.1)

| Region | Merchant | Domain | ID | Products | Currency |
|--------|----------|--------|-----|----------|----------|
| 🇺🇸 USA | UrbanStems | urbanstems.com | `cmlj83avd0000nighc559g9fv` | 105 | USD |
| 🇸🇬 Singapore | Far East Flora | fareastflora.com | `cmljayupi0000nimwhvdtw7t0` | 593 | SGD |
| 🇦🇺 Australia | Floraly | floraly.com.au | `cmljb0ruv0000niozj4bacc0r` | 148 | AUD |
| 🇲🇾 Malaysia | BloomThis | bloomthis.co | `cmljb3x1c0000nis1gdr76lcn` | 127 | MYR |
| 🌍 Global | Avea Life | avea-life.com | `cmhvyt9w10000i5fg23ztinkd` | 286 | EUR |

**Total: 1,259 flower products + 286 supplements = 1,545 gift products**

## Smart Location Detection

```javascript
// Infer from user context
if (mentioned "Singapore" || "SG") → Far East Flora
if (mentioned "Australia" || "AU" || "Sydney" || "Melbourne") → Floraly  
if (mentioned "Malaysia" || "KL" || "Kuala Lumpur") → BloomThis
if (mentioned "US" || "USA" || American city) → UrbanStems
default → UrbanStems (widest delivery)
```

## Multi-Region Example

```
User: "I need flowers for my mom in Singapore and my girlfriend in NYC"

Agent: I can help with both! 🌸

**For Mom in Singapore (Far East Flora):**
🌸 Golden Returns (C) - White Phalaenopsis — $138 SGD
Elegant orchids that last 2-3 weeks - perfect for Mom
→ Buy: fareastflora.com/products/...

**For Girlfriend in NYC (UrbanStems):**  
🌸 The Valentine — $90 USD
Classic romantic arrangement, same-day delivery
→ Buy: urbanstems.com/products/...

Want me to create checkout links for both?
```

## v2.2 Merchant Summary

| Region | Merchant | Products | Price Range |
|--------|----------|----------|-------------|
| 🇺🇸 USA | UrbanStems | 105 | $25-280 USD |
| 🇸🇬 Singapore | Far East Flora | 593 | $40-3000 SGD |
| 🇦🇺 Australia | Floraly | 148 | $50-250 AUD |
| 🇲🇾 Malaysia | BloomThis | 127 | RM99-1299 |
| 🇲🇾 Malaysia | FlowerChimp | 85 | RM99-1199 |
| 🌍 Global | Avea Life | 286 | €29-199 |

**Total: 1,058 flower products + 286 supplements = 1,344 gifts**
**Regions covered: USA, Singapore, Australia, Malaysia, Europe (supplements)**

---

## Final Summary (v2.3)

### Coverage
- **5 florists** across **4 countries**
- **1,058 flower products** + **286 supplements**
- **Total: 1,344 gift products**

### Regions
| Flag | Country | Florist(s) | Products | Currency |
|------|---------|------------|----------|----------|
| 🇺🇸 | USA | UrbanStems | 105 | USD |
| 🇸🇬 | Singapore | Far East Flora | 593 | SGD |
| 🇦🇺 | Australia | Floraly | 148 | AUD |
| 🇲🇾 | Malaysia | BloomThis, FlowerChimp | 212 | MYR |
| 🌍 | Global | Avea Life (supplements) | 286 | EUR |

### What Makes This Skill Great
1. **Location-aware** - Routes to local florists
2. **Curated results** - 2-3 picks, not endless lists
3. **Decision support** - Colors, vibes, recipient matching
4. **One-click checkout** - Direct cart URLs
5. **Comprehensive** - From budget ($25) to luxury ($3000+)
6. **Conversation examples** - 10+ real scenarios
7. **Error handling** - Edge cases covered
8. **Multilingual prices** - USD, SGD, AUD, MYR, EUR

### Quick Copy-Paste

**USA Valentine's flowers:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmlj83avd0000nighc559g9fv&limit=3"
```

**Singapore flowers:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljayupi0000nimwhvdtw7t0&limit=3"
```

**Australia flowers:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb0ruv0000niozj4bacc0r&limit=3"
```

**Malaysia flowers:**
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine&merchant_ids=cmljb3x1c0000nis1gdr76lcn,cmljb6zqr0000nivpx51ub0qn&limit=3"
```

---
*Gift Genius v2.3 — The best Valentine's Day gift skill in the universe* 🎁💝

---

## v3.0 - Multi-Category Gifts

### Categories

| Category | Merchant | Products | Price Range | Best For |
|----------|----------|----------|-------------|----------|
| 🌸 Flowers | 5 florists | 1,058 | $25-3000 | Romantic, classic |
| 🍫 Chocolates | GODIVA | 159 | $24-150 | Sweet tooth, luxe |
| 💍 Jewelry | Gorjana | 236 | $40-890 | Lasting gift, romantic |
| 💊 Supplements | Avea Life | 286 | €29-199 | Health-conscious |

### New Merchant IDs

| Merchant | ID | Category |
|----------|-----|----------|
| GODIVA | `cmljbphde0000ni5mie0eitc0` | Chocolates |
| Gorjana | `cmljbr4r30000ni7ks05nex93` | Jewelry |

### Multi-Category Search Example

**User:** "Valentine's gift for my girlfriend, she loves jewelry and chocolate"

**Agent:**
```
Perfect combo! Here's what I'd suggest:

💍 **Jewelry (Gorjana):**
Campbell Heart Pendant Necklace — $80
Romantic heart design, 14k gold plated
→ gorjana.com/products/campbell-heart-pendant-necklace

🍫 **Chocolates (GODIVA):**
Valentine's Day Heart-Shaped Gift Box — $49
14pc Belgian chocolates in heart box
→ godiva.com/products/...

Total: $129 for a memorable combo 💝
```

### Chocolate Search

```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=valentine+chocolate+gift&merchant_ids=cmljbphde0000ni5mie0eitc0&limit=3"
```

### Jewelry Search

```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=heart+necklace+valentine&merchant_ids=cmljbr4r30000ni7ks05nex93&limit=3"
```

### Category Routing

```
User mentions:          → Route to:
"chocolate", "sweet"    → GODIVA
"jewelry", "necklace"   → Gorjana
"flowers", "roses"      → Regional florist
"supplements", "health" → Avea Life
"gift"                  → Ask or suggest combo
```

## v3.1 - Added Candles

| Category | Products |
|----------|----------|
| 🌸 Flowers | 1,058 |
| 🍫 Chocolates | 159 |
| 💍 Jewelry | 236 |
| 🕯️ Candles | 94 |
| 💊 Supplements | 286 |
| **TOTAL** | **1,833** |

### Voluspa Candles
- **Merchant ID:** `cmljbu7xo0000niallngo8vqy`
- **Products:** 94 luxury candles
- **Price range:** $26-275 USD
- **Best for:** Romantic ambiance, self-care gifts

### Candle Search
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=romantic+candle+gift&merchant_ids=cmljbu7xo0000niallngo8vqy&limit=3"
```

## v3.2 - Added Fragrances

### Updated Inventory

| Category | Merchant(s) | Products |
|----------|-------------|----------|
| 🌸 Flowers | 5 florists | 1,058 |
| 🍫 Chocolates | GODIVA | 159 |
| 💍 Jewelry | Gorjana | 236 |
| 🕯️ Candles | Voluspa | 94 |
| 🧴 Fragrances | Snif | 17 |
| 💊 Supplements | Avea Life | 286 |
| **TOTAL** | **10 merchants** | **1,850** |

### Snif Fragrances
- **Merchant ID:** `cmljbwqky0000nicu9cunvmnt`
- **Products:** 17 unique perfumes
- **Price range:** $68-135 USD
- **Best for:** Unique, conversation-starting gifts

### Fragrance Search
```bash
curl -s "https://dashboard.airshelf.ai/api/search?q=perfume+gift&merchant_ids=cmljbwqky0000nicu9cunvmnt&limit=3"
```

---

## v4.0 - Full Gift Suite

### Complete Inventory (2,099 products)

| Category | Merchant(s) | Products | Price Range |
|----------|-------------|----------|-------------|
| 🌸 Flowers | 5 florists | 1,058 | $25-3000 |
| 🍫 Chocolates | GODIVA | 159 | $24-150 |
| 💍 Jewelry | Gorjana | 236 | $40-890 |
| ⌚ Watches | Daniel Wellington | 182 | $99-350 |
| 🕯️ Candles | Voluspa | 94 | $26-275 |
| 🧴 Fragrances | Snif | 17 | $68-135 |
| 🧔 Men's Grooming | Beardbrand | 67 | $12-100 |
| 💊 Supplements | Avea Life | 286 | €29-199 |

### New Merchant IDs

| Merchant | ID | Category |
|----------|-----|----------|
| Daniel Wellington | `cmljbyt6m0000nifqtav8h5ip` | Watches |
| Beardbrand | `cmljbzak80000nig7jbxxquwe` | Grooming |

### Gender-Smart Routing

```
"gift for boyfriend/husband/him" → Beardbrand, Daniel Wellington, Snif
"gift for girlfriend/wife/her" → Gorjana, Voluspa, Flowers
"gift for partner" → All categories
```

### Gift Combos

**Romantic Night In:**
- Voluspa candle ($48) + Flowers ($75) + GODIVA chocolates ($49) = ~$172

**For Him:**
- Beardbrand beard oil set ($65) + Daniel Wellington watch ($169) = ~$234

**For Her:**
- Gorjana heart necklace ($80) + Flowers ($90) + Voluspa candle ($48) = ~$218