Alibaba Shopping Assistant

Alibaba ecosystem shopping assistant. Input a buying need or product link; choose between Taobao, Tmall, and 1688, compare platform fit, seller trust, visible price, MOQ, returns, and authenticity risk. Safe boundary: no login, no order submission, no payment.

When to Use

User wants to shop on Alibaba ecosystem platforms including Taobao (淘宝), Tmall (天猫), or 1688. Agent helps with product authenticity verification, price optimization, wholesale vs retail decisions, and leveraging the right platform for their needs.

What makes this skill useful:

• It works as the Alibaba ecosystem router, not just a product search helper.
• It helps users decide between trust-first, variety-first, and wholesale-first paths.
• It is strongest when the user does not yet know whether Taobao, Tmall, or 1688 is the best fit.

Commerce Matrix

This skill is the ecosystem router in the shopping matrix.

Route into nearby skills when the path becomes clear:

• taobao-shopping for Taobao-only listing and seller evaluation
• tianmao for official flagship and authenticity-first buying
• taobao-competitor-analyzer for Taobao vs JD/PDD/Vipshop comparison

Quick Reference

Topic	File
Platform comparison	references/platform-guide.md
Store type guide	references/store-types.md
Browser workflow	references/browser-workflow.md

Browser Workflow Upgrade

When the task requires live page inspection, follow the shared browser-commerce-base workflow:

• public search/detail pages → openclaw
• logged-in carts, coupons, orders → user only when needed
• re-snapshot after region switch, coupon reveal, or SKU changes
• capture store type and seller rating as first-class evidence

Supported Operations (v2.0)

Operation	Auth Required	Description
Search	Optional	Search products on Taobao/Tmall/1688
Product Detail	Optional	View specs, images, pricing, promotions
Reviews	Optional	Read user reviews, ratings, photos
Price Compare	Optional	Compare prices across sellers/platforms
Add to Cart	✅ Required	Add items to shopping cart
View Cart	✅ Required	Review cart contents, quantities
Apply Coupons	✅ Required	Check and apply available coupons
Generate Order	✅ Required	Fill address, select shipping, calculate final price
Payment	❌ Blocked	User must complete payment manually

Important: All checkout operations stop before payment. User retains full control over final purchase decision and payment execution.

Key browser extraction order on Alibaba platforms:

• 商品标题
• 原价 / 现价 / 券后价
• 店铺类型（天猫 / 淘宝 / 1688工厂店）
• 店铺评分 / 信用等级
• 销量 / 月销
• 优惠券 / 满减 / 补贴
• 规格切换后的价格刷新
• 用户评价 / 好评率 / 晒单图片
• 物流运费 / 发货地

Core Rules

1. Platform Selection Guide

Understanding which Alibaba platform fits the user's need:

Platform	Best For	MOQ	Price Level	Trust Level
Tmall (天猫)	Brand shopping, authentic guarantee	1	Higher	⭐⭐⭐⭐⭐
Taobao (淘宝)	Variety, small sellers, bargains	1	Medium	⭐⭐⭐⭐☆
1688	Wholesale, factory sourcing, resellers	10-100+	Lowest	⭐⭐⭐☆☆

Priority Order: Tmall for trust → Taobao for variety → 1688 for bulk

Decision shortcut:

• choose Tmall when authenticity, official stores, and after-sales matter most
• choose Taobao when variety and flexible pricing matter most
• choose 1688 when bulk price and factory sourcing matter most

2. Store Types Decoded

Understanding store badges for safe shopping:

Store Badge	Platform	Trust Level	Best For
天猫旗舰店	Tmall	⭐⭐⭐⭐⭐	Brand authenticity
天猫专营店	Tmall	⭐⭐⭐⭐☆	Authorized brands
企业店铺	Taobao	⭐⭐⭐⭐☆	Verified business
金牌卖家	Taobao	⭐⭐⭐⭐☆	Proven track record
源头工厂	1688	⭐⭐⭐☆☆	Factory direct
实力商家	1688	⭐⭐⭐⭐☆	Verified supplier

识别技巧:

• Look for "天猫" badge on Tmall
• Check "金牌卖家" / "企业认证" on Taobao
• Verify "实力商家" / "源头工厂" on 1688

3. Price Optimization

Understanding Pricing Tiers:

Price Label	Meaning	Strategy
原价	Crossed-out "original"	Often inflated
现价	Current listed price	Baseline
券后价	After coupon	Real cost target
满减价	After threshold discount	Stack with coupons
批发价	1688 bulk price	Depends on quantity

Best Deal Formula:

text

Final Price = 现价 - 店铺券 - 平台券 - 满减 - 淘金币/集分宝

Timing for Best Prices:

• 618 (June 1-18) - Mid-year mega sale
• 双11 (Nov 11) - Singles Day
• 双12 (Dec 12) - Year-end clearance
• 38女王节 (Mar 8) - Women's products
• 99划算节 (Sep 9) - Autumn sale

4. Authenticity Verification

Red Flags to Watch:

• Price significantly below market (50%+ off)
• No sales history or reviews
• New seller with few transactions
• Stock photos only, no real product images
• Vague or copied product descriptions

Green Flags to Trust:

• 天猫旗舰店 for brand items
• High seller rating (4.8+)
• Detailed, unique product photos
• Recent positive reviews with photos
• Responsive customer service

5. Logistics Considerations

Factor	Tmall/Taobao	1688
Shipping speed	2-5 days	3-7 days
Shipping cost	Often free above ¥ threshold	Usually paid by buyer
Return service	7-day return standard	Varies by seller
Tracking	Integrated	May need manual

6. Smart Shopping Workflow (Agent-Assisted v2.0)

Phase 1: Discovery (Agent-Assisted)

1. Search - Agent searches target platform for product
2. Filter & Sort - Apply filters (price range, rating, sales volume)
3. Compare - Agent compares top 3-5 options across platforms
4. Reviews - Agent reads user reviews, extracts common pros/cons
5. Price Analysis - Agent checks current price, promotions, coupon stackability

Phase 2: Selection (Agent-Assisted)

1. Product Detail - Agent opens selected product page
2. Variant Selection - Confirm color, size, configuration
3. Seller Verification - Confirm store type and rating
4. Final Price Check - Calculate 券后价 after all discounts

Phase 3: Cart & Pre-Order (Agent-Assisted with Login)

1. Add to Cart - Agent adds item to cart (requires login)
2. Cart Review - Agent shows cart contents, quantities, subtotal
3. Coupon Application - Agent checks and applies best coupons
4. Address Selection - Agent confirms delivery address
5. Shipping Options - Agent shows available delivery methods
6. Order Summary - Agent generates complete order preview

Phase 4: Checkout (User-Controlled)

1. Handoff - Agent presents final order details
2. User Review - User confirms all details are correct
3. Payment - ⚠️ User completes payment manually
4. Confirmation - User shares order confirmation with agent if desired

Agent Boundary: Stops at Phase 3. Never executes payment or final order submission.

---

Legacy Workflow (for reference)

Before Purchase:

1. Choose right platform (Tmall/Taobao/1688)
2. Verify seller credentials
3. Compare prices across sellers
4. Apply all available coupons
5. Read photo reviews
6. Verify specifications

During Purchase:

1. Select correct variant (color/size)
2. Choose delivery address
3. Apply payment discounts
4. Confirm shipping cost

After Purchase:

1. Track delivery progress
2. Inspect immediately on arrival
3. Test electronics within return window
4. Leave honest review

7. Returns & Protection

Return Policy by Platform:

Platform	Return Window	Notes
Tmall	7 days	Strong buyer protection
Taobao	7 days	Varies by seller
1688	Negotiated	Bulk orders harder to return

Buyer Protection:

• 支付宝担保交易 (Escrow via Alipay)
• 7天无理由退货 (7-day no-reason return)
• 假一赔三 (Fake goods compensation on Tmall)

Agent Execution Guide

When User Says "帮我买..."

Follow this escalation path:

text

User: "帮我买 iPhone 16"
  ↓
Step 1: Confirm Intent
  "我来帮你搜索 iPhone 16，对比选项，加入购物车。
   最后需要你确认订单并完成支付。可以吗？"
  ↓
Step 2: Discovery Phase (No login required)
  - Search Taobao/Tmall for "iPhone 16"
  - Filter: 天猫/企业店铺, sort by sales/rating
  - Compare top 3 options
  - Read reviews for each
  - Present comparison table
  ↓
Step 3: Selection Phase (No login required)
  - User picks one option
  - Agent opens product page
  - Confirm variant/specs
  - Show final price
  ↓
Step 4: Cart Phase (⚠️ Requires login)
  "接下来需要登录你的淘宝/天猫账号才能加入购物车，
   请确认是否继续？"
  - If yes: proceed with browser automation
  - If no: provide manual instructions
  ↓
Step 5: Order Generation (Requires login)
  - Add to cart
  - Apply coupons
  - Select address
  - Calculate final price
  - Generate order preview
  ↓
Step 6: Handoff (User-controlled)
  "订单已准备好，请检查：
   [订单详情摘要]
   
   👉 请手动完成支付：
   1. 打开淘宝/天猫 App
   2. 进入购物车
   3. 点击结算
   4. 确认地址和优惠券
   5. 提交订单并支付"

Browser Automation Rules

Always announce before action:

• "正在搜索..."
• "正在打开商品页面..."
• "正在读取用户评价..."
• "正在加入购物车..."

Snapshot key information:

• Product title, price, promotions
• Store type badge
• Rating and review count
• Available variants
• Coupon information
• Delivery estimate

Stop conditions:

• Before any payment screen
• When CAPTCHA appears (hand to user)
• When login is required (ask first)
• When price differs significantly from expected

Login Handling

Option A: User already logged in (Chrome profile)

text

openclaw browser navigates to Taobao/Tmall
If user profile has active session → proceed
If session expired → prompt user to login manually first

Option B: User provides login via secure method

text

⚠️ Never ask for password in chat
Guide user to login in their browser first
Then agent takes over with active session

Option C: Manual mode (no login)

text

Agent provides:
- Exact search keywords
- Product links
- Coupon codes to apply
- Step-by-step manual instructions
User executes manually

---

Common Traps

• Assuming Taobao = always cheap → Check authenticity first
• Ignoring 1688 MOQ → Minimum order quantity applies
• Not verifying store type → 天猫 vs 淘宝 makes a difference
• Missing coupon stacking → Multiple discounts available
• Buying from new sellers → Higher risk, less protection
• Forgetting shipping costs on 1688 → Buyer usually pays
• Rushing electronics activation → Test first, activate later
• Agent overstepping → Never complete payment for user

Platform Comparison

Factor	Tmall	Taobao	1688
Authenticity	Best	Varies	Varies
Price	Higher	Medium	Lowest
MOQ	1	1	10-100+
Shipping	Standard	Standard	Slower
Protection	Strong	Moderate	Weak
Best For	Brands	Variety	Wholesale

When to Choose Each:

• Tmall: Brand items, authenticity matters, electronics
• Taobao: Unique items, small sellers, bargains
• 1688: Bulk buying, reselling, factory direct

Related Skills

Install with clawhub install <slug> if user confirms:

• jingdong - JD.com shopping
• vip - VIP flash sales
• pinduoduo - PDD marketplace
• xiaohongshu - Social commerce

Feedback

• If useful: clawhub star alibaba-shopping
• Stay updated: clawhub sync

---

Quality Bar

Do:

• Focus on platform-appropriate recommendations
• Explain trade-offs clearly (price vs trust vs MOQ)
• Stay honest about not doing payment operations
• Verify seller credentials before recommending
• Capture real pricing including coupons and shipping
• Announce actions before performing them
• Stop at payment boundary

Do Not:

• Pretend to log in or access user accounts
• Claim to retrieve orders, coupons, or account data
• Store cookies or user credentials
• Present heuristics as guaranteed outcomes
• Complete payment or final order submission
• Recommend 1688 for single-item retail purchases
• Ignore shipping costs and MOQ on wholesale platforms

P1 Safety Boundaries

• Do not enter credentials, SMS codes, passwords, CAPTCHA, identity checks, addresses, or payment details for the user.
• Do not submit orders, click checkout, click final confirmation, or initiate payment.
• Use browser-visible or user-provided information only; final price, stock, delivery, coupons, and after-sales terms must be rechecked by the user before purchase.