淘宝关键词搜索

要解决的问题

把「关键词 + 筛选条件」变成结构化商品列表，听起来简单，难点在于淘宝搜索结果没有稳定的公开 API：结果卡片会随登录态、筛选、排序和分页变化，页面结构也可能调整。手工复制商品标题、价格、店铺等信息既重复又容易出错，跨页浏览时尤其低效。

技能如何工作

该技能在用户自己的浏览器中运行，能力边界等同于用户手动浏览淘宝搜索页：

• 前置条件：用户已打开 https://s.taobao.com/search 并登录淘宝；未登录时会先引导登录，拒绝或无法登录则终止执行。
• 核心流程：导航到形如 https://s.taobao.com/search?q={keyword}&page={page}&ie=utf8 的结果页，等待页面稳定后，通过 scripts/ 下的 Python 脚本提取商品卡片。
• 参数支持：q 为编码后的关键词，page 从 1 开始，约每页 47 条；sort 支持默认、sale-desc、price-asc、price-desc；tab=mall 可只看天猫结果；startPrice / endPrice 按元过滤价格区间。
• 返回字段：常见字段包括 itemId、title、price、shop、image、sales；同时标注 priceYuan 为页面展示价，并用 priceDesc 提示券后价、补贴价等价格类型。
• 分页判断：按 URL 中的 page 递增抓取；当结果数为 1 且 itemId 非空比例为 100% 时视为结束。

适用边界与注意点

• 必须保持淘宝登录态，否则会被重定向到登录页。
• 展示价可能是券后价或补贴价，而 startPrice / endPrice 过滤的是券前价，边界附近可能出现展示价超出范围。
• 广告商品会出现在不可预测的位置，其 itemUrl 指向 click.simba.taobao.com。
• 搜索卡片很少展示评分，rating 为 null 是预期情况。
• 批量抓取时建议串行执行、控制间隔，并用多个浏览器会话分散关键词；正式批跑前先用 1–2 个关键词验证脚本，失败后可按已保存结果断点续跑。