{"id":"599f5939-08aa-4275-a8cd-17ae8848adee","entityType":"agent","slug":"clawhub-lazygunner-taobao-image-search","name":"Taobao Image Search","canonicalUrl":"https://www.xpersona.co/agent/clawhub-lazygunner-taobao-image-search","canonicalPath":"/agent/clawhub-lazygunner-taobao-image-search","generatedAt":"2026-10-09T23:24:46.262Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":null},"description":"使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17cnega3xt5varx9x82dsj2e1846k2a:taobao-image-search","sourceUrl":"https://clawhub.ai/lazygunner/taobao-image-search","homepage":"https://clawhub.ai/lazygunner/skills/taobao-image-search","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/lazygunner/taobao-image-search","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/lazygunner/skills/taobao-image-search","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":63,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Taobao Image Search technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":null},"stars":null,"forks":null,"downloads":3038,"packageName":null,"latestVersion":"1.1.3","tractionLabel":"3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T10:06:41.001Z","lastCrawledAt":"2026-10-09T10:06:41.001Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T10:06:41.001Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.3","createdAt":"2026-04-05T15:10:41.829Z","changelog":"No changes detected in this version (1.1.3). - No file changes between this and the previous version. - Functionality, usage, and documentation remain unchanged. - Safe to update with no impact on skill behavior.","fileCount":9,"zipByteSize":20243},{"version":"1.1.2","createdAt":"2026-04-05T10:09:02.527Z","changelog":"Summary: This update adds privacy and environment safety notices, along with installation guidance. - Added installation instructions for Playwright and Chromium in the skill metadata. - Updated the \"安全边界\" section to \"安全边界与隐私\"，详细说明了会话数据本地存储、敏感性及清理方式，提醒用户妥善保管登录凭据。 - 建议仅在受信个人设备或沙箱环境下运行技能，增强了用户隐私保护与环境安全提示。 - 其余流程与逻辑未发生调整。","fileCount":8,"zipByteSize":18835},{"version":"1.1.1","createdAt":"2026-04-05T09:49:10.945Z","changelog":"- Removed the file save-taobao-cookie.js. - No changes to functionality or documentation.","fileCount":8,"zipByteSize":17854},{"version":"1.1.0","createdAt":"2026-04-05T09:13:06.264Z","changelog":"update login detection","fileCount":9,"zipByteSize":18927},{"version":"1.0.2","createdAt":"2026-02-21T02:33:19.066Z","changelog":"No changes detected in this version. - No file updates or modifications were made. - Functionality, usage, and documentation remain unchanged.","fileCount":6,"zipByteSize":14307},{"version":"1.0.1","createdAt":"2026-02-20T16:33:23.262Z","changelog":"fix bugs","fileCount":6,"zipByteSize":13895},{"version":"1.0.0","createdAt":"2026-02-20T15:46:49.235Z","changelog":"Taobao Image Search Skill v1.0.0 淘宝图像搜索 - Enables searching for similar items, comparing, and adding items to cart on Taobao 淘宝 using images. - Prioritizes local script automation; falls back to browser tool if scripts fail or site changes. - Ensures user login is valid before proceeding. - Only searches or adds to cart; ordering and payment are not performed. - Asks users for missing key details (e.g., budget, purchase preference) if required.","fileCount":6,"zipByteSize":12925}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17cnega3xt5varx9x82dsj2e1846k2a:taobao-image-search","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17cnega3xt5varx9x82dsj2e1846k2a:taobao-image-search` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/lazygunner/taobao-image-search before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T23:24:46.261Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lazygunner-taobao-image-search/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":null},"readme":"Skill: Taobao Image Search\n\nOwner: lazygunner\n\nSummary: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n\nTags: latest:1.1.3\n\nVersion history:\n\nv1.1.3 | 2026-04-05T15:10:41.829Z | user\n\nNo changes detected in this version (1.1.3).\n\n- No file changes between this and the previous version.\n- Functionality, usage, and documentation remain unchanged.\n- Safe to update with no impact on skill behavior.\n\nv1.1.2 | 2026-04-05T10:09:02.527Z | user\n\nSummary: This update adds privacy and environment safety notices, along with installation guidance.\n- Added installation instructions for Playwright and Chromium in the skill metadata.\n- Updated the \"安全边界\" section to \"安全边界与隐私\"，详细说明了会话数据本地存储、敏感性及清理方式，提醒用户妥善保管登录凭据。\n- 建议仅在受信个人设备或沙箱环境下运行技能，增强了用户隐私保护与环境安全提示。\n- 其余流程与逻辑未发生调整。\n\nv1.1.1 | 2026-04-05T09:49:10.945Z | user\n\n- Removed the file save-taobao-cookie.js.\n- No changes to functionality or documentation.\n\nv1.1.0 | 2026-04-05T09:13:06.264Z | user\n\nupdate login detection\n\nv1.0.2 | 2026-02-21T02:33:19.066Z | user\n\nNo changes detected in this version.\n\n- No file updates or modifications were made.\n- Functionality, usage, and documentation remain unchanged.\n\nv1.0.1 | 2026-02-20T16:33:23.262Z | user\n\nfix bugs\n\nv1.0.0 | 2026-02-20T15:46:49.235Z | user\n\nTaobao Image Search Skill v1.0.0\n淘宝图像搜索\n\n- Enables searching for similar items, comparing, and adding items to cart on Taobao 淘宝 using images.\n- Prioritizes local script automation; falls back to browser tool if scripts fail or site changes.\n- Ensures user login is valid before proceeding.\n- Only searches or adds to cart; ordering and payment are not performed.\n- Asks users for missing key details (e.g., budget, purchase preference) if required.\n\nArchive index:\n\nArchive v1.1.3: 9 files, 20243 bytes\n\nFiles: auto-login-taobao.js (4978b), README_zh.md (3147b), README.md (3418b), run-taobao-task.js (1515b), skill-card.md (2644b), SKILL.md (3870b), verify-taobao-runner.js (28103b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.1.3:SKILL.md\n\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\ninstall:\n  - npm install playwright\n  - npx playwright install chromium\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`run-taobao-task.js`。\n- 脚本失败、登录超时或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 执行完整链路（含自动登录）\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/image.png --headed\n```\n\n该脚本覆盖：\n\n1. **自动登录校验**：若未登录，弹出窗口引导用户登录，成功后自动续行。\n2. **图搜上传**：打开淘宝首页并上传图片。\n3. **按钮定位**：点击弹窗内搜索按钮。\n4. **选品采样**：采样候选商品并进入详情页。\n5. **自动加购**：点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式（默认 `--headed`）。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `5000`，慢网可增大到 `8000-12000`）。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 2. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n\n## 失败回退建议\n\n- **登录超时**：重新运行 `node run-taobao-task.js --headed`。\n- **上传失败**：重新打开图搜弹窗再上传。\n- **搜索按钮定位失败**：优先使用弹窗按钮精确选择器，或在 browser 工具中手动点击。\n- **加购失败**：检查规格选择、风控拦截或登录失效。\n\n## 安全边界与隐私\n\n- **会话持久化**：为实现自动化登录，本技能会将浏览器会话（Cookies 和 Storage State）保存至本地。\n  - 路径：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n  - **重要提示**：这些文件包含您的淘宝登录令牌，请务必将其视为**敏感凭据**，严禁上传或分享。\n  - 若需清除登录态，请手动删除上述目录及文件。\n- **操作受限**：仅操作用户明确指示的商品。\n- **支付保护**：不执行“立即购买”“提交订单”“支付”动作。\n- **环境建议**：建议在受信的个人机器或沙箱环境中运行。\n\nFile v1.1.3:README.md\n\n# Taobao (淘宝) Image Search Skill\n\nTaobao (淘宝) image search and add-to-cart skill with script-first execution and browser-fallback. Now featuring automated login handling.\n\n## Features\n\n- **Search by Image**: Find identical or similar products on Taobao (淘宝) using an image.\n- **Automated Workflow**: Automatically enters product details and attempts to add to cart.\n- **Auto Login Detection**: Automatically checks for login status. if not logged in, it opens a login window and waits for completion before resuming the task.\n- **Structured Results**: Produces detailed JSON results, execution logs, and screenshots for verification.\n\n## Quick Start\n\n### 1. Installation\n\n1. Clone or copy these scripts to your environment.\n2. Install Playwright and browser dependencies:\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. Prepare Test Image\n\nThe project uses `test.png` by default. You can also provide any local image path during execution:\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. Run with Automatic Login\n\nYou no longer need to run a separate cookie-saving script. Simply run the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**How it works:**\n1. The script checks if you are logged into Taobao (淘宝).\n2. If **not logged in**, a browser window will pop up.\n3. Complete the login in that window.\n4. The script **automatically detects** your success and **resumes the search task** immediately.\n\n### 4. Advanced Configuration\n\nYou can pass arguments directly to the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\nAvailable arguments:\n- `--image, -i`: Path to the image (default: `test.png`).\n- `--headless` / `--headed`: Running mode (default: `--headed`).\n- `--out-dir`: Output directory (default: `verification-artifacts`).\n- `--delay-ms`: Additional wait time for slow networks (default: `5000`).\n\n## Output Artifacts\n\n- `verification-artifacts/result.json`: Structured results.\n- `verification-artifacts/run-log.txt`: Detailed execution logs.\n- `verification-artifacts/*.png`: Screenshots of key steps.\n\nKey Result Fields:\n- `success`: Whether the overall flow succeeded.\n- `loginCheck.isLoggedIn`: Login status.\n- `addToCart.success`: Whether the \"Add to Cart\" confirmation was detected.\n\n## Project Structure\n\n- `SKILL.md`: Instructions for OpenClaw/Codex (Script-first).\n- `run-taobao-task.js`: The main orchestrator with auto-login support.\n- `auto-login-taobao.js`: Background script for login monitoring.\n- `verify-taobao-runner.js`: The underlying automation script.\n\n## Security & Privacy Note\n\n> [!CAUTION]\n> **This skill persists browser session tokens locally.**\n> - Storage locations: `verification-artifacts/taobao-storage-state.json` and `.pw-user-data-taobao/`.\n> - These files contain active session cookies for Taobao. **Do not share or upload them.**\n> - Use the skill on trusted machines only.\n> - To completely log out and remove tokens, delete these directories manually.\n\n## Troubleshooting\n\n- **Login Timeout**: If you don't log in within 10 minutes, the task will stop.\n- **Selector Changes**: If Taobao (淘宝) changes its page structure, refer to the browser fallback instructions in `SKILL.md`.\n- **Add to Cart Failure**: Usually caused by SKU selection requirements, risk control, or session expiration.\n\nFile v1.1.3:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.1.3\",\n  \"publishedAt\": 1775401841829\n}\n\nFile v1.1.3:README_zh.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。现已支持自动登录检测与任务自动续行。\n\n## 功能\n\n- **以图搜同款**: 基于图片在淘宝搜索同款/相似商品\n- **自动化流程**: 自动进入候选商品详情页并尝试加入购物车\n- **自动登录检测**: 自动校验登录状态。若未登录，会弹出登录窗口并等待登录后再自动继续执行任务。\n- **结构化结果**: 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 安装与环境\n\n1. 克隆或复制这些脚本到您的本地环境。\n2. 安装 Playwright 及其浏览器依赖：\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n## 安全与隐私提醒\n\n> [!CAUTION]\n> **本技能会在本地持久化浏览器会话令牌。**\n> - 存储位置：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n> - 这些文件包含您的淘宝登录 Cookies。**严禁分享或上传这些文件。**\n> - 请仅在受信的个人机器上使用本技能。\n> - 若需彻底注销并清除令牌，请手动删除上述目录。\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 执行完整链路（支持自动登录）\n\n你不再需要手动运行 `save-taobao-cookie.js`。直接运行主入口即可：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**执行逻辑：**\n1. 脚本会检查淘宝登录状态。\n2. 若 **未登录**，会自动打开有界面浏览器窗口。\n3. 请在窗口内完成登录。\n4. 脚本 **自动检测** 登录成功后，会 **立即续行** 原有的搜索任务。\n\n### 4. 进阶参数\n\n可以直接通过主入口传递参数给底层脚本：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\n可选参数：\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--delay-ms`：为关键等待步骤增加额外延迟（默认 `5000`）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：详细执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n\n## 目录结构\n\n- `SKILL.md`：OpenClaw/Codex 技能说明（脚本优先）\n- `run-taobao-task.js`：支持自动登录的主入口脚本\n- `auto-login-taobao.js`：自动登录监测脚本\n- `verify-taobao-runner.js`：底层自动化验证脚本\n\n## 常见问题\n\n- **登录超时**：10 分钟内未完成登录，脚本将中止\n- **页面变更**：若淘宝结构调整，请参考 `SKILL.md` 的 browser 工具回退流程手动验证\n- **加购失败**：通常是规格选择、风控或登录态过期导致\n\nFile v1.1.3:skill-card.md\n\n## Description:\n\nSearches Taobao by product image, compares candidate listings, and can add a selected similar item to the user's cart through a Playwright-backed workflow with browser fallback.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lazygunner](https://clawhub.ai/user/lazygunner)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nAgents use this skill when a user provides a product image and asks to find identical or similar Taobao items, compare candidates, or add a chosen item to cart. It is intended for shopping assistance workflows that require user-provided images and an authenticated Taobao session.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores reusable Taobao login sessions locally, including cookies and storage state that should be treated as account credentials.\n\nMitigation: Run only on a trusted personal machine or sandbox, avoid uploading or sharing verification-artifacts/taobao-storage-state.json and .pw-user-data-taobao/, and delete those files when finished.\n\nRisk: The workflow can automatically add an item to a live Taobao shopping cart without a strong confirmation gate.\n\nMitigation: Use the full script only when the user explicitly wants cart modification, and prefer search-only or browser fallback review when the item choice is uncertain.\n\nRisk: The security verdict is suspicious because the skill combines account session persistence with live shopping-cart automation.\n\nMitigation: Review before installing with a real Taobao account, pin Playwright with a lockfile in sensitive environments, and inspect generated artifacts after each run.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/lazygunner/skills/taobao-image-search)\n- [Publisher Profile](https://clawhub.ai/user/lazygunner)\n- [Taobao](https://www.taobao.com)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell commands, structured JSON result files, execution logs, and screenshots]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write verification artifacts including result.json, run-log.txt, screenshots, browser storage state, and a persistent Playwright user data directory.]\n\n## Skill Version(s):\n\n1.1.3 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.1.2: 8 files, 18835 bytes\n\nFiles: auto-login-taobao.js (4978b), README_zh.md (3147b), README.md (3418b), run-taobao-task.js (1515b), SKILL.md (3870b), verify-taobao-runner.js (28103b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.1.2:SKILL.md\n\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\ninstall:\n  - npm install playwright\n  - npx playwright install chromium\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`run-taobao-task.js`。\n- 脚本失败、登录超时或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 执行完整链路（含自动登录）\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/image.png --headed\n```\n\n该脚本覆盖：\n\n1. **自动登录校验**：若未登录，弹出窗口引导用户登录，成功后自动续行。\n2. **图搜上传**：打开淘宝首页并上传图片。\n3. **按钮定位**：点击弹窗内搜索按钮。\n4. **选品采样**：采样候选商品并进入详情页。\n5. **自动加购**：点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式（默认 `--headed`）。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `5000`，慢网可增大到 `8000-12000`）。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 2. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n\n## 失败回退建议\n\n- **登录超时**：重新运行 `node run-taobao-task.js --headed`。\n- **上传失败**：重新打开图搜弹窗再上传。\n- **搜索按钮定位失败**：优先使用弹窗按钮精确选择器，或在 browser 工具中手动点击。\n- **加购失败**：检查规格选择、风控拦截或登录失效。\n\n## 安全边界与隐私\n\n- **会话持久化**：为实现自动化登录，本技能会将浏览器会话（Cookies 和 Storage State）保存至本地。\n  - 路径：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n  - **重要提示**：这些文件包含您的淘宝登录令牌，请务必将其视为**敏感凭据**，严禁上传或分享。\n  - 若需清除登录态，请手动删除上述目录及文件。\n- **操作受限**：仅操作用户明确指示的商品。\n- **支付保护**：不执行“立即购买”“提交订单”“支付”动作。\n- **环境建议**：建议在受信的个人机器或沙箱环境中运行。\n\nFile v1.1.2:README.md\n\n# Taobao (淘宝) Image Search Skill\n\nTaobao (淘宝) image search and add-to-cart skill with script-first execution and browser-fallback. Now featuring automated login handling.\n\n## Features\n\n- **Search by Image**: Find identical or similar products on Taobao (淘宝) using an image.\n- **Automated Workflow**: Automatically enters product details and attempts to add to cart.\n- **Auto Login Detection**: Automatically checks for login status. if not logged in, it opens a login window and waits for completion before resuming the task.\n- **Structured Results**: Produces detailed JSON results, execution logs, and screenshots for verification.\n\n## Quick Start\n\n### 1. Installation\n\n1. Clone or copy these scripts to your environment.\n2. Install Playwright and browser dependencies:\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. Prepare Test Image\n\nThe project uses `test.png` by default. You can also provide any local image path during execution:\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. Run with Automatic Login\n\nYou no longer need to run a separate cookie-saving script. Simply run the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**How it works:**\n1. The script checks if you are logged into Taobao (淘宝).\n2. If **not logged in**, a browser window will pop up.\n3. Complete the login in that window.\n4. The script **automatically detects** your success and **resumes the search task** immediately.\n\n### 4. Advanced Configuration\n\nYou can pass arguments directly to the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\nAvailable arguments:\n- `--image, -i`: Path to the image (default: `test.png`).\n- `--headless` / `--headed`: Running mode (default: `--headed`).\n- `--out-dir`: Output directory (default: `verification-artifacts`).\n- `--delay-ms`: Additional wait time for slow networks (default: `5000`).\n\n## Output Artifacts\n\n- `verification-artifacts/result.json`: Structured results.\n- `verification-artifacts/run-log.txt`: Detailed execution logs.\n- `verification-artifacts/*.png`: Screenshots of key steps.\n\nKey Result Fields:\n- `success`: Whether the overall flow succeeded.\n- `loginCheck.isLoggedIn`: Login status.\n- `addToCart.success`: Whether the \"Add to Cart\" confirmation was detected.\n\n## Project Structure\n\n- `SKILL.md`: Instructions for OpenClaw/Codex (Script-first).\n- `run-taobao-task.js`: The main orchestrator with auto-login support.\n- `auto-login-taobao.js`: Background script for login monitoring.\n- `verify-taobao-runner.js`: The underlying automation script.\n\n## Security & Privacy Note\n\n> [!CAUTION]\n> **This skill persists browser session tokens locally.**\n> - Storage locations: `verification-artifacts/taobao-storage-state.json` and `.pw-user-data-taobao/`.\n> - These files contain active session cookies for Taobao. **Do not share or upload them.**\n> - Use the skill on trusted machines only.\n> - To completely log out and remove tokens, delete these directories manually.\n\n## Troubleshooting\n\n- **Login Timeout**: If you don't log in within 10 minutes, the task will stop.\n- **Selector Changes**: If Taobao (淘宝) changes its page structure, refer to the browser fallback instructions in `SKILL.md`.\n- **Add to Cart Failure**: Usually caused by SKU selection requirements, risk control, or session expiration.\n\nFile v1.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.1.2\",\n  \"publishedAt\": 1775383742527\n}\n\nFile v1.1.2:README_zh.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。现已支持自动登录检测与任务自动续行。\n\n## 功能\n\n- **以图搜同款**: 基于图片在淘宝搜索同款/相似商品\n- **自动化流程**: 自动进入候选商品详情页并尝试加入购物车\n- **自动登录检测**: 自动校验登录状态。若未登录，会弹出登录窗口并等待登录后再自动继续执行任务。\n- **结构化结果**: 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 安装与环境\n\n1. 克隆或复制这些脚本到您的本地环境。\n2. 安装 Playwright 及其浏览器依赖：\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n## 安全与隐私提醒\n\n> [!CAUTION]\n> **本技能会在本地持久化浏览器会话令牌。**\n> - 存储位置：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n> - 这些文件包含您的淘宝登录 Cookies。**严禁分享或上传这些文件。**\n> - 请仅在受信的个人机器上使用本技能。\n> - 若需彻底注销并清除令牌，请手动删除上述目录。\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 执行完整链路（支持自动登录）\n\n你不再需要手动运行 `save-taobao-cookie.js`。直接运行主入口即可：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**执行逻辑：**\n1. 脚本会检查淘宝登录状态。\n2. 若 **未登录**，会自动打开有界面浏览器窗口。\n3. 请在窗口内完成登录。\n4. 脚本 **自动检测** 登录成功后，会 **立即续行** 原有的搜索任务。\n\n### 4. 进阶参数\n\n可以直接通过主入口传递参数给底层脚本：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\n可选参数：\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--delay-ms`：为关键等待步骤增加额外延迟（默认 `5000`）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：详细执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n\n## 目录结构\n\n- `SKILL.md`：OpenClaw/Codex 技能说明（脚本优先）\n- `run-taobao-task.js`：支持自动登录的主入口脚本\n- `auto-login-taobao.js`：自动登录监测脚本\n- `verify-taobao-runner.js`：底层自动化验证脚本\n\n## 常见问题\n\n- **登录超时**：10 分钟内未完成登录，脚本将中止\n- **页面变更**：若淘宝结构调整，请参考 `SKILL.md` 的 browser 工具回退流程手动验证\n- **加购失败**：通常是规格选择、风控或登录态过期导致\n\nArchive v1.1.1: 8 files, 17854 bytes\n\nFiles: auto-login-taobao.js (4815b), README_zh.md (2621b), README.md (2915b), run-taobao-task.js (1515b), SKILL.md (3306b), verify-taobao-runner.js (27940b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.1.1:SKILL.md\n\n---\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`run-taobao-task.js`。\n- 脚本失败、登录超时或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 执行完整链路（含自动登录）\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/image.png --headed\n```\n\n该脚本覆盖：\n\n1. **自动登录校验**：若未登录，弹出窗口引导用户登录，成功后自动续行。\n2. **图搜上传**：打开淘宝首页并上传图片。\n3. **按钮定位**：点击弹窗内搜索按钮。\n4. **选品采样**：采样候选商品并进入详情页。\n5. **自动加购**：点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式（默认 `--headed`）。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `5000`，慢网可增大到 `8000-12000`）。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 2. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n\n## 失败回退建议\n\n- **登录超时**：重新运行 `node run-taobao-task.js --headed`。\n- **上传失败**：重新打开图搜弹窗再上传。\n- **搜索按钮定位失败**：优先使用弹窗按钮精确选择器，或在 browser 工具中手动点击。\n- **加购失败**：检查规格选择、风控拦截或登录失效。\n\n## 安全边界\n\n- 仅操作用户明确指示的商品。\n- 不执行“立即购买”“提交订单”“支付”动作。\n- 规格、数量、店铺偏好不明确时先确认。\n\nFile v1.1.1:README.md\n\n# Taobao (淘宝) Image Search Skill\n\nTaobao (淘宝) image search and add-to-cart skill with script-first execution and browser-fallback. Now featuring automated login handling.\n\n## Features\n\n- **Search by Image**: Find identical or similar products on Taobao (淘宝) using an image.\n- **Automated Workflow**: Automatically enters product details and attempts to add to cart.\n- **Auto Login Detection**: Automatically checks for login status. if not logged in, it opens a login window and waits for completion before resuming the task.\n- **Structured Results**: Produces detailed JSON results, execution logs, and screenshots for verification.\n\n## Quick Start\n\n### 1. Install Dependencies\n\nEnsure Playwright is installed and ready:\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. Prepare Test Image\n\nThe project uses `test.png` by default. You can also provide any local image path during execution:\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. Run with Automatic Login\n\nYou no longer need to run a separate cookie-saving script. Simply run the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**How it works:**\n1. The script checks if you are logged into Taobao (淘宝).\n2. If **not logged in**, a browser window will pop up.\n3. Complete the login in that window.\n4. The script **automatically detects** your success and **resumes the search task** immediately.\n\n### 4. Advanced Configuration\n\nYou can pass arguments directly to the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\nAvailable arguments:\n- `--image, -i`: Path to the image (default: `test.png`).\n- `--headless` / `--headed`: Running mode (default: `--headed`).\n- `--out-dir`: Output directory (default: `verification-artifacts`).\n- `--delay-ms`: Additional wait time for slow networks (default: `5000`).\n\n## Output Artifacts\n\n- `verification-artifacts/result.json`: Structured results.\n- `verification-artifacts/run-log.txt`: Detailed execution logs.\n- `verification-artifacts/*.png`: Screenshots of key steps.\n\nKey Result Fields:\n- `success`: Whether the overall flow succeeded.\n- `loginCheck.isLoggedIn`: Login status.\n- `addToCart.success`: Whether the \"Add to Cart\" confirmation was detected.\n\n## Project Structure\n\n- `SKILL.md`: Instructions for OpenClaw/Codex (Script-first).\n- `run-taobao-task.js`: The main orchestrator with auto-login support.\n- `auto-login-taobao.js`: Background script for login monitoring.\n- `verify-taobao-runner.js`: The underlying automation script.\n\n## Troubleshooting\n\n- **Login Timeout**: If you don't log in within 10 minutes, the task will stop.\n- **Selector Changes**: If Taobao (淘宝) changes its page structure, refer to the browser fallback instructions in `SKILL.md`.\n- **Add to Cart Failure**: Usually caused by SKU selection requirements, risk control, or session expiration.\n\nFile v1.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.1.1\",\n  \"publishedAt\": 1775382550945\n}\n\nFile v1.1.1:README_zh.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。现已支持自动登录检测与任务自动续行。\n\n## 功能\n\n- **以图搜同款**: 基于图片在淘宝搜索同款/相似商品\n- **自动化流程**: 自动进入候选商品详情页并尝试加入购物车\n- **自动登录检测**: 自动校验登录状态。若未登录，会弹出登录窗口并等待登录后再自动继续执行任务。\n- **结构化结果**: 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 1. 安装依赖\n\n确保已安装 Playwright：\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 执行完整链路（支持自动登录）\n\n你不再需要手动运行 `save-taobao-cookie.js`。直接运行主入口即可：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**执行逻辑：**\n1. 脚本会检查淘宝登录状态。\n2. 若 **未登录**，会自动打开有界面浏览器窗口。\n3. 请在窗口内完成登录。\n4. 脚本 **自动检测** 登录成功后，会 **立即续行** 原有的搜索任务。\n\n### 4. 进阶参数\n\n可以直接通过主入口传递参数给底层脚本：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\n可选参数：\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--delay-ms`：为关键等待步骤增加额外延迟（默认 `5000`）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：详细执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n\n## 目录结构\n\n- `SKILL.md`：OpenClaw/Codex 技能说明（脚本优先）\n- `run-taobao-task.js`：支持自动登录的主入口脚本\n- `auto-login-taobao.js`：自动登录监测脚本\n- `verify-taobao-runner.js`：底层自动化验证脚本\n\n## 常见问题\n\n- **登录超时**：10 分钟内未完成登录，脚本将中止\n- **页面变更**：若淘宝结构调整，请参考 `SKILL.md` 的 browser 工具回退流程手动验证\n- **加购失败**：通常是规格选择、风控或登录态过期导致\n\nArchive v1.1.0: 9 files, 18927 bytes\n\nFiles: auto-login-taobao.js (4732b), README_zh.md (2621b), README.md (2915b), run-taobao-task.js (2178b), save-taobao-cookie.js (1609b), SKILL.md (3306b), verify-taobao-runner.js (27603b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`run-taobao-task.js`。\n- 脚本失败、登录超时或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 执行完整链路（含自动登录）\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/image.png --headed\n```\n\n该脚本覆盖：\n\n1. **自动登录校验**：若未登录，弹出窗口引导用户登录，成功后自动续行。\n2. **图搜上传**：打开淘宝首页并上传图片。\n3. **按钮定位**：点击弹窗内搜索按钮。\n4. **选品采样**：采样候选商品并进入详情页。\n5. **自动加购**：点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式（默认 `--headed`）。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `5000`，慢网可增大到 `8000-12000`）。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 2. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n\n## 失败回退建议\n\n- **登录超时**：重新运行 `node run-taobao-task.js --headed`。\n- **上传失败**：重新打开图搜弹窗再上传。\n- **搜索按钮定位失败**：优先使用弹窗按钮精确选择器，或在 browser 工具中手动点击。\n- **加购失败**：检查规格选择、风控拦截或登录失效。\n\n## 安全边界\n\n- 仅操作用户明确指示的商品。\n- 不执行“立即购买”“提交订单”“支付”动作。\n- 规格、数量、店铺偏好不明确时先确认。\n\nFile v1.1.0:README.md\n\n# Taobao (淘宝) Image Search Skill\n\nTaobao (淘宝) image search and add-to-cart skill with script-first execution and browser-fallback. Now featuring automated login handling.\n\n## Features\n\n- **Search by Image**: Find identical or similar products on Taobao (淘宝) using an image.\n- **Automated Workflow**: Automatically enters product details and attempts to add to cart.\n- **Auto Login Detection**: Automatically checks for login status. if not logged in, it opens a login window and waits for completion before resuming the task.\n- **Structured Results**: Produces detailed JSON results, execution logs, and screenshots for verification.\n\n## Quick Start\n\n### 1. Install Dependencies\n\nEnsure Playwright is installed and ready:\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. Prepare Test Image\n\nThe project uses `test.png` by default. You can also provide any local image path during execution:\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. Run with Automatic Login\n\nYou no longer need to run a separate cookie-saving script. Simply run the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**How it works:**\n1. The script checks if you are logged into Taobao (淘宝).\n2. If **not logged in**, a browser window will pop up.\n3. Complete the login in that window.\n4. The script **automatically detects** your success and **resumes the search task** immediately.\n\n### 4. Advanced Configuration\n\nYou can pass arguments directly to the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\nAvailable arguments:\n- `--image, -i`: Path to the image (default: `test.png`).\n- `--headless` / `--headed`: Running mode (default: `--headed`).\n- `--out-dir`: Output directory (default: `verification-artifacts`).\n- `--delay-ms`: Additional wait time for slow networks (default: `5000`).\n\n## Output Artifacts\n\n- `verification-artifacts/result.json`: Structured results.\n- `verification-artifacts/run-log.txt`: Detailed execution logs.\n- `verification-artifacts/*.png`: Screenshots of key steps.\n\nKey Result Fields:\n- `success`: Whether the overall flow succeeded.\n- `loginCheck.isLoggedIn`: Login status.\n- `addToCart.success`: Whether the \"Add to Cart\" confirmation was detected.\n\n## Project Structure\n\n- `SKILL.md`: Instructions for OpenClaw/Codex (Script-first).\n- `run-taobao-task.js`: The main orchestrator with auto-login support.\n- `auto-login-taobao.js`: Background script for login monitoring.\n- `verify-taobao-runner.js`: The underlying automation script.\n\n## Troubleshooting\n\n- **Login Timeout**: If you don't log in within 10 minutes, the task will stop.\n- **Selector Changes**: If Taobao (淘宝) changes its page structure, refer to the browser fallback instructions in `SKILL.md`.\n- **Add to Cart Failure**: Usually caused by SKU selection requirements, risk control, or session expiration.\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1775380386264\n}\n\nFile v1.1.0:README_zh.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。现已支持自动登录检测与任务自动续行。\n\n## 功能\n\n- **以图搜同款**: 基于图片在淘宝搜索同款/相似商品\n- **自动化流程**: 自动进入候选商品详情页并尝试加入购物车\n- **自动登录检测**: 自动校验登录状态。若未登录，会弹出登录窗口并等待登录后再自动继续执行任务。\n- **结构化结果**: 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 1. 安装依赖\n\n确保已安装 Playwright：\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 执行完整链路（支持自动登录）\n\n你不再需要手动运行 `save-taobao-cookie.js`。直接运行主入口即可：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**执行逻辑：**\n1. 脚本会检查淘宝登录状态。\n2. 若 **未登录**，会自动打开有界面浏览器窗口。\n3. 请在窗口内完成登录。\n4. 脚本 **自动检测** 登录成功后，会 **立即续行** 原有的搜索任务。\n\n### 4. 进阶参数\n\n可以直接通过主入口传递参数给底层脚本：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\n可选参数：\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--delay-ms`：为关键等待步骤增加额外延迟（默认 `5000`）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：详细执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n\n## 目录结构\n\n- `SKILL.md`：OpenClaw/Codex 技能说明（脚本优先）\n- `run-taobao-task.js`：支持自动登录的主入口脚本\n- `auto-login-taobao.js`：自动登录监测脚本\n- `verify-taobao-runner.js`：底层自动化验证脚本\n\n## 常见问题\n\n- **登录超时**：10 分钟内未完成登录，脚本将中止\n- **页面变更**：若淘宝结构调整，请参考 `SKILL.md` 的 browser 工具回退流程手动验证\n- **加购失败**：通常是规格选择、风控或登录态过期导致\n\nArchive v1.0.2: 6 files, 14307 bytes\n\nFiles: README.md (2477b), save-taobao-cookie.js (1609b), SKILL.md (4082b), verify-taobao-runner.js (27264b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.0.2:SKILL.md\n\n---\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（save-taobao-cookie.js、verify-taobao-runner.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`save-taobao-cookie.js`、`verify-taobao-runner.js`。\n- 脚本失败或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 准备登录态\n\n先检查是否已存在登录态文件：\n\n```bash\nls -la verification-artifacts/taobao-storage-state.json\n```\n\n若不存在或登录态过期，执行：\n\n```bash\nnode save-taobao-cookie.js\n```\n\n执行后让用户在打开的淘宝页面完成登录，再在终端回车保存登录态。\n\n### 2. 执行完整链路\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/image.png\n```\n\n该脚本覆盖：\n\n1. 打开淘宝首页。\n2. 验证登录状态（未登录即中止并提示先登录）。\n3. 打开图搜弹窗并上传图片。\n4. 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n5. 采样候选商品并进入详情页。\n6. 点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `2000`，慢网可增大到 `4000-8000`）。\n- `--engine`：当前本地脚本仅支持 `playwright`。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 3. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n- `addToCart.reason`：失败原因（如有）。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素 `.site-nav-login-info-nick` 或 `.member-nick-info` 是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 只点击弹窗内搜索按钮，优先：\n  - `#image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active #image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active .upload-button.upload-button-active[data-spm='image_search_button']`\n- 上述失效时兜底：\n  - `.image-search-context-wrapper-active .upload-button:has-text('搜索')`\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n- 用页面成功提示确认结果。\n\n## 失败回退建议\n\n- 登录失败：重新运行 `node save-taobao-cookie.js`。\n- 上传失败：重新打开图搜弹窗再上传。\n- 搜索按钮定位失败：优先使用上述弹窗按钮精确选择器。\n- 加购失败：检查规格选择、风控拦截或登录失效。\n\n## 安全边界\n\n- 仅操作用户明确指示的商品。\n- 不执行“立即购买”“提交订单”“支付”动作。\n- 规格、数量、店铺偏好不明确时先确认。\n\nFile v1.0.2:README.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。\n\n## 功能\n\n- 基于图片在淘宝搜索同款/相似商品\n- 自动进入候选商品详情页并尝试加入购物车\n- 自动校验登录状态，未登录时提示先登录\n- 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 1. 安装依赖（如未安装）\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 首次登录并保存状态\n\n```bash\nnode save-taobao-cookie.js\n```\n\n脚本会打开浏览器。登录淘宝后回到终端按回车，保存登录态到：\n\n- `verification-artifacts/taobao-storage-state.json`\n\n### 4. 执行完整验证流程\n\n```bash\nnode verify-taobao-runner.js\n```\n\n传入指定图片：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png\n```\n\n默认是有界面模式；如需 headless：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png --headless\n```\n\n可选参数：\n\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`，除非设置 `PW_HEADLESS=1`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--state`：登录态文件路径（默认 `verification-artifacts/taobao-storage-state.json`）\n- `--engine`：当前仅支持 `playwright`（OpenClaw 的 `browser` 工具由技能运行时调用，不通过该本地脚本）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n- `addToCart.reason`：失败原因（如有）\n\n## 与 SKILL 的关系\n\n- `SKILL.md`：给 OpenClaw/Codex 的技能说明（脚本优先）\n- `verify-taobao-runner.js`：本地自动化验证主脚本\n- `save-taobao-cookie.js`：登录态保存脚本\n\n## 常见问题\n\n- 未登录报错：重新执行 `node save-taobao-cookie.js`\n- 找不到弹窗搜索按钮：淘宝页面结构变更，优先按 `SKILL.md` 的 browser 回退流程手动验证\n- 加购失败：通常是规格选择、风控或登录态过期导致\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1771641199066\n}\n\nArchive v1.0.1: 6 files, 13895 bytes\n\nFiles: README.md (2477b), save-taobao-cookie.js (1609b), SKILL.md (4082b), verify-taobao-runner.js (25859b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（save-taobao-cookie.js、verify-taobao-runner.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`save-taobao-cookie.js`、`verify-taobao-runner.js`。\n- 脚本失败或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 准备登录态\n\n先检查是否已存在登录态文件：\n\n```bash\nls -la verification-artifacts/taobao-storage-state.json\n```\n\n若不存在或登录态过期，执行：\n\n```bash\nnode save-taobao-cookie.js\n```\n\n执行后让用户在打开的淘宝页面完成登录，再在终端回车保存登录态。\n\n### 2. 执行完整链路\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/image.png\n```\n\n该脚本覆盖：\n\n1. 打开淘宝首页。\n2. 验证登录状态（未登录即中止并提示先登录）。\n3. 打开图搜弹窗并上传图片。\n4. 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n5. 采样候选商品并进入详情页。\n6. 点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `2000`，慢网可增大到 `4000-8000`）。\n- `--engine`：当前本地脚本仅支持 `playwright`。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 3. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n- `addToCart.reason`：失败原因（如有）。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素 `.site-nav-login-info-nick` 或 `.member-nick-info` 是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 只点击弹窗内搜索按钮，优先：\n  - `#image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active #image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active .upload-button.upload-button-active[data-spm='image_search_button']`\n- 上述失效时兜底：\n  - `.image-search-context-wrapper-active .upload-button:has-text('搜索')`\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n- 用页面成功提示确认结果。\n\n## 失败回退建议\n\n- 登录失败：重新运行 `node save-taobao-cookie.js`。\n- 上传失败：重新打开图搜弹窗再上传。\n- 搜索按钮定位失败：优先使用上述弹窗按钮精确选择器。\n- 加购失败：检查规格选择、风控拦截或登录失效。\n\n## 安全边界\n\n- 仅操作用户明确指示的商品。\n- 不执行“立即购买”“提交订单”“支付”动作。\n- 规格、数量、店铺偏好不明确时先确认。\n\nFile v1.0.1:README.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。\n\n## 功能\n\n- 基于图片在淘宝搜索同款/相似商品\n- 自动进入候选商品详情页并尝试加入购物车\n- 自动校验登录状态，未登录时提示先登录\n- 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 1. 安装依赖（如未安装）\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 首次登录并保存状态\n\n```bash\nnode save-taobao-cookie.js\n```\n\n脚本会打开浏览器。登录淘宝后回到终端按回车，保存登录态到：\n\n- `verification-artifacts/taobao-storage-state.json`\n\n### 4. 执行完整验证流程\n\n```bash\nnode verify-taobao-runner.js\n```\n\n传入指定图片：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png\n```\n\n默认是有界面模式；如需 headless：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png --headless\n```\n\n可选参数：\n\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`，除非设置 `PW_HEADLESS=1`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--state`：登录态文件路径（默认 `verification-artifacts/taobao-storage-state.json`）\n- `--engine`：当前仅支持 `playwright`（OpenClaw 的 `browser` 工具由技能运行时调用，不通过该本地脚本）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n- `addToCart.reason`：失败原因（如有）\n\n## 与 SKILL 的关系\n\n- `SKILL.md`：给 OpenClaw/Codex 的技能说明（脚本优先）\n- `verify-taobao-runner.js`：本地自动化验证主脚本\n- `save-taobao-cookie.js`：登录态保存脚本\n\n## 常见问题\n\n- 未登录报错：重新执行 `node save-taobao-cookie.js`\n- 找不到弹窗搜索按钮：淘宝页面结构变更，优先按 `SKILL.md` 的 browser 回退流程手动验证\n- 加购失败：通常是规格选择、风控或登录态过期导致\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1771605203262\n}\n\nArchive v1.0.0: 6 files, 12925 bytes\n\nFiles: README.md (2477b), save-taobao-cookie.js (1609b), SKILL.md (3976b), verify-taobao-runner.js (22658b), verify-taobao.spec.js (3588b), _meta.json (138b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（save-taobao-cookie.js、verify-taobao-runner.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`save-taobao-cookie.js`、`verify-taobao-runner.js`。\n- 脚本失败或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 准备登录态\n\n先检查是否已存在登录态文件：\n\n```bash\nls -la verification-artifacts/taobao-storage-state.json\n```\n\n若不存在或登录态过期，执行：\n\n```bash\nnode save-taobao-cookie.js\n```\n\n执行后让用户在打开的淘宝页面完成登录，再在终端回车保存登录态。\n\n### 2. 执行完整链路\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/image.png\n```\n\n该脚本覆盖：\n\n1. 打开淘宝首页。\n2. 验证登录状态（未登录即中止并提示先登录）。\n3. 打开图搜弹窗并上传图片。\n4. 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n5. 采样候选商品并进入详情页。\n6. 点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式。\n- `--engine`：当前本地脚本仅支持 `playwright`。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 3. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n- `addToCart.reason`：失败原因（如有）。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素 `.site-nav-login-info-nick` 或 `.member-nick-info` 是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 只点击弹窗内搜索按钮，优先：\n  - `#image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active #image-search-upload-button.upload-button.upload-button-active`\n  - `.image-search-context-wrapper-active .upload-button.upload-button-active[data-spm='image_search_button']`\n- 上述失效时兜底：\n  - `.image-search-context-wrapper-active .upload-button:has-text('搜索')`\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n- 用页面成功提示确认结果。\n\n## 失败回退建议\n\n- 登录失败：重新运行 `node save-taobao-cookie.js`。\n- 上传失败：重新打开图搜弹窗再上传。\n- 搜索按钮定位失败：优先使用上述弹窗按钮精确选择器。\n- 加购失败：检查规格选择、风控拦截或登录失效。\n\n## 安全边界\n\n- 仅操作用户明确指示的商品。\n- 不执行“立即购买”“提交订单”“支付”动作。\n- 规格、数量、店铺偏好不明确时先确认。\n\nFile v1.0.0:README.md\n\n# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。\n\n## 功能\n\n- 基于图片在淘宝搜索同款/相似商品\n- 自动进入候选商品详情页并尝试加入购物车\n- 自动校验登录状态，未登录时提示先登录\n- 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 1. 安装依赖（如未安装）\n\n```bash\nnpx playwright install chromium\n```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n```bash\nnode verify-taobao-runner.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 首次登录并保存状态\n\n```bash\nnode save-taobao-cookie.js\n```\n\n脚本会打开浏览器。登录淘宝后回到终端按回车，保存登录态到：\n\n- `verification-artifacts/taobao-storage-state.json`\n\n### 4. 执行完整验证流程\n\n```bash\nnode verify-taobao-runner.js\n```\n\n传入指定图片：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png\n```\n\n默认是有界面模式；如需 headless：\n\n```bash\nnode verify-taobao-runner.js --image ./test.png --headless\n```\n\n可选参数：\n\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`，除非设置 `PW_HEADLESS=1`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--state`：登录态文件路径（默认 `verification-artifacts/taobao-storage-state.json`）\n- `--engine`：当前仅支持 `playwright`（OpenClaw 的 `browser` 工具由技能运行时调用，不通过该本地脚本）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n- `addToCart.reason`：失败原因（如有）\n\n## 与 SKILL 的关系\n\n- `SKILL.md`：给 OpenClaw/Codex 的技能说明（脚本优先）\n- `verify-taobao-runner.js`：本地自动化验证主脚本\n- `save-taobao-cookie.js`：登录态保存脚本\n\n## 常见问题\n\n- 未登录报错：重新执行 `node save-taobao-cookie.js`\n- 找不到弹窗搜索按钮：淘宝页面结构变更，优先按 `SKILL.md` 的 browser 回退流程手动验证\n- 加购失败：通常是规格选择、风控或登录态过期导致\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1771602409235\n}","readmeExcerpt":"Skill: Taobao Image Search Owner: lazygunner Summary: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。 Tags: latest:1.1.3 Version history: v1.1.3 | 2026-04-05T15:10:41.829Z | user No changes detected in this version (1.1.3). - No file changes between this and the previous version. - Functionality, usage, and documentation remain unchanged. - S","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"node run-taobao-task.js --image /absolute/path/to/image.png --headed"},{"language":"bash","snippet":"npm install playwright\n   npx playwright install chromium"},{"language":"bash","snippet":"node run-taobao-task.js --image /absolute/path/to/your-image.png"},{"language":"bash","snippet":"node run-taobao-task.js --image ./test.png --headed"},{"language":"bash","snippet":"node run-taobao-task.js --image ./test.png --headed --delay-ms 5000"},{"language":"bash","snippet":"npm install playwright\n   npx playwright install chromium"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"name: taobao-image-search\ndescription: 使用淘宝进行以图搜同款、候选比对和加购物车操作。用户提供商品图片并要求“搜同款/找类似款/比价/加入购物车”时使用。优先执行本地脚本（run-taobao-task.js）完成全流程；当脚本失败或页面结构变化时回退 browser 工具手动执行。\ninstall:\n  - npm install playwright\n  - npx playwright install chromium\n---\n\n# 淘宝图片搜索技能\n\n## 执行策略\n\n- 优先执行脚本：`run-taobao-task.js`。\n- 脚本失败、登录超时或页面结构变化时，回退 `browser` 工具。\n- 默认不下单、不支付；仅搜索与加购。\n\n## 输入要求\n\n- 必需：本地图片路径或会话中的图片。\n- 可选：预算、偏好（品牌/颜色/尺码）、仅搜索或加购。\n\n若缺少关键输入，先补充最少问题（例如“是否直接加购？”、“预算上限是多少？”）。\n\n## 主流程（脚本优先）\n\n### 1. 执行完整链路（含自动登录）\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/image.png --headed\n```\n\n该脚本覆盖：\n\n1. **自动登录校验**：若未登录，弹出窗口引导用户登录，成功后自动续行。\n2. **图搜上传**：打开淘宝首页并上传图片。\n3. **按钮定位**：点击弹窗内搜索按钮。\n4. **选品采样**：采样候选商品并进入详情页。\n5. **自动加购**：点击加入购物车并检测成功提示。\n\n脚本参数约定：\n\n- `--image, -i`：图片路径（默认 `test.png`）。\n- `--headless` / `--headed`：本地调试运行模式（默认 `--headed`）。\n- `--delay-ms`：为关键步骤追加等待时长（默认 `5000`，慢网可增大到 `8000-12000`）。\n- `browser` 工具在 OpenClaw 运行时由技能流程调用，不由该本地脚本直接调用。\n\n### 2. 读取验证结果\n\n脚本运行后读取：\n\n- `verification-artifacts/result.json`\n- `verification-artifacts/run-log.txt`\n- `verification-artifacts/*.png`（流程截图）\n\n关键判定字段：\n\n- `success`：流程是否成功执行。\n- `loginCheck.isLoggedIn`：是否登录。\n- `addToCart.success`：是否加购成功。\n\n## 回退流程（browser 工具）\n\n仅在脚本执行失败、页面结构变化、或需要人工交互排障时使用。\n\n### 1. 打开淘宝并校验登录\n\n- 打开 `https://www.taobao.com`。\n- 校验昵称元素是否可见。\n- 若未登录，提示用户先登录，再继续。\n\n### 2. 上传图片并搜索\n\n- 点击相机/搜同款入口打开上传弹窗。\n- 上传图片。\n- 点击弹窗内搜索按钮（优先 `#image-search-upload-button.upload-button.upload-button-active`）。\n\n### 3. 选品与加购\n\n- 分析候选商品并优先选择最相似商品。\n- 进入详情页点击“加入购物车”。\n- 若强制规格选择，先选默认规格再加购。\n\n## 失败回退建议\n\n- **登录超时**：重新运行 `node run-taobao-task.js --headed`。\n- **上传失败**：重新打开图搜弹窗再上传。\n- **搜索按钮定位失败**：优先使用弹窗按钮精确选择器，或在 browser 工具中手动点击。\n- **加购失败**：检查规格选择、风控拦截或登录失效。\n\n## 安全边界与隐私\n\n- **会话持久化**：为实现自动化登录，本技能会将浏览器会话（Cookies 和 Storage State）保存至本地。\n  - 路径：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n  - **重要提示**：这些文件包含您的淘宝登录令牌，请务必将其视为**敏感凭据**，严禁上传或分享。\n  - 若需清除登录态，请手动删除上述目录及文件。\n- **操作受限**：仅操作用户明确指示的商品。\n- **支付保护**：不执行“立即购买”“提交订单”“支付”动作。\n- **环境建议**：建议在受信的个人机器或沙箱环境中运行。"},{"path":"README.md","content":"# Taobao (淘宝) Image Search Skill\n\nTaobao (淘宝) image search and add-to-cart skill with script-first execution and browser-fallback. Now featuring automated login handling.\n\n## Features\n\n- **Search by Image**: Find identical or similar products on Taobao (淘宝) using an image.\n- **Automated Workflow**: Automatically enters product details and attempts to add to cart.\n- **Auto Login Detection**: Automatically checks for login status. if not logged in, it opens a login window and waits for completion before resuming the task.\n- **Structured Results**: Produces detailed JSON results, execution logs, and screenshots for verification.\n\n## Quick Start\n\n### 1. Installation\n\n1. Clone or copy these scripts to your environment.\n2. Install Playwright and browser dependencies:\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. Prepare Test Image\n\nThe project uses `test.png` by default. You can also provide any local image path during execution:\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. Run with Automatic Login\n\nYou no longer need to run a separate cookie-saving script. Simply run the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**How it works:**\n1. The script checks if you are logged into Taobao (淘宝).\n2. If **not logged in**, a browser window will pop up.\n3. Complete the login in that window.\n4. The script **automatically detects** your success and **resumes the search task** immediately.\n\n### 4. Advanced Configuration\n\nYou can pass arguments directly to the orchestrator:\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\nAvailable arguments:\n- `--image, -i`: Path to the image (default: `test.png`).\n- `--headless` / `--headed`: Running mode (default: `--headed`).\n- `--out-dir`: Output directory (default: `verification-artifacts`).\n- `--delay-ms`: Additional wait time for slow networks (default: `5000`).\n\n## Output Artifacts\n\n- `verification-artifacts/result.json`: Structured results.\n- `verification-artifacts/run-log.txt`: Detailed execution logs.\n- `verification-artifacts/*.png`: Screenshots of key steps.\n\nKey Result Fields:\n- `success`: Whether the overall flow succeeded.\n- `loginCheck.isLoggedIn`: Login status.\n- `addToCart.success`: Whether the \"Add to Cart\" confirmation was detected.\n\n## Project Structure\n\n- `SKILL.md`: Instructions for OpenClaw/Codex (Script-first).\n- `run-taobao-task.js`: The main orchestrator with auto-login support.\n- `auto-login-taobao.js`: Background script for login monitoring.\n- `verify-taobao-runner.js`: The underlying automation script.\n\n## Security & Privacy Note\n\n> [!CAUTION]\n> **This skill persists browser session tokens locally.**\n> - Storage locations: `verification-artifacts/taobao-storage-state.json` and `.pw-user-data-taobao/`.\n> - These files contain active session cookies for Taobao. **Do not share or upload them.**\n> - Use the skill on trusted machines only.\n> - To completely "},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn776z4xk9ywbgpd5gp3j6emns81gxn9\",\n  \"slug\": \"taobao-image-search\",\n  \"version\": \"1.1.3\",\n  \"publishedAt\": 1775401841829\n}"},{"path":"README_zh.md","content":"# taobao-image-search-skill\n\n淘宝以图搜同款与加购技能（脚本优先，browser 兜底）。现已支持自动登录检测与任务自动续行。\n\n## 功能\n\n- **以图搜同款**: 基于图片在淘宝搜索同款/相似商品\n- **自动化流程**: 自动进入候选商品详情页并尝试加入购物车\n- **自动登录检测**: 自动校验登录状态。若未登录，会弹出登录窗口并等待登录后再自动继续执行任务。\n- **结构化结果**: 产出结构化结果与截图，便于回归验证\n\n## 快速开始\n\n### 安装与环境\n\n1. 克隆或复制这些脚本到您的本地环境。\n2. 安装 Playwright 及其浏览器依赖：\n   ```bash\n   npm install playwright\n   npx playwright install chromium\n   ```\n\n### 2. 准备测试图片\n\n默认使用仓库内 `test.png`。也可以在执行时传入任意本地图片路径：\n\n## 安全与隐私提醒\n\n> [!CAUTION]\n> **本技能会在本地持久化浏览器会话令牌。**\n> - 存储位置：`verification-artifacts/taobao-storage-state.json` 与 `.pw-user-data-taobao/`。\n> - 这些文件包含您的淘宝登录 Cookies。**严禁分享或上传这些文件。**\n> - 请仅在受信的个人机器上使用本技能。\n> - 若需彻底注销并清除令牌，请手动删除上述目录。\n\n```bash\nnode run-taobao-task.js --image /absolute/path/to/your-image.png\n```\n\n### 3. 执行完整链路（支持自动登录）\n\n你不再需要手动运行 `save-taobao-cookie.js`。直接运行主入口即可：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed\n```\n\n**执行逻辑：**\n1. 脚本会检查淘宝登录状态。\n2. 若 **未登录**，会自动打开有界面浏览器窗口。\n3. 请在窗口内完成登录。\n4. 脚本 **自动检测** 登录成功后，会 **立即续行** 原有的搜索任务。\n\n### 4. 进阶参数\n\n可以直接通过主入口传递参数给底层脚本：\n\n```bash\nnode run-taobao-task.js --image ./test.png --headed --delay-ms 5000\n```\n\n可选参数：\n- `--image, -i`：图片路径（默认 `test.png`）\n- `--headless` / `--headed`：是否无头运行（默认 `--headed`）\n- `--out-dir`：输出目录（默认 `verification-artifacts`）\n- `--delay-ms`：为关键等待步骤增加额外延迟（默认 `5000`）\n\n## 输出结果\n\n- `verification-artifacts/result.json`：结构化执行结果\n- `verification-artifacts/run-log.txt`：详细执行日志\n- `verification-artifacts/*.png`：关键步骤截图\n\n关键字段：\n- `success`：流程是否整体执行成功\n- `loginCheck.isLoggedIn`：登录状态\n- `addToCart.success`：是否检测到加购成功提示\n\n## 目录结构\n\n- `SKILL.md`：OpenClaw/Codex 技能说明（脚本优先）\n- `run-taobao-task.js`：支持自动登录的主入口脚本\n- `auto-login-taobao.js`：自动登录监测脚本\n- `verify-taobao-runner.js`：底层自动化验证脚本\n\n## 常见问题\n\n- **登录超时**：10 分钟内未完成登录，脚本将中止\n- **页面变更**：若淘宝结构调整，请参考 `SKILL.md` 的 browser 工具回退流程手动验证\n- **加购失败**：通常是规格选择、风控或登录态过期导致"},{"path":"skill-card.md","content":"## Description:\n\nSearches Taobao by product image, compares candidate listings, and can add a selected similar item to the user's cart through a Playwright-backed workflow with browser fallback.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lazygunner](https://clawhub.ai/user/lazygunner)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nAgents use this skill when a user provides a product image and asks to find identical or similar Taobao items, compare candidates, or add a chosen item to cart. It is intended for shopping assistance workflows that require user-provided images and an authenticated Taobao session.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill stores reusable Taobao login sessions locally, including cookies and storage state that should be treated as account credentials.\n\nMitigation: Run only on a trusted personal machine or sandbox, avoid uploading or sharing verification-artifacts/taobao-storage-state.json and .pw-user-data-taobao/, and delete those files when finished.\n\nRisk: The workflow can automatically add an item to a live Taobao shopping cart without a strong confirmation gate.\n\nMitigation: Use the full script only when the user explicitly wants cart modification, and prefer search-only or browser fallback review when the item choice is uncertain.\n\nRisk: The security verdict is suspicious because the skill combines account session persistence with live shopping-cart automation.\n\nMitigation: Review before installing with a real Taobao account, pin Playwright with a lockfile in sensitive environments, and inspect generated artifacts after each run.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/lazygunner/skills/taobao-image-search)\n- [Publisher Profile](https://clawhub.ai/user/lazygunner)\n- [Taobao](https://www.taobao.com)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell commands, structured JSON result files, execution logs, and screenshots]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May write verification artifacts including result.json, run-log.txt, screenshots, browser storage state, and a persistent Playwright user data directory.]\n\n## Skill Version(s):\n\n1.1.3 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1388,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T10:06:41.001Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:24:46.262Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}