淘宝查询技能

该技能通过 MCP（Model Context Protocol）服务器与淘宝进行交互，支持商品搜索、购物车/订单管理以及与卖家沟通。

⚠️ 前置条件 — 重要

本技能需依赖一个正在运行的淘宝 MCP 服务器。

必需配置步骤

1. 在本地机器安装淘宝桌面版客户端
2. 在客户端设置中启用 MCP 服务
3. 在 OpenClaw 配置中配置 MCP URL（详见下文）

默认配置

默认 MCP 服务器地址：http://127.0.0.1:3654/mcp

若你的 MCP 服务器运行于其他地址，请通过环境变量配置：

# 添加至 OpenClaw 环境或 Shell 配置文件中
export TAOBAO_MCP_URL="http://your-server-ip:3654/mcp"

或在 OpenClaw 配置文件中设置：

{
  "env": {
    "TAOBAO_MCP_URL": "http://192.168.100.20:3654/mcp"
  }
}

何时使用该技能

当用户提出以下请求时，请启用本技能：

• 询问淘宝上某商品的价格（例如：“iPhone 16 淘宝价格”）
• 希望搜索商品并横向比价
• 要求查看购物车内容
• 希望查询订单状态或历史记录
• 需要通过旺旺联系卖家或客服
• 请求获取淘宝商品链接
• 提及“销量”、“店铺”、“价格”、“购物车”、“订单”等关键词

🔴 限制说明 — 重要

严禁执行以下操作：

• 支付或结算操作
• 确认订单
• 任何金融类交易
• 授权付款
• 使用已保存的支付方式自动下单

允许执行的操作：

• 商品搜索
• 查看购物车/订单（仅读取）
• 将商品加入购物车
• 浏览商品页面
• 与客服聊天
• 页面导航

基于用户输入的查询策略

场景一：用户提供了具体型号

当用户提供明确型号时（例如：“iPhone 16 Pro Max 256GB”、“MacBook Air M4 13寸 16GB+512GB”、“AirPods Pro 2”）：

1. 使用用户提供的精确关键词进行搜索
2. 对结果进行过滤：
   • 移除配件类商品（保护壳、贴膜等）
   • 移除单耳替换件、仅含充电盒的商品
   • 移除二手商品（二手、翻新）
   • 移除价格明显异常的商品（例如标价 ¥1000 的 iPhone）
3. 按价格升序排序
4. 返回前 5–8 条结果，包含：
   • 不同店铺及其报价
   • 已应用的补贴（如“政府补贴”、“百亿补贴”）
   • 官方旗舰店作为参考项

场景二：用户仅提供通用品类

当用户仅提及宽泛品类而未指定型号时（例如：“iPhone”、“MacBook Air”、“蓝牙耳机”、“机械键盘”）：

1. 使用宽泛关键词进行搜索
2. 分析全部结果，识别：
   • 当前可售的不同型号/版本
   • 各版本差异（存储容量、颜色、尺寸等）
   • 不同版本的价格分布
3. 按规格归类：
   • 将相似产品分组聚合
   • 区分入门款、中端款、旗舰款等定位
4. 输出综合分析报告：
   • 各规格层级对应的价格区间
   • 热门/推荐型号
   • 结合使用场景给出选购建议

MCP 配置

服务器地址：${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}
传输协议：streamableHttp
服务器名称：taobao-native

MCP 调用流程

MCP 服务器采用 streamable HTTP 协议。标准调用流程如下：

1. 初始化连接以获取会话 ID：

curl -X POST ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp} 
  -H "Content-Type: application/json" 
  -H "Accept: application/json, text/event-stream" 
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "openclaw-agent",
        "version": "1.0.0"
      }
    }
  }'

2. 从响应头中提取 session ID：mcp-session-id:

3. 后续工具调用时，在请求头中携带 session ID：mcp-session-id:

可用工具列表

商品搜索与浏览

• search_products — 按关键词搜索商品
• navigate — 导航至淘宝页面（首页、购物车、订单页、天猫、我的等）
• navigate_to_url — 打开任意 URL
• read_page_content — 读取当前页面可见文本内容
• scroll_page — 页面滚动
• scan_page_elements — 扫描页面可交互元素
• click_element — 点击页面元素
• input_text — 向输入框填写文本

购物车与订单（只读）

• 使用 navigate 并传入 page: cart 或 page: order
• read_page_content — 查看购物车/订单详情
• add_to_cart — 将商品加入购物车（安全操作，不触发支付）

客户服务

• open_chat — 打开旺旺聊天窗口并发送首条消息
• send_chat_message — 在已有聊天窗口中继续发送消息

辅助工具

• get_browse_history — 获取浏览历史（商品/搜索/店铺）
• get_current_tab — 获取当前页面信息
• close_page — 关闭当前页面
• inspect_page — 诊断页面 DOM 状态

输出格式规范

格式 A：具体型号搜索结果

适用于用户明确提供型号的情形：

## 🛍️ [商品型号] 价格查询结果

### 价格对比（从低到高）

| 排名 | 店铺 | 价格 | 优惠/补贴 | 链接 |
|:---:|:---|:---:|:---|:---:|
| 1 | [店铺名] | **¥XXXX** | 政府补贴15% | [查看](URL) |
| 2 | [店铺名] | **¥XXXX** | 百亿补贴 | [查看](URL) |
| 3 | [店铺名] | **¥XXXX** | 无 | [查看](URL) |

### 购买建议
- **最优惠**: [店铺名] ¥XXXX（有政府补贴，需确认资格）
- **官方保障**: Apple Store 官方旗舰店 ¥XXXX
- **注意事项**: [任何需要提醒的事项]

格式 B：通用品类分析报告

适用于用户仅提出品类需求、未指定型号的情形：

## 🛍️ [商品品类] 价格分析

查询到 [N] 款在售商品，按规格分类如下：

### 📱 规格分类与价格区间

| 规格/型号 | 价格区间 | 推荐入手价 | 说明 |
|:---------|:---:|:---:|:---|
| 入门款/基础版 | ¥X,XXX - ¥X,XXX | **¥X,XXX** | 适合日常使用 |
| 中端款/Pro版 | ¥X,XXX - ¥X,XXX | **¥X,XXX** | 性价比最高 |
| 旗舰款/Max版 | ¥X,XXX - ¥X,XXX | **¥X,XXX** | 专业需求 |

### 💰 具体价格参考

**[规格A]**
- 最低价：¥XXXX（[店铺名]）
- 官方价：¥XXXX（官方旗舰店）
- 百亿补贴价：¥XXXX（如适用）

**[规格B]**
- ...

### 🎯 购买建议

**预算有限**: 选择 [规格A]，推荐 [店铺] ¥XXXX
**追求性价比**: 选择 [规格B]，推荐 [店铺] ¥XXXX  
**要官方保障**: 选择官方旗舰店 [规格] ¥XXXX

**注意事项**:
- [提醒1: 如政府补贴需要资格]
- [提醒2: 如百亿补贴库存有限]
- [提醒3: 如新品即将发布等]

过滤规则

必须始终排除以下类型结果：

• 价格为 0 或空值
• 缺少店铺名称
• 明显不匹配的商品（如搜索 iPhone 却返回保护壳）
• 二手/翻新产品（二手、翻新），除非用户明确要求
• 主商品搜索中混入配件（保护壳、充电器等）
• 价格明显异常（如 MacBook 标价 ¥2000）
• 服务类商品（系统安装、数据恢复、租赁等）

商品链接格式规范：

• 从 productUrl 中提取 itemId
• 天猫链接格式：https://detail.tmall.com/item.htm?id=
• 淘宝链接格式：https://item.taobao.com/item.htm?id=

连接健康状态检测

MCP 服务可能出现断连。需主动检测并处理连接异常：

连接错误特征

连接失败典型表现：

• 报错信息含 Connection failed 或 Connection refused
• 超时错误（10 秒以上无响应）
• initialize 响应中缺失 mcp-session-id 响应头
• 响应为空或 JSON 格式非法
• HTTP 状态码为：500、502、503、504

会话过期典型表现：

• 错误提示：“未提供有效的会话ID”
• 错误码为 -32000，且附带与会话相关的描述
• 此前正常工作的会话突然返回鉴权失败

连接恢复流程

当连接失败时，按以下步骤处理：

1. 首次失败：

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

   • 重试 initialize 请求以建立新会话
   • 若成功，则继续执行原操作

2. 二次失败（持续不可用）：

   ❌ MCP 服务暂时不可用
   
   可能原因：
   - 淘宝桌面客户端未运行
   - 网络连接问题
   - MCP 服务需要重启
   
   建议操作：
   1. 检查淘宝桌面客户端是否已打开
   2. 确认电脑网络连接正常
   3. 重启淘宝桌面客户端后重试
   
   当前配置的 MCP 地址: ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}
   

   • 停止后续所有 MCP 调用
   • 向用户清晰说明问题
   • 提供可操作的排查指引

3. 操作中途会话过期：

   • 检测 “invalid session” 类错误
   • 自动重新 initialize 获取新会话
   • 对失败操作重试一次
   • 若仍失败，则按“二次失败”流程处理（即步骤 2）

主动健康检查

在执行关键操作前（例如：查看含大量商品的购物车），可选执行轻量健康检查：

# 快速健康检查 — 尝试获取当前标签页信息
curl -X POST ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp} 
  -H "mcp-session-id: " 
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_current_tab"}}'

错误处理机制

当 MCP 服务器不可达或返回错误时：

1. 识别错误类型（连接层 / 会话层 / 业务层）
2. 连接错误：执行上述“连接恢复流程”
3. 会话错误：先尝试一次 re-initialize，再进入恢复流程
4. 业务错误：向用户明确说明具体错误，并提供替代方案建议
5. 严禁虚构商品数据，或伪装操作成功

安全提醒

• 严禁进入支付或结算流程
• 严禁点击“立即购买”按钮（若其导向支付环节）
• 严禁代用户确认订单
• 购物车相关操作（添加/查看）是安全的 —— 支付是绝对红线

交互示例

用户：“iPhone 16 Pro Max 256GB 多少钱”
→ 提供具体型号 → 使用精确关键词搜索 → 过滤配件 → 返回前 5–8 条价格结果

用户：“MacBook Air 推荐”
→ 仅提供品类 → 宽泛关键词搜索 → 分析全部 M3/M4/M5 型号 → 输出各规格价格区间 → 给出选购建议

用户：“看看我的购物车”
→ 调用 navigate 导航至购物车页 → 调用 read_page_content → 展示商品列表