- name
- taobao-shopping
- description
- 淘宝购物助手 — 搜索商品、查看商品详情、加入购物车、查看购物车（支持价格变动提示）、查看评价。当用户提到淘宝购物、查找商品、查看购物车、比价、加入购物车，或需要从淘宝获取商品信息时使用此 skill。支持按销量/价格排序搜索、商品规格选择、批量操作。
- version
- 1.0.0
- author
- He2y
- tags
- [taobao, shopping, cart, ecommerce, china, search]
淘宝购物助手 (taobao-shopping)
基于 OpenCLI 的淘宝购物全流程自动化 skill，支持搜索、详情、加购、购物车管理、评价查询。
前置要求
- Chrome 浏览器已安装且登录淘宝/天猫账号
- OpenCLI 已安装：
npm install -g @jackwener/opencli - OpenCLI Browser Bridge 扩展已加载（在 Chrome 扩展管理页加载
extension/目录为未打包扩展）
重要：首次使用前，请确保 Chrome 已登录淘宝 (www.taobao.com)，因为所有命令依赖 Cookie 认证。
快速开始
# 搜索商品
opencli taobao search "iPhone 17 Pro Max" --limit 10
# 查看商品详情
opencli taobao detail <商品ID>
# 加入购物车
opencli taobao add-cart <商品ID>
# 查看购物车（含价格变动）
opencli taobao cart
# 查看商品评价
opencli taobao reviews <商品ID> --limit 10命令详解
1. search — 淘宝商品搜索
opencli taobao search <关键词> [选项]参数：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
query | 位置参数 | 必填 | 搜索关键词 |
--sort | 选择 | default | 排序方式：default(综合)、sale(销量)、price(价格) |
--limit | 整数 | 10 | 返回结果数量（最大 40） |
输出格式：
rank | title | price | sales | shop | location | item_id | url示例：
# 搜索 iPhone，按销量排序
opencli taobao search "iPhone 17 Pro Max" --sort sale --limit 20
# 搜索T恤，按价格升序
opencli taobao search "T恤 男" --sort price --limit 102. detail — 淘宝商品详情
opencli taobao detail <商品ID> [选项]参数：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
id | 位置参数 | 必填 | 商品 ID（从搜索结果的 item_id 字段获取） |
输出格式：
field | value包含字段：商品名称、价格、销量、评价数、店铺评分、店铺名称、发货地、可选规格、ID、链接
示例：
opencli taobao detail 8275638501783. add-cart — 加入购物车
opencli taobao add-cart <商品ID> [选项]参数：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
id | 位置参数 | 必填 | 商品 ID |
--spec | 字符串 | 无 | 规格关键词（如 "红色 XL"，多个用空格分隔，模糊匹配） |
--dry-run | 布尔 | false | 仅预览，不实际加入购物车 |
输出格式：
status | title | price | selected_spec | item_id示例：
# 加入购物车（自动选择第一个可用规格）
opencli taobao add-cart 827563850178
# 指定规格加入购物车
opencli taobao add-cart 827563850178 --spec "银色 512G"
# 预览模式（不实际加入）
opencli taobao add-cart 827563850178 --spec "银色 512G" --dry-run4. cart — 查看购物车
opencli taobao cart [选项]参数：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
--limit | 整数 | 20 | 返回商品数量（最大 50） |
输出格式：
index | title | price | spec | shop💡 特色功能：价格变动提示
- 购物车返回数据包含现价和原价
- 如果商品有降价，显示格式如：
￥153 (原价￥237, 省84.00) - 可以快速识别降价商品
示例：
# 查看购物车前20件商品
opencli taobao cart
# 查看更多商品
opencli taobao cart --limit 505. reviews — 查看商品评价
opencli taobao reviews <商品ID> [选项]参数：
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
id | 位置参数 | 必填 | 商品 ID |
--limit | 整数 | 10 | 返回评价数量（最大 20） |
输出格式：
rank | user | content | date | spec示例：
opencli taobao reviews 827563850178 --limit 20输出格式选项
所有命令支持 --format / -f 参数：
| 格式 | 说明 |
|---|---|
table | 表格形式（默认） |
json | JSON 数组 |
yaml | YAML 格式 |
md | Markdown 表格 |
csv | CSV 格式 |
示例：
opencli taobao search "iPhone" -f json
opencli taobao cart -f csv常见问题
Q: 命令执行缓慢怎么办？
A: 首次执行需要建立浏览器会话（约 7 秒），后续执行会复用会话。可以使用 --format json 加速输出解析。
Q: 提示 "auth-required" 怎么办？
A: 需要在 Chrome 中登录淘宝。打开 www.taobao.com，手动登录后重试。
Q: 如何获取商品 ID？
A: 使用 search 命令，结果中的 item_id 字段即为商品 ID。也可以从商品链接中提取：https://item.taobao.com/item.htm?id=XXXXXXXX
Q: 购物车显示的价格是旧的吗？
A: 购物车数据会实时获取，如果商品有降价，会同时显示原价和现价，方便识别。
依赖说明
此 skill 依赖 OpenCLI 项目中的淘宝适配器模块（@jackwener/opencli）。适配器源代码位于：
- 搜索/详情/评价：基于浏览器 DOM 解析
- 购物车：基于购物车页面文本解析
- 加入购物车：基于页面 UI 自动化
所有适配器均使用 Cookie 认证策略，无需额外 API Key。
更新日志
v1.0.0 (2026-04-14)
- 初始版本
- 支持 search、detail、add-cart、cart、reviews 五个核心命令
- 支持价格变动提示
- 支持多种输出格式