什么是 淘宝图片搜索？

淘宝图片搜索技能是为 Openclaw Skills 设计的强大自动化工具，允许用户在淘宝上进行视觉搜索。它通过上传产品照片简化了寻找相同或相似物品的过程，并能自动导航至产品页面将商品加入购物车。该技能架起了视觉发现与电子商务行动之间的桥梁。

该工具采用可靠性优先的方法构建，优先使用自动化的 Playwright 脚本以提高速度，同时在网站结构变化或需要人工干预时保持对手动浏览器工具的稳健回退。它是 Openclaw Skills 生态系统中任何自动化购物或产品研究工作流的重要组成部分。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lazygunner/taobao-image-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

淘宝图片搜索 应用场景

• 使用截图或本地图像文件搜索特定的衣服或电子产品。
• 自动比较不同淘宝卖家对同一商品的售价。
• 无需手动导航即可将找到的商品添加到购物车。
• 根据参考图像研究产品类别和相似风格。

1. 该技能首先检查 verification-artifacts/taobao-storage-state.json 中是否存在现有会话，以确保用户已登录。
2. 它通过将提供的图像上传到淘宝视觉搜索引擎来触发搜索。
3. 自动化逻辑分析搜索结果，并根据相似度选择最相关的候选对象。
4. 它导航到商品详情页并处理强制性的规格选择。
5. 该技能执行加购操作，并通过 DOM 元素检测验证是否成功。
6. 在 artifacts 文件夹中生成详细报告（包括截图和日志）供用户查看。

淘宝图片搜索 配置指南

要初始化会话，请运行 Cookie 保存脚本并在提示时手动登录：

node save-taobao-cookie.js

保存会话后，您可以通过提供图像的绝对路径来执行图片搜索：

node verify-taobao-runner.js --image /path/to/image.png --delay-ms 2000

淘宝图片搜索 数据架构与分类体系

name: taobao-image-search
description: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（save-taobao-cookie.js、verify-taobao-runner.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。

淘宝图片搜索技能

执行策略

• 优先执行脚本：save-taobao-cookie.js、verify-taobao-runner.js。
• 脚本失败或页面结构变化时，回退 browser 工具。
• 默认不下单、不支付；仅搜索与加购。

输入要求

• 必需：本地图片路径或会话中的图片。
• 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。

若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。

主流程（脚本优先）

1. 准备登录态

先检查是否已存在登录态文件：

ls -la verification-artifacts/taobao-storage-state.json

若不存在或登录态过期，执行：

node save-taobao-cookie.js

执行后让用户在打开的淘宝页面完成登录，再在终端回车保存登录态。

2. 执行完整链路

node verify-taobao-runner.js --image /absolute/path/to/image.png

该脚本覆盖：

1. 打开淘宝首页。
2. 验证登录状态（未登录即中止并提示先登录）。
3. 打开图搜弹窗并上传图片。
4. 点击弹窗内搜索按钮（优先 #image-search-upload-button.upload-button.upload-button-active）。
5. 采样候选商品并进入详情页。
6. 点击加入购物车并检测成功提示。

脚本参数约定：

• --image, -i：图片路径（默认 test.png）。
• --headless / --headed：本地调试运行模式。
• --delay-ms：为关键步骤追加等待时长（默认 2000，慢网可增大到 4000-8000）。
• --engine：当前本地脚本仅支持 playwright。
• browser 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。

3. 读取验证结果

脚本运行后读取：

• verification-artifacts/result.json
• verification-artifacts/run-log.txt
• verification-artifacts/*.png（流程截图）

关键判定字段：

• success：流程是否成功执行。
• loginCheck.isLoggedIn：是否登录。
• addToCart.success：是否加购成功。
• addToCart.reason：失败原因（如有）。

回退流程（browser 工具）

仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。

1. 打开淘宝并校验登录

• 打开 https://www.taobao.com。
• 校验昵称元素 .site-nav-login-info-nick 或 .member-nick-info 是否可见。
• 若未登录，提示用户先登录，再继续。

2. 上传图片并搜索

• 点击相机/搜同款入口打开上传弹窗。
• 上传图片。
• 只点击弹窗内搜索按钮，优先：
  • #image-search-upload-button.upload-button.upload-button-active
  • .image-search-context-wrapper-active #image-search-upload-button.upload-button.upload-button-active
  • .image-search-context-wrapper-active .upload-button.upload-button-active[data-spm='image_search_button']
• 上述失效时兜底：
  • .image-search-context-wrapper-active .upload-button:has-text('搜索')

3. 选品与加购

• 分析候选商品并优先选择最相似商品。
• 进入详情页点击“加入购物车”。
• 若强制规格选择，先选默认规格再加购。
• 用页面成功提示确认结果。

失败回退建议

• 登录失败：重新运行 node save-taobao-cookie.js。
• 上传失败：重新打开图搜弹窗再上传。
• 搜索按钮定位失败：优先使用上述弹窗按钮精确选择器。
• 加购失败：检查规格选择、风控拦截或登录失效。

安全边界

• 仅操作用户明确指示的商品。
• 不执行“立即购买”“提交订单”“支付”动作。
• 规格、数量、店铺偏好不明确时先确认。