taobao-image-search

What This Skill Does

The taobao-image-search skill is a sophisticated automation tool designed to bridge the gap between visual inspiration and e-commerce action. It empowers your OpenClaw AI agent to perform image-based product discovery on Taobao, including finding identical items, comparing alternatives, and adding products to your shopping cart. Unlike basic web crawlers, this skill employs a dual-layered execution strategy: a high-efficiency local automation script for standardized workflows and a robust browser-based fallback mechanism for handling dynamic page structures or complex UI interactions. It is strictly limited to search and cart management, ensuring that no financial transactions occur without your explicit, separate confirmation.

Installation

To integrate this capability into your environment, use the OpenClaw CLI: clawhub install openclaw/skills/skills/lazygunner/taobao-image-search Ensure you have the required dependencies, including Playwright, and that the save-taobao-cookie.js script has been initialized at least once to handle your Taobao authentication securely.

Use Cases

• Style Matching: Convert a social media screenshot of an outfit into actual purchase links on Taobao.
• Price Benchmarking: Quickly compare the same product across different sellers to find the best deal.
• Inventory Management: Effortlessly build a wishlist or shopping cart from visual references collected during browsing.
• Hard-to-Find Items: Use visual similarity search when you don't know the specific name or brand of an item.

Example Prompts

1. "I found this jacket in a magazine, can you search for the same model on Taobao and add it to my cart? [attach image]"
2. "Search for this chair using this image and show me the best price options before I decide to add it to my cart."
3. "Look for similar minimalist desk lamps based on this photo, focusing on items under 200 CNY."

Tips & Limitations

• Login Persistence: The tool relies on a taobao-storage-state.json file. If the session expires, simply re-run the save-taobao-cookie.js script to refresh your credentials.
• Precision: For optimal results, ensure the provided image is high-resolution and clearly shows the product features.
• Safety First: This tool will never proceed to the checkout or payment phase. You remain in complete control of the final transaction. If the site structure changes frequently, the fallback browser agent may trigger an interactive prompt for you to verify the selection or handle CAPTCHAs manually.
• Network Conditions: For slow internet environments, use the --delay-ms parameter with your scripts to ensure elements load completely before interactions occur.