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	INLINECODE1	105 flowers ($25-$280)
Singapore

Avea Life | cmhvyt9w10000i5fg23ztinkd | 286 supplements (€29-€199) |

Quick Reference: Flower Types

Type	Query	Price Range	Best For
Peonies	INLINECODE3	$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 INLINECODE8
• Budget: $100-200 (shows you put thought in)
• Picks: The Peony ($110), The Passion ($98), The Classic Affair ($115)

For New Girlfriend:

• - Query: INLINECODE9
• 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 INLINECODE11
• Budget: $66-100
• Picks: The Orchid Garden ($88), The Neutral Orchids ($74)

For Friend:

• - Query: bright+cheerful or INLINECODE13
• Budget: $60-90
• Picks: The Unicorn ($72), The Flounce ($82)

API Calls

Basic search:
CODEBLOCK0

Examples:
CODEBLOCK1

Checkout:
CODEBLOCK2

Response Format

Present exactly 2 options (3 max):

CODEBLOCK3

Conversation Examples

"Valentine's flowers for my wife"

CODEBLOCK4

"Quick Valentine's gift, $75"

CODEBLOCK5

"Something for my mom"

CODEBLOCK6

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. 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:

CODEBLOCK7

Response includes:

• - Flattened product data with decision_pack fields
• INLINECODE14 - auto-detected comparison points
• INLINECODE15 - budget-friendly pick
• INLINECODE16 - best bang for buck

Example comparison response:
CODEBLOCK8

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:

CODEBLOCK9

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 INLINECODE17

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. 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. 1. Verify productid is from recent search
2. Check merchantid 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.)
• INLINECODE19 - Suggested card message

Using in responses:
CODEBLOCK10

Filter by recipient (search still semantic, but display matching):
CODEBLOCK11

New: Color, Popularity & Longevity Data

Products now include:

• - decision_pack.colors - Array of colors (red, pink, white, purple, yellow, orange)
• INLINECODE21 - trending | verypopular | popular | standard
• INLINECODE22 - How long flowers last (e.g., "5-7 days", "2-3 weeks")
• INLINECODE23 - standard | large | extralarge

Using color in responses:
CODEBLOCK12

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. 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	INLINECODE24
"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

CODEBLOCK13

Valentine's Day Urgency (Feb 12-14)

Include urgency when appropriate:

CODEBLOCK14

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

CODEBLOCK15

The Last-Minute Panic

CODEBLOCK16

The Grand Gesture

CODEBLOCK17

The Practical Partner

CODEBLOCK18

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 decisionpack data (colors, vibe, idealfor)
• ✅ Anticipates objections
• ✅ Offers to generate checkout link
• ✅ Adds relevant context (longevity, size)
• ✅ Feels like advice from a friend, not a catalog

Response Template

CODEBLOCK19

Special Scenarios

Long-Distance Relationship

CODEBLOCK20

"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	INLINECODE29	105	USD
🇸🇬 Singapore

Far East Flora | cmljayupi0000nimwhvdtw7t0 | 593 | SGD | | 🇦🇺 Australia | Floraly | cmljb0ruv0000niozj4bacc0r | 148 | AUD | | 🌍 Global | Avea Life | cmhvyt9w10000i5fg23ztinkd | 286 | EUR |

Location Routing (Updated)

CODEBLOCK21

API Calls by Region

USA:
CODEBLOCK22

Singapore:
CODEBLOCK23

Australia:
CODEBLOCK24

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	INLINECODE33	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

CODEBLOCK25

Multi-Region Example

CODEBLOCK26

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. 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:
CODEBLOCK27

Singapore flowers:
CODEBLOCK28

Australia flowers:
CODEBLOCK29

Malaysia flowers:

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	INLINECODE38	Chocolates
Gorjana

cmljbr4r30000ni7ks05nex93 | Jewelry |

Multi-Category Search Example

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

Agent:
CODEBLOCK31

Chocolate Search

CODEBLOCK32

Jewelry Search

CODEBLOCK33

Category Routing

CODEBLOCK34

v3.1 - Added Candles

Category	Products
🌸 Flowers	1,058
🍫 Chocolates

159 | | 💍 Jewelry | 236 | | 🕯️ Candles | 94 | | 💊 Supplements | 286 | | TOTAL | 1,833 |

Voluspa Candles

• - Merchant ID: INLINECODE40
• Products: 94 luxury candles
• Price range: $26-275 USD
• Best for: Romantic ambiance, self-care gifts

Candle Search

CODEBLOCK35

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: INLINECODE41
• Products: 17 unique perfumes
• Price range: $68-135 USD
• Best for: Unique, conversation-starting gifts

Fragrance Search

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	INLINECODE42	Watches
Beardbrand

cmljbzak80000nig7jbxxquwe | Grooming |

Gender-Smart Routing

CODEBLOCK37

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