核心用法
taobao-native 是淘宝官方桌面客户端的命令行工具,提供完整的电商自动化能力:
导航与浏览:navigate/navigate_to_url 进入目标页面,read_page_content 提取可见文本,scan_page_elements 扫描可交互元素索引,scroll_page 滚动加载更多内容。
商品操作:search_products 文字搜索(需加 -o 防截断),image_search 以图搜图;加购前必须调用 `get_product_skus` 获取规格维度,智能选择后通过 add_to_cart 完成加购;get_product_skus 返回 SKU 图片需用 Markdown 展示辅助用户决策。
价格获取(关键):搜索结果价格≠真实SKU价格。必须进入商详页 → 用 index(禁止用text)精确点击目标SKU → sleep 3秒 等待异步刷新 → 再读取价格。这是比价、价格排序的唯一可靠方法。
旺旺聊天:触发关键词"问问商家"/"旺旺"/"咨询"时必须用 open_chat(复合工具),已打开聊天后用 send_chat_message 继续对话,支持图文混发(先发图后发文字)。
订单与评价:submit_product_rating 是唯一评价工具,禁止用其他工具操作评价表单;多商品评价需差异化文案;首次评价必填三项1-5星评分。
显著优点
- 官方原生能力:直接调用淘宝桌面客户端,绕过网页反爬,稳定性高于浏览器自动化
- 完整链路覆盖:从搜索、比价、SKU选择、加购到旺旺沟通、评价提交,闭环电商操作
- 智能SKU处理:
get_product_skus返回结构化规格数据,支持图片辅助决策,降低用户选择负担 - 防截断设计:
-o <文件>参数确保大结果完整保存,避免 stdout 截断导致数据丢失
潜在缺点与局限性
- 平台绑定:仅支持淘宝/天猫生态,无法跨平台比价(京东、拼多多等)
- 桌面客户端依赖:需预装淘宝桌面版,Windows/macOS 环境配置差异大,首次使用可能需处理路径/环境变量问题
- SKU点击脆弱性:必须用
index精确点击,页面结构变化易导致索引错位;text匹配被明令禁止 - 异步等待硬编码:sleep 3秒为经验值,网络波动时可能不足或过度等待
- 中文JSON转义风险:Windows
.cmd处理含【】等字符的JSON易出错,需优先用Bash或--request文件传参
适合人群
- 高频淘宝用户:需要批量比价、管理多规格商品加购的理性消费者
- 电商运营/客服:自动化处理旺旺咨询、批量评价、订单催发货等重复操作
- 价格敏感型买家:严格遵循SKU价格获取规则,避免"低价引流"套路
常规风险
- 价格误导风险:若未遵守"进详情页+sleep 3秒+index点击"规则,获取的可能是起步价或错误价格,导致比价失真
- 操作失败连锁反应:SKU选择错误可能加购错误规格,旺旺聊天未用指定工具可能导致消息发送失败
- 环境配置风险:Windows 下
%APPDATA%路径、macOS 下软链路径若配置不当会导致命令不可识别,需按文档逐级降级处理或重启Agent