taobao-search

Taobao Search Tool

通过淘宝 Deep Link 直达搜索页面，浏览商品并为用户提供购物建议。

🎯 When to Use

Use this skill when user asks about:

✅ 商品搜索 - "帮我找阿迪达斯今年新款男鞋" ✅ 品牌查找 - "搜一下耐克跑步鞋" ✅ 比价购物 - "淘宝上看看有什么好的蓝牙耳机" ✅ 新品浏览 - "今年有什么新款连衣裙" ✅ 特定条件搜索 - "200元以内的双肩包"

📋 Workflow

标准搜索流程

1. 解析用户意图，提取搜索关键词
2. 通过 device(action="open", uri="taobao://...") 跳转淘宝搜索页
3. 等待淘宝 App 加载搜索结果：device(action="act", kind="wait", timeMs=1500)
4. 拉取页面 UI 树：device(action="snapshot", format="compact")
   —— 这是商品名/价格/店铺/销量等文字信息的**唯一来源**
5. 从 snapshot 返回的 text 节点里逐条提取商品信息（详见 Step 3）
6. 基于提取到的具体商品信息回答用户（200字以内，必须包含真实数字和细节）

⚠️ 绝对禁止: 不要用 read_file 读截图 PNG（如 read_file("/sdcard/.xomniclaw/workspace/screenshots/*.png")）。PNG 是二进制，read_file 会以 UTF-8 解码出大量乱码并撑爆上下文窗口，整个 session 会被 context window exceeds limit 终止。只用 device(action="snapshot") 读页面文字。

🔗 Deep Link 构造规则

淘宝搜索 Deep Link 格式：

taobao://s.taobao.com/search?q={关键词}

关键词用 + 连接多个搜索词，示例：

用户意图	搜索关键词	Deep Link
阿迪达斯今年新款男鞋	阿迪达斯+2026+新款+男鞋	taobao://s.taobao.com/search?q=阿迪达斯+2026+新款+男鞋
耐克跑步鞋	耐克+跑步鞋	taobao://s.taobao.com/search?q=耐克+跑步鞋
200元蓝牙耳机	蓝牙耳机	taobao://s.taobao.com/search?q=蓝牙耳机

🚀 X-OmniClaw Implementation

Tool: device (DeviceTool — 统一设备控制工具)

⚠️ 重要: 不要使用 shell am start 命令跳转 Deep Link（会因 SecurityException 权限拒绝），必须使用 device(action="open", uri="...") 通过 X-OmniClaw 应用上下文发起 ACTION_VIEW Intent。

Step 1: Deep Link 跳转淘宝搜索页

// 构造搜索关键词
val keyword = "阿迪达斯+2026+新款+男鞋"
val deepLink = "taobao://s.taobao.com/search?q=$keyword"

// 通过 device tool 的 open action + uri 参数跳转
device(action = "open", uri = deepLink)

Step 2: 等待页面加载并拉取 UI 树

// 等待淘宝 App 启动并加载搜索结果
device(action = "act", kind = "wait", timeMs = 1500)

// 拉取页面 UI 树(含所有可见文本节点) —— 商品信息的唯一来源
device(action = "snapshot", format = "compact")

不要在这一步用 screenshot：screenshot 只用于内部 grounding（定位点击坐标），不会把图像内容送给你。snapshot 才会把页面上每个可见文本节点（含商品名、价格、店铺名）以纯文本方式返回给你。