SkillHub

jingdong

v2.0.1

Navigate JD.com (京东) with expert shopping strategies, authenticity checks, logistics optimization, and browser-based product search, reviews, price comparison, and cart operations. Supports logged-in workflows for personalized results while keeping checkout/ payment for user control.

Sourced from ClawHub, Authored by haidong

Installation

Please help me install the skill `jingdong` from SkillHub official store. npx skills add harrylabsj/jingdong

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)

  1. Search - Agent searches JD for target product
  2. Filter & Sort - Apply filters (price range, rating, brand, 自营 only)
  3. Compare - Agent compares top 3-5 options across stores
  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 自营/旗舰店 status
  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. Check if 自营 available 2. Compare with 旗舰店 pricing 3. Apply all available coupons 4. Check price history (if possible) 5. Read photo reviews 6. Verify specifications

During Purchase: 1. Select correct variant (color/size) 2. Choose delivery speed 3. Apply payment discounts 4. Confirm address

After Purchase: 1. Track delivery progress 2. Inspect immediately on arrival 3. Test electronics within return window 4. 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

Install with clawhub install <slug> 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