Taobao 查询技能

此技能通过 MCP（模型上下文协议）服务器与淘宝进行交互，支持商品查询、购物车/订单管理以及与卖家沟通。

⚠️ 前置条件 - 重要

本技能需要运行中的淘宝 MCP 服务器。

必须设置

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

默认配置

默认 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. 筛选结果：

- 移除配件、保护壳、贴膜类商品

- 移除单只耳机、充电盒单独售卖的商品

- 移除二手商品（二手）

- 移除价格异常低廉的商品（如 iPhone 售价 ¥1000）

1. 按价格升序排序
2. 返回前 5–8 条结果，包含：

- 不同店铺及其价格

- 是否有补贴（政府补贴、百亿补贴）

- 官方旗舰店参考信息

情况二：仅提供通用产品类别

当用户询问通用类别但未指定具体型号（如：“iPhone”、“MacBook Air”、“蓝牙耳机”、“机械键盘”）时：

1. 使用宽泛关键词进行搜索
2. 分析所有结果以识别：

- 可用的不同型号/版本

- 不同规格（存储容量、颜色、尺寸等）

- 各版本间的价格分布

1. 按规格分类：

- 将相似商品归为一组

- 识别入门级、中端、高端版本

1. 提供综合分析报告：

- 各规格层级的价格范围

- 流行或推荐的型号

- 基于使用场景的购买建议

MCP 配置

服务器地址： ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}

传输方式： streamableHttp

服务器名称： taobao-native

MCP 调用流程

MCP 服务器使用可流式传输的 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"
      }
    }
  }'

1. 从响应头中提取会话 ID：mcp-session-id: <uuid>

1. 调用工具时，在请求头中携带会话 ID：mcp-session-id: <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=<itemId>
• 淘宝：https://item.taobao.com/item.htm?id=<itemId>

连接健康检测

MCP 服务可能出现断开。需检测并处理连接问题：

连接错误特征

连接失败指示：

• 出现 Connection failed 或 Connection refused 错误
• 超时错误（10 秒以上无响应）
• initialize 响应中缺少 mcp-session-id 头部
• 返回空或格式错误的 JSON 响应
• HTTP 状态码：500、502、503、504

会话过期指示：

• 错误信息：“未提供有效的会话ID”
• 错误码：-32000 且消息与会话相关
• 之前正常工作的会话突然返回认证错误

连接恢复步骤

当连接失败时：

1. 首次失败：

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

• 使用新会话重试 initialize

- 成功则继续操作

1. 第二次失败（持续性）：

   ❌ MCP 服务暂时不可用

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

   建议操作：
   1. 检查淘宝桌面客户端是否已打开
   2. 确认电脑网络连接正常
   3. 重启淘宝桌面客户端后重试

   当前配置的 MCP 地址: ${TAOBAO_MCP_URL:-http://127.0.0.1:3654/mcp}

• 停止继续调用 MCP 接口

- 向用户清晰说明问题

- 提供可操作的排查建议

1. 操作过程中会话过期：

- 检测到“无效会话”错误

- 自动使用新会话重新初始化

- 重试失败的操作一次

- 若仍失败，按连接失败处理（步骤 2）

主动健康检查

在执行重大操作前（如查看包含大量商品的购物车），可选择性进行连接验证：

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

错误处理

若 MCP 服务器无法访问或返回错误：

1. 识别错误类型（连接错误、会话错误、操作错误）
2. 连接错误：按照上述连接恢复步骤处理
3. 会话错误：尝试重新初始化一次，随后按恢复步骤处理
4. 操作错误：向用户说明具体错误，并提供替代方案
5. 绝不生成虚假商品数据或假装操作成功

安全提醒

• 绝不进入支付或结算流程
• 绝不点击“立即购买”（Buy Now）按钮，若该操作涉及付款
• 绝不代表用户确认订单
• 购物车操作（添加、查看）是安全的，支付是绝对红线

示例交互

用户： "iPhone 16 Pro Max 256GB 多少钱"

→ 提供具体型号 → 按精确关键词搜索 → 过滤配件 → 返回前 5-8 个价格

用户： "MacBook Air 推荐"

→ 仅提供类别 → 广泛搜索 → 分析所有 M3/M4/M5 版本 → 提供各配置的价格区间 → 给出购买建议

用户： "看看我的购物车"

→ 使用 navigate 切换至购物车 → 使用 read_page_content 读取内容 → 展示商品列表