{"skill":{"slug":"freshippo","displayName":"Freshippo","summary":"Shop Freshippo (盒马鲜生) with browser automation for search, fresh produce selection, cart operations, and smart grocery guidance. Supports logged-in workflows...","description":"---\nname: freshippo\nversion: 2.0.0\ndescription: \"Shop Freshippo (盒马鲜生) with browser automation for search, fresh produce selection, cart operations, and smart grocery guidance. Supports logged-in workflows for browsing, adding to cart, and order preview while keeping checkout/payment for user control. Use when the user wants help shopping on 盒马鲜生, choosing fresh groceries, planning family meals, or optimizing delivery slots.\"\nmetadata:\n  clawdbot:\n    emoji: \"🦛\"\n    requires:\n      bins: []\n    os: [\"linux\", \"darwin\", \"win32\"]\n---\n\n# Freshippo (盒马鲜生)\n\n## Overview\n\nUse this skill to help users shop smartly on Freshippo (盒马鲜生), Alibaba's premium fresh grocery platform. Get guidance on fresh produce selection, delivery timing, membership benefits, and weekly meal planning.\n\n## Capabilities\n\n### v2.0 - Browser Automation Support\n\n| Operation | Auth Required | Description |\n|-----------|---------------|-------------|\n| **Search** | Optional | Search products, filter by category/freshness |\n| **Product Detail** | Optional | View specs, prices, freshness indicators |\n| **Fresh Produce Guide** | Optional | Read selection tips, origin info, reviews |\n| **Price Compare** | Optional | Compare prices across categories |\n| **Add to Cart** | ✅ Required | Add items to shopping cart |\n| **View Cart** | ✅ Required | Review cart contents, quantities |\n| **Apply Coupons** | ✅ Required | Check and apply X会员 discounts |\n| **Delivery Slot Check** | ✅ Required | View available 30-min delivery slots |\n| **Generate Order Preview** | ✅ Required | Calculate total with delivery fee |\n| **Payment** | ❌ Blocked | User must complete payment manually |\n\n**Safety Rule**: Agent stops before payment. User retains full control over final purchase.\n\n### Legacy: Guidance-Only Mode (No Browser)\n\n- Shopping strategy and selection tips\n- Delivery timing advice\n- X会员 membership guidance\n- Weekly meal planning\n- Shopping list templates\n\n## Workflow\n\n### Phase 1: Discovery (Agent-Assisted)\n1. **Search** - Agent searches Freshippo for target products\n2. **Filter & Sort** - Apply filters (category, freshness, origin)\n3. **Compare** - Agent compares top options across categories\n4. **Freshness Check** - Agent reads harvest dates, origin info, traceability codes\n5. **Price Analysis** - Agent checks current price, X会员 discounts\n\n### Phase 2: Selection (Agent-Assisted)\n1. **Product Detail** - Agent opens selected product page\n2. **Fresh Produce Tips** - Show selection indicators (日日鲜, 产地直采, 鲜活)\n3. **Quantity Selection** - Confirm amount, weight\n4. **Final Price Check** - Calculate price with X会员 discount if applicable\n\n### Phase 3: Cart & Pre-Order (Agent-Assisted with Login)\n1. **Add to Cart** - Agent adds item to cart (requires login)\n2. **Cart Review** - Agent shows cart contents, quantities, subtotal\n3. **Coupon Application** - Agent checks X会员 benefits and coupons\n4. **Delivery Slot** - Agent checks available 30-min delivery slots\n5. **Address Selection** - Agent confirms delivery address\n6. **Order Summary** - Agent generates complete order preview\n\n### Phase 4: Checkout (User-Controlled)\n1. **Handoff** - Agent presents final order details\n2. **User Review** - User confirms all details are correct\n3. **Payment** - ⚠️ **User completes payment manually**\n4. **Confirmation** - User shares order confirmation with agent if desired\n\n**Agent Boundary**: Stops at Phase 3. Never executes payment or final order submission.\n\n### Legacy: Guidance-Only Mode (No Browser)\n\n1. Determine the user's goal:\n   - browse categories and get product recommendations\n   - plan weekly meals and build shopping lists\n   - understand delivery slots and timing strategies\n   - learn about X会员 membership benefits\n   - get fresh produce selection tips\n2. Ask for only the missing essentials\n3. Give the most practical answer first\n4. Provide cautious estimates if exact data unavailable\n\n## Quick Reference\n\n| Topic | Description |\n|-------|-------------|\n| Fresh Produce | 生鲜蔬果选购指南 |\n| Delivery Slots | 配送时段优化建议 |\n| X会员 Benefits | 盒马X会员权益详解 |\n| Weekly Planning | 一周买菜规划 |\n| Shopping Lists | 购物清单管理 |\n| Browser Automation | 搜索/加购/订单预览 |\n\n## Agent Execution Guide\n\n### When User Says \"帮我买...\" / \"帮我下单...\"\n\n```\nUser: \"帮我买盒马的三文鱼\"\n  ↓\nStep 1: Confirm Intent\n  \"我来帮你搜索盒马的三文鱼，对比选项，加入购物车。\n   最后需要你确认订单并完成支付。可以吗？\"\n  ↓\nStep 2: Discovery Phase (No login required)\n  - Search Freshippo for \"三文鱼\"\n  - Filter: 鲜活, 产地, 价格区间\n  - Compare top 3 options\n  - Check freshness indicators (溯源码, 产地直采)\n  - Present comparison table\n  ↓\nStep 3: Selection Phase (No login required)\n  - User picks one option\n  - Agent opens product page\n  - Confirm quantity/weight\n  - Show final price (X会员价 if applicable)\n  ↓\nStep 4: Cart Phase (⚠️ Requires login)\n  \"接下来需要登录你的盒马账号才能加入购物车，\n   请确认是否继续？\"\n  - If yes: proceed with browser automation\n  - If no: provide manual instructions\n  ↓\nStep 5: Order Generation (Requires login)\n  - Add to cart\n  - Check X会员 discounts\n  - Select delivery slot (30-min window)\n  - Calculate final price (delivery fee if applicable)\n  - Generate order preview\n  ↓\nStep 6: Handoff (User-controlled)\n  \"订单已准备好，请检查：\n   [订单详情摘要]\n   \n   👉 请手动完成支付：\n   1. 打开盒马 App\n   2. 进入购物车\n   3. 点击结算\n   4. 确认地址和配送时段\n   5. 提交订单并支付\"\n```\n\n### Browser Automation Rules\n\n**Always announce before action:**\n- \"正在搜索...\"\n- \"正在打开商品页面...\"\n- \"正在检查新鲜度信息...\"\n- \"正在加入购物车...\"\n\n**Snapshot key information:**\n- Product name, price, X会员 price\n- Freshness indicators (日日鲜, 产地直采, 鲜活)\n- Origin/traceability info\n- Harvest/pack dates\n- Available delivery slots\n- Cart subtotal and delivery fee\n\n**Stop conditions:**\n- Before any payment screen\n- When CAPTCHA appears (hand to user)\n- When login is required (ask first)\n- When price differs significantly from expected\n\n### Login Handling\n\n**Option A: User already logged in (Chrome profile)**\n```\nbrowser navigates to Freshippo\nIf user profile has active session → proceed\nIf session expired → prompt user to login manually first\n```\n\n**Option B: Manual mode (no login)**\n```\nAgent provides:\n- Exact search keywords\n- Product recommendations\n- Freshness selection tips\n- Step-by-step manual instructions\nUser executes manually\n```\n\n## Core Rules\n\n### 1. Delivery Slot Timing\n\nFreshippo operates on **30-minute delivery slots** (30分钟送达):\n\n| Time Slot | Best For | Notes |\n|-----------|----------|-------|\n| 8:00 - 10:00 AM | Fresh produce, bakery | Best selection, morning delivery |\n| 10:00 - 12:00 PM | Daily essentials | Good availability |\n| 14:00 - 16:00 PM | Afternoon shopping | Moderate availability |\n| 16:00 - 18:00 PM | Dinner prep | High demand, book early |\n| 18:00 - 22:00 PM | Evening restock | Limited fresh selection |\n\n**Strategy:**\n- Book 8-10 AM slots for freshest produce\n- Peak dinner prep slots (17:00-19:00) fill up fast\n- Same-day delivery available if ordered before 21:00\n- Rainy days may have delayed slots\n\n### 2. Fresh Produce Selection\n\nFreshippo's strength is **fresh food and quality groceries**:\n\n| Category | Best Time to Buy | Quality Indicators |\n|----------|------------------|-------------------|\n| Vegetables | Morning 8-10 AM | Harvest date, origin label |\n| Fruits | Morning 8-10 AM | Ripeness indicator, origin |\n| Meat | Morning 8-10 AM | Slaughter date, grade |\n| Seafood | Morning 8-10 AM | Catch/delivery date, live tanks |\n| Bakery | Morning 8-10 AM | Bake time stamp |\n| Dairy | Any time | Expiration dates |\n\n**Pro Tips:**\n- 盒马日日鲜 (Daily Fresh) = same-day packaged, best quality\n- 产地直采 (Direct sourcing) = fresher, traceable\n- 鲜活 (Live) seafood = premium quality, cook same day\n- Check 溯源码 (traceability code) for origin info\n\n### 3. X会员 Membership Benefits\n\n**Membership Tiers:**\n\n| Tier | Annual Fee | Key Benefits |\n|------|------------|--------------|\n| Regular | Free | Basic shopping, standard delivery |\n| X会员 | ¥258/year | Free delivery, member prices, daily deals |\n| X会员·黄金 | ¥658/year | All above + premium services |\n\n**Member-Exclusive Features:**\n- 免费配送 (Free delivery): No minimum order for X会员\n- 会员价 (Member prices): 5-15% off regular prices\n- 会员日 (Member day): Tuesday extra discounts\n- 专享商品 (Member-only products): Premium selections\n- 优先配送 (Priority delivery): Peak slots reserved\n\n**Break-Even Analysis:**\n- Shop >¥300/month → membership pays for itself\n- Frequent fresh grocery buyers → highly recommended\n- Free delivery saves ¥6-15 per order\n\n### 4. Category Highlights\n\n**盒马特色 (Freshippo Specialties):**\n\n| Category | Highlights | Tips |\n|----------|------------|------|\n| 盒马工坊 | Ready-to-cook meals | Fresh, restaurant-quality |\n| 海鲜水产 | Live seafood tanks | Cook in-store or home delivery |\n| 日日鲜 | Daily fresh produce | Same-day packaging |\n| 烘焙 | In-store bakery | Fresh daily, limited quantities |\n| 进口食品 | International imports | Premium selection |\n| 有机蔬菜 | Organic produce | Certified, higher price |\n\n### 5. Smart Shopping Strategies\n\n**Timing Strategies:**\n1. **Morning Shopping (8-10 AM):** Best selection of fresh items\n2. **Tuesday Member Day:** Extra discounts for X会员\n3. **Evening Clearance (after 20:00):** Discounted bakery and ready meals\n4. **Weekend Prep:** Plan ahead for busy slots\n\n**Category Bundling:**\n- Fresh + Pantry = Free delivery threshold easier to reach\n- Ready meals + Fresh = Complete dinner solution\n- Bulk buying on staples = Lower unit cost\n\n**Payment Optimization:**\n- 盒马钱包: Occasional extra discounts\n- Alipay: Seamless integration\n- Credit card partnerships: Check for cashback\n- First-order: Usually has welcome discount\n\n### 6. Delivery & Pickup\n\n| Aspect | Details |\n|--------|---------|\n| Standard Delivery | 30-minute slots, 8:00 AM - 22:00 PM |\n| Delivery Radius | ~3-5km from store |\n| Free Shipping Threshold | ¥39 for non-members, free for X会员 |\n| In-Store Shopping | Live seafood cooking, fresh bakery |\n| Self-Pickup | Available at some locations |\n\n**Delivery Optimization:**\n- Choose morning slots for freshest produce\n- Evening slots have limited fresh selection\n- Combine orders to hit free shipping threshold\n- Cold chain items delivered in insulated packaging\n\n### 7. Weekly Meal Planning\n\n**Family Shopping Guide:**\n\n| Day | Focus | Suggested Items |\n|-----|-------|-----------------|\n| Monday | Fresh start | Vegetables, fruits, dairy |\n| Tuesday | Member Day deals | Stock up on staples |\n| Wednesday | Mid-week refresh | Meat, seafood |\n| Thursday | Prep for weekend | Party foods, snacks |\n| Friday | Weekend treats | Premium items, bakery |\n| Saturday | Family cooking | Bulk fresh produce |\n| Sunday | Meal prep | Ready meals, leftovers |\n\n**Weekly Budget Guide:**\n- Small family (2-3 people): ¥300-500/week\n- Medium family (4-5 people): ¥500-800/week\n- Large family (6+ people): ¥800-1200/week\n\n## Common Traps\n\n- **Overbuying perishables** → Fresh items have limited shelf life\n- **Missing delivery slots** → Peak times fill up quickly\n- **Ignoring member benefits** → Non-members pay delivery fees\n- **Flash sale FOMO** → Compare with regular prices\n- **Not checking expiration** → Especially on dairy and ready meals\n- **Ordering during rush hour** → Limited slot availability\n\n## Freshippo-Specific Features to Leverage\n\n### 1. 盒马工坊 (Freshippo Kitchen)\n- Ready-to-cook meals\n- Restaurant-quality ingredients prepped\n- Great for busy weeknights\n\n### 2. 鲜活海鲜 (Live Seafood)\n- Live tanks in store\n- Cook in-store or take home\n- Premium quality guarantee\n\n### 3. 日日鲜 (Daily Fresh)\n- Same-day packaged produce\n- Clear harvest/pack dates\n- Best quality indicator\n\n### 4. 会员日 (Member Day)\n- Tuesday exclusive deals\n- Extra discounts for X 会员\n- Limited-time promotions\n\n### 5. 盒马村 (Freshippo Village)\n- Direct farm sourcing\n- Traceable origin products\n- Seasonal specialties\n\n## Quality Bar\n\n### Do:\n- ✅ Focus on fresh produce guidance\n- ✅ Explain delivery timing strategies\n- ✅ Use browser automation for search/cart\n- ✅ Add to cart and check X会员 benefits (with user consent)\n- ✅ Generate order preview with delivery slot selection\n- ✅ Stay honest about not doing payment operations\n\n### Do Not:\n- ❌ Pretend to log in (ask first)\n- ❌ Claim to confirm live inventory without checking\n- ❌ Store user data persistently\n- ❌ **Execute payment or final order submission**\n- ❌ Guarantee freshness without evidence\n\n## Related Skills\n\nInstall with `clawhub install <slug>` if user confirms:\n- `home-food-planner` — family meal planning and nutrition\n- `yhd` — YHD.com grocery shopping\n- `jd-shopping` — JD.com shopping with automation\n- `jingdong` — Alternative JD shopping guide\n\n## Feedback\n\n- If useful: `clawhub star freshippo`\n- Stay updated: `clawhub sync`\n\n---\n\n## 🚀 First-Success Path\n\n**30秒快速上手：三步完成盒马购物**\n\n1. **告诉我你想买什么** — 如\"帮我看看盒马有什么好的三文鱼\"\n2. **获取推荐对比** — 我搜索盒马商品、对比价格和新鲜度信息\n3. **选择并加入购物车（需登录）** — 确认商品后加入购物车，选择配送时段\n\n> 示例：\"帮我看看盒马今天有什么新鲜的草莓，我想买两盒\"\n\n---\n\n## 📝 Sample Prompts\n\n### 示例 1：商品搜索与推荐\n**用户输入：**\n```\n帮我看看盒马有什么好的三文鱼，想要新鲜的、性价比高的\n```\n\n**期望输出：**\n```\n🔍 搜索盒马：三文鱼\n\n找到以下商品（按推荐排序）：\n\n1️⃣ 🥇 挪威三文鱼刺身中段 200g\n   价格: ¥69.9（X会员 ¥59.9）\n   产地: 挪威\n   特点: 可溯源码、冰鲜配送\n   新鲜度: ✅ 今日到店\n\n2️⃣ 🥈 智利三文鱼排 250g\n   价格: ¥49.9（X会员 ¥42.9）\n   适合: 煎烤烹饪\n   特点: 急冻锁鲜\n\n3️⃣ 🥉 三文鱼腩刺身 150g\n   价格: ¥55.0（X会员 ¥46.8）\n   特点: 油脂丰富，口感最佳\n\n💡 推荐：如果想做刺身 → 推荐#1；如果想煎烤 → 推荐#2性价比高\n```\n\n### 示例 2：周采购规划\n**用户输入：**\n```\n帮我规划一下这周的晚餐采购清单，两个人吃，预算500以内\n```\n\n**期望输出：**\n```\n🛒 两人份周采购规划（预算 ¥500）\n\n📅 周一：番茄牛腩 + 清炒时蔬\n   - 牛腩 500g ¥45 | 番茄 3个 ¥9 | 西兰花 1颗 ¥8\n\n📅 周二：清蒸鲈鱼 + 蒜蓉菜心\n   - 鲈鱼 1条 ¥35 | 菜心 300g ¥6\n\n📅 周三：宫保鸡丁 + 凉拌黄瓜\n   - 鸡胸肉 300g ¥18 | 花生米 ¥5 | 黄瓜 2根 ¥5\n\n📅 周四：排骨汤 + 蚝油生菜\n   - 排骨 400g ¥42 | 生菜 1颗 ¥5\n\n📅 周五：虾仁滑蛋 + 炒杂蔬\n   - 虾仁 200g ¥38 | 鸡蛋 6枚 ¥8 | 杂蔬包 ¥10\n\n📅 周末：火锅自由\n   - 肥牛卷 300g ¥48 | 火锅底料 ¥15 | 蔬菜拼盘 ¥20\n\n💰 预估总计：¥459（预算内 ✅）\n💡 X会员预计可再省约 ¥45-60\n```\n\n### 示例 3：配送策略\n**用户输入：**\n```\n我想明天早上收到菜，盒马什么时段送最好？\n```\n\n**期望输出：**\n```\n📦 盒马配送时段建议（明天）\n\n⏰ 最佳选择：08:00-10:00 早间时段\n   ✅ 新鲜度最高\n   ✅ 预约充裕，不抢单\n   ✅ 蔬菜水果都是今早到店\n\n⏰ 次选：10:00-12:00 上午时段\n   ✅ 可选性仍好\n   ⚠️ 日日鲜商品可能部分售罄\n\n⏰ 不建议：下午/傍晚时段\n   ❌ 新鲜品选择少\n   ❌ 高峰时段预约难\n\n💡 策略：\n   • 今晚0点后可预约明天早上时段\n   • X会员可优先保留配送时段\n   • 如附近有盒马门店，最快30分钟送达\n```\n\n### 示例 4：会员分析\n**用户输入：**\n```\n我每个月在盒马大概花600块，开X会员划算吗？\n```\n\n**期望输出：**\n```\n💳 X会员性价比分析\n\n你的月均消费：¥600/月（¥7,200/年）\n\n📊 会员权益价值估算：\n\n1️⃣ 免费配送（会员免费，非会员¥6/单）\n   假设月均5单 → 省 ¥360/年\n\n2️⃣ 会员专享价（约5-15% off）\n   一般消费 → 省 ¥500-800/年\n\n3️⃣ 周二会员日折扣\n   额外优惠 → 省 ¥200-400/年\n\n💰 总节省预估：¥1,060-1,560/年\n会员年费：¥258\n\n📈 净节省：¥800-1,300/年 ✅ 非常推荐\n\n💡 建议：\n   • 如果月消费≥¥300，会员基本回本\n   • 你的消费水平开会员可省30%以上的配送费\n   • 先领新客优惠（有些渠道首年有折扣）\n```\n\n### 示例 5：生鲜选购技巧\n**用户输入：**\n```\n怎么在盒马买到最新鲜的蔬菜？日日鲜和普通的有什么区别？\n```\n\n**期望输出：**\n```\n🥬 盒马蔬菜选购指南\n\n📦 日日鲜（Daily Fresh） vs 普通蔬菜\n\n| 对比项 | 日日鲜 | 普通蔬菜 |\n|-------|--------|---------|\n| 包装日期 | 当天（明确标注） | 1-3天内 |\n| 产地 | 盒马直采基地 | 多种渠道 |\n| 价格 | 稍高（+10-20%） | 标准价 |\n| 保质期 | 2-3天 | 3-5天 |\n| 最佳食用 | 当天 | 1-2天内 |\n\n🔍 挑选技巧：\n\n1️⃣ 看包装日期\n   - 日日鲜必有\"包装日期：今天\"\n   - 没有日期的一律视为隔夜菜\n\n2️⃣ 看产地直采标签\n   - \"产地直采\" > 普通采购\n   - \"盒马村\" 标注的产品品质最好\n\n3️⃣ 按购买时机\n   - 早8-10点：蔬菜最新鲜，品种最全\n   - 晚8点后：可能有折扣，但新鲜度下降\n\n4️⃣ 检查蔬菜状态\n   - 叶菜：看叶片是否挺括、无水渍\n   - 根茎类：看表皮完整度\n   - 不要只看价格标签，实物要翻看\n```\n\n---\n\n## 📋 Real Task Examples\n\n| 场景 | 用户输入示例 | 技能输出要点 |\n|------|-------------|-------------|\n| **智能买菜** | \"帮我买盒马的黑虎虾，看看有什么规格的\" | 搜索商品 → 对比规格/价格/会员价 → 推荐最合适的 → 协助加购 |\n| **周计划** | \"这周末有朋友来家吃饭，4个人，帮我列个采购清单\" | 根据人数/场景规划菜单 → 生成采购清单 → 推荐盒马对应商品 → 估算费用 |\n| **优惠分析** | \"盒马上有没有什么划算的蒙牛牛奶？\" | 搜索+价格对比 → 分析单品/整箱哪个划算 → 计算X会员折扣 → 检查周二会员日优惠 |\n| **选购咨询** | \"阿根廷红虾和黑虎虾哪个好吃？\" | 产地/口感/烹饪方式对比 → 价格对比 → 建议搭配 → 盒马实时库存检查 |\n| **配送优化** | \"我明天要出差，想提前订好家里的菜\" | 配送时段选择建议 → 预约下单 → 生鲜保鲜建议 → 收件安排提示 |","topics":["Browser Automation","Payment","Shopping"],"tags":{"latest":"2.1.0"},"stats":{"comments":0,"downloads":584,"installsAllTime":22,"installsCurrent":0,"stars":0,"versions":6},"createdAt":1773529078934,"updatedAt":1781651515841},"latestVersion":{"version":"2.1.0","createdAt":1781651515841,"changelog":"**Changelog for freshippo 2.1.0**\n\n- Updated documentation to use the Chinese name “盒马鲜生” instead of “Freshippo (Hema)” throughout for greater localization and user clarity.\n- Made minor text improvements and consistency updates in README.md and SKILL.md.\n- No feature or logic changes; update limited to documentation.","license":"MIT-0"},"metadata":{"setup":[],"os":["linux","darwin","win32"],"systems":null},"owner":{"handle":"harrylabsj","userId":"s17a8m9q4jybb46cv60h4fxard83hmsn","displayName":"haidong","image":"https://avatars.githubusercontent.com/u/144880725?v=4"},"moderation":null}