When to Use

User wants to shop on JD.com (京东), China's premier B2C e-commerce platform. Agent helps with product authenticity verification, price optimization, and leveraging JD's superior logistics network.

Quick Reference

Topic	File
Store type guide	stores.md
Price strategies	pricing.md
Logistics mastery	shipping.md

Browser Workflow Upgrade

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

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

Supported Operations (v2.0)

Operation	Auth Required	Description
Search	Optional	Search products, filter by price/rating/brand
Product Detail	Optional	View specs, images, pricing, promotions
Reviews	Optional	Read user reviews, ratings, photos
Price Compare	Optional	Compare prices across sellers/variants
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 JD:

• 商品标题
• 京东价 / PLUS价 / 到手价
• 店铺类型（自营 / 旗舰店 / 第三方）
• 物流时效 / 配送承诺
• 优惠券 / 满减 / 补贴
• 规格切换后的价格刷新
• 用户评价 / 好评率 / 晒单图片

Core Rules

1. JD Store Types Decoded

Understanding JD's ecosystem is crucial for safe shopping:

Store Badge	Chinese	Trust Level	Best For
JD Self	京东自营	⭐⭐⭐⭐⭐	Electronics, urgent items
Flagship	官方旗舰店	⭐⭐⭐⭐⭐	Brand authenticity
Authorized	专卖店	⭐⭐⭐⭐☆	Specific brands
3rd Party	第三方商家	⭐⭐⭐☆☆	Price hunting

Priority Order: 自营 > 旗舰店 > 专卖店 > 第三方

2. The 自营 Advantage

Why JD Self-Operated Wins:

Factor	自营	3rd Party
Authenticity	100% guaranteed	Varies
Shipping speed	Same/next day	2-5 days
Return service	Pickup included	Self-return
Customer service	JD handles	Seller handles
Price protection	Automatic	Manual claim

识别自营:

• Look for "京东自营" red badge
• Ships via "京东物流"
• Product URL contains "jd.com"

3. Price Optimization

Understanding JD Pricing Tiers:

Price Label	Meaning	Strategy
划线价	Crossed-out "original"	Often inflated
京东价	Current listed price	Baseline
PLUS价	Member discount	Join if frequent buyer
秒杀价	Flash sale	Set alerts
到手价	After coupons	Real cost

Best Deal Formula:

Final Price = 京东价 - 店铺券 - 平台券 - PLUS折扣 - 支付优惠

Timing for Best Prices:

• 618 (June 1-18) - Mid-year mega sale
• 双11 (Nov 11) - Singles Day
• 双12 (Dec 12) - Year-end clearance
• Monthly 18th - Regular promotions

4. PLUS Membership Deep Dive

Annual Cost: ¥198 (often ¥99-149 on promotion)

Core Benefits:

Benefit	Value
Free shipping	Saves ¥6-15/order
10x 京豆 (beans)	1% cashback
Member-only prices	5-20% off
Return shipping	Free pickup
Priority service	Faster support

Worth It Calculator:

• Order 2+ times/month → Yes
• Average order >¥150 → Yes
• Buy electronics regularly → Definitely yes

5. Logistics Excellence

JD's 211 Promise:

Order Time	Delivery Commitment
Before 11 AM	Same day by 11 PM
Before 11 PM	Next day by 3 PM

Delivery Options:

Service	Speed	Use Case
标准快递	1-3 days	Regular orders
京准达	Scheduled window	Time-sensitive
夜间配	7-10 PM	Working professionals
自提点	Flexible pickup	Privacy/convenience

Tracking Features:

• Real-time GPS map
• Driver contact info
• Photo confirmation
• Delivery time prediction

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

Phase 1: Discovery (Agent-Assisted)

• Search - Agent searches JD for target product
• Filter & Sort - Apply filters (price range, rating, brand, 自营 only)
• Compare - Agent compares top 3-5 options across stores
• Reviews - Agent reads user reviews, extracts common pros/cons
• Price Analysis - Agent checks current price, promotions, coupon stackability

Phase 2: Selection (Agent-Assisted)

• Product Detail - Agent opens selected product page
• Variant Selection - Confirm color, size, configuration
• Seller Verification - Confirm 自营/旗舰店 status
• Final Price Check - Calculate 到手价 after all discounts

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

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

Phase 4: Checkout (User-Controlled)

• Handoff - Agent presents final order details
• User Review - User confirms all details are correct
• Payment - ⚠️ User completes payment manually
• 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:

• Check if 自营 available
• Compare with 旗舰店 pricing
• Apply all available coupons
• Check price history (if possible)
• Read photo reviews
• Verify specifications

During Purchase:

• Select correct variant (color/size)
• Choose delivery speed
• Apply payment discounts
• Confirm address

After Purchase:

• Track delivery progress
• Inspect immediately on arrival
• Test electronics within return window
• Claim price protection if applicable

7. Returns & Protection

Return Policy by Category:

Category	Window	Notes
General	7 days	Unused, tags on
Electronics	7 days	Unactivated
Clothing	7 days	Unworn
Food	No return	Unless spoiled
Custom	No return	Personalized

Price Protection (价保):

• 7-day automatic for 自营
• 30-day manual claim for others
• Must be same product, same seller
• Refund difference to original payment

Agent Execution Guide

When User Says "帮我买..."

Follow this escalation path:

User: "帮我买 Mac mini"
  ↓
Step 1: Confirm Intent
  "我来帮你搜索 Mac mini，对比选项，加入购物车。
   最后需要你确认订单并完成支付。可以吗？"
  ↓
Step 2: Discovery Phase (No login required)
  - Search JD for "Mac mini M4"
  - Filter: 自营/旗舰店, sort by 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)

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

Option B: User provides login via secure method

⚠️ 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)

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

---

Common Traps

• Assuming JD = always authentic → Check store type first
• Ignoring PLUS pricing → Significant savings missed
• Not checking 211 coverage → Your area may differ
• Missing coupon stacking → Multiple discounts available
• Buying from new sellers → Higher risk, less protection
• Forgetting price protection → Free money left behind
• Rushing electronics activation → Test first, activate later
• Agent overstepping → Never complete payment for user

JD vs Competitors

Factor	JD	Taobao	VIP
Authenticity	Best	Varies	Good
Shipping	Fastest	Varies	Standard
Electronics	Best choice	Riskier	Limited
Price	Higher	Lower	Discounted
Service	Excellent	Varies	Good

When to Choose JD:

• Electronics and appliances
• Time-sensitive purchases
• High-value items
• When authenticity matters most

Related Skills

Install with clawhub install if user confirms:

• jd-shopping - Alternative JD guide
• taobao - Taobao marketplace
• vip - VIP flash sales
• alibaba-shopping - Taobao/Tmall guide

Feedback

• If useful: clawhub star jingdong
• Stay updated: clawhub sync