Taobao Query Skill

This skill enables interacting with Taobao through an MCP (Model Context Protocol) server to query products, manage cart/orders, and communicate with sellers.

⚠️ Prerequisites - IMPORTANT

This skill requires a running Taobao MCP server.

Setup Required

1. 1. Install Taobao Desktop Client (淘宝桌面版) on your local machine
2. Enable MCP service in the client settings
3. Configure MCP URL in your OpenClaw config (see below)

Default Configuration

Default MCP Server: INLINECODE0

If your MCP server runs on a different address, configure it via environment variable:

CODEBLOCK0

Or set it in OpenClaw config:
CODEBLOCK1

When to Use This Skill

Use this skill when the user:

• - Asks about product prices on Taobao (e.g., "iPhone 16 淘宝价格")
• Wants to search for items and compare prices
• Asks to view shopping cart contents
• Wants to check order status or history
• Needs to contact seller/customer service via 旺旺
• Requests product links from Taobao
• Mentions "销量" (sales volume), "店铺" (shop), "价格" (price), "购物车" (cart), "订单" (order)

🔴 RESTRICTION - IMPORTANT

NEVER perform the following operations:

• - Payment or checkout operations
• Confirming orders
• Any financial transactions
• Authorizing payments
• Auto-buying with stored payment methods

Permitted operations:

• - Search products
• View cart/orders (read-only)
• Add items to cart
• Browse products
• Chat with customer service
• Navigate pages

Query Strategy Based on User Input

Case 1: Specific Product Model Given

When user provides a specific model (e.g., "iPhone 16 Pro Max 256GB", "MacBook Air M4 13寸 16GB+512GB", "AirPods Pro 2"):

1. 1. Search with exact keywords provided by user
2. Filter results:

- Remove accessories, cases, protective films - Remove single-ear replacements, charging case only listings - Remove second-hand items (二手) - Remove suspiciously low prices (e.g., iPhone for ¥1000)

1. 3. Sort by price (ascending)
2. Return top 5-8 results showing:

- Different stores and their prices - Any subsidies (政府补贴, 百亿补贴) applied - Official store for reference

Case 2: General Product Category Only

When user asks about a general category without specific model (e.g., "iPhone", "MacBook Air", "蓝牙耳机", "机械键盘"):

1. 1. Search with broad keywords
2. Analyze all results to identify:

- Different models/variants available - Different specifications (storage, color, size, etc.) - Price distribution across variants

1. 3. Categorize by specifications:

- Group similar products together - Identify entry-level, mid-range, high-end variants

1. 4. Provide comprehensive report:

- Price range for each specification tier - Popular/recommended variants - Purchase advice based on use case

MCP Configuration

Server URL: ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}
Transport: streamableHttp
Server Name: INLINECODE3

MCP Call Process

The MCP server uses streamable HTTP transport. Standard call process:

1. 1. Initialize connection to get session ID:

CODEBLOCK2

1. 2. Extract session ID from response headers: INLINECODE4

1. 3. Call tools with session ID in header: INLINECODE5

Available Tools

Product Search & Browsing

• - searchproducts - Search products by keyword
• navigate - Navigate to Taobao pages (home, cart, order, tmall, my, etc.)
• navigatetourl - Open any URL
• readpagecontent - Read visible page text
• scrollpage - Scroll page
• scanpageelements - Scan interactive elements
• clickelement - Click page element
• inputtext - Input text to fields

Cart & Orders (Read-Only)

• - navigate with page: cart or INLINECODE7
• readpagecontent - View cart/order details
• addtocart - Add items to cart (safe, no payment)

Customer Service

• - openchat - Open Wangwang chat and send message
• sendchat_message - Send additional messages in chat

Utility

• - getbrowsehistory - Get browsing history (product/search/shop)
• getcurrenttab - Get current page info
• closepage - Close current page
• inspectpage - Diagnose page DOM state

Output Formats

Format A: Specific Model Search Results

Use when user provided specific model:

CODEBLOCK3

Format B: General Category Analysis

Use when user asked about a category without specific model:

CODEBLOCK4

Filtering Rules

Always filter out:

• - Price = 0 or null
• Missing shop name
• Clearly mismatched products (e.g., searching for iPhone but getting cases)
• Used/second-hand items (二手, 翻新) unless specifically requested
• Accessories when searching for main product (cases, chargers, etc.)
• Suspiciously low prices (e.g., MacBook for ¥2000)
• Service listings (安装系统, 数据恢复, 租赁)

Link format:

• - Extract itemId from productUrl
• Tmall: INLINECODE8
• Taobao: INLINECODE9

Connection Health Detection

MCP service may disconnect. Detect and handle connection issues:

Connection Error Patterns

Connection failed indicators:

• - Connection failed or Connection refused errors
• Timeout errors (no response after 10+ seconds)
• INLINECODE12 header missing from initialize response
• Empty or malformed JSON responses
• HTTP status codes: 500, 502, 503, 504

Session expired indicators:

• - Error message: "未提供有效的会话ID" (invalid session ID)
• Error code: -32000 with session-related message
• Previously working session suddenly returns auth errors

Connection Recovery Steps

When connection fails:

1. 1. First failure:

   ⚠️ MCP 服务连接失败，正在尝试重新连接...
   

- Retry initialize with new session - If succeeds, continue with operation

1. 2. Second failure (persistent):

   ❌ MCP 服务暂时不可用

   可能原因：
   - 淘宝桌面客户端未运行
   - 网络连接问题
   - MCP 服务需要重启

   建议操作：
   1. 检查淘宝桌面客户端是否已打开
   2. 确认电脑网络连接正常
   3. 重启淘宝桌面客户端后重试
   
   当前配置的 MCP 地址: ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}
   

- Stop attempting further MCP calls - Inform user clearly about the issue - Provide actionable troubleshooting steps

1. 3. Session expired mid-operation:

- Detect "invalid session" errors - Automatically re-initialize with new session - Retry the failed operation once - If still fails, treat as connection failure (step 2)

Proactive Health Check

Before major operations (e.g., viewing cart with many items), optionally verify connection:
CODEBLOCK7

Error Handling

If the MCP server is unreachable or returns an error:

1. 1. Detect error type (connection vs. session vs. operational)
2. For connection errors: Follow Connection Recovery Steps above
3. For session errors: Attempt re-initialization once, then follow recovery steps
4. For operational errors: Inform user of specific error, suggest alternatives
5. Never make up fake product data or pretend operation succeeded

Safety Reminders

• - Never proceed to payment or checkout
• Never click "立即购买" (Buy Now) if it leads to payment
• Never confirm orders on behalf of the user
• Cart operations (add/view) are safe - payment is the red line

Example Interactions

User: "iPhone 16 Pro Max 256GB 多少钱"
→ Specific model given → Search exact keywords → Filter accessories → Return top 5-8 prices

User: "MacBook Air 推荐"
→ Category only → Search broadly → Analyze all M3/M4/M5 variants → Provide price ranges for each spec → Give purchase advice

User: "看看我的购物车"
→ Use navigate to cart → read_page_content → Show items