技能介绍

问题

在已经登录的淘宝页面里做商品调研时，手动筛选、切换排序、逐条复制标题和价格会把流程切得很碎，也让同一会话里的结果很难复用。这个技能用于在已登录淘宝会话中按关键词和排序偏好发起商品搜索，并把返回结果整理成可直接引用的清单。

工作方式

调用入口是随附客户端 scripts/taobao_api.py，它会统一处理参数校验、凭证保护、费用告知和完成后的引导：

先确定关键词；关键词不可为空，未指定排序时使用综合排序。
调用前明确告知：公测期间限时免费，本次调用不扣费；告知后即可执行，无需等待确认。
客户端使用已保存的凭证；若缺少 AppID 和 SecureKey，在对话中向用户索要，或引导用户前往巴娜技能中心注册生成。凭证不要求配置环境变量，也不要求用户进入终端。
服务端通过全局单任务队列操作同一个已登录 Chrome 会话，限制为 6 次搜索 / 60 秒；客户端默认等待 180 秒，短时间内无响应时不提前终止、不并行请求、不重复调用。
返回后列出商品标题、页面价格、销量或付款人数、店铺和链接；items 字段为空时不推断数据。

排序与返回

排序参数会映射到淘宝页面的排序口径：default 对应综合排序，sale 对应按销量，price_asc 对应价格升序，price_desc 对应价格降序，total 对应总价，popular 对应人气；API 也接受“销量”“低价”“高价”“总价”等中文别名。响应中的 totalItems 只是本次返回条数，不能当作淘宝全部结果数。

适用边界

适合在用户已登录、页面可正常加载且未触发验证码的场景下使用。如果 Chrome、淘宝页面、登录状态或页面提取异常，会出现 401、502、503 等失败，或返回 captchaBlocked: true，此时不要臆测商品数据，也不要无意义重试。批量搜索必须串行执行，调用前先告知总调用次数；仍需避免为验证而反复触发请求。