Skill: evoleinik/gift-genius (version 4.0.0)

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


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (CRITICAL)