A unified shopping and deal aggregator designed to help users programmatically discover coupons, compare prices, and query welfares across multiple platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install wool-hunter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install wool-hunter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Wool Hunter (薅羊毛助手)?
Wool Hunter is a command-line utility and agent skill that consolidates discount search across major Chinese e-commerce and local lifestyle networks. By acting as a single entry point, it eliminates the manual overhead of traversing different platforms to find active promotions. It operates natively within the Openclaw Skills system, providing developers and automation pipelines with programmatic access to real-time saving configurations.
The tool uses a dual-engine approach to search. For mainstream e-commerce platforms, it leverages asynchronous script routines to gather pricing. For broader welfare, daily sign-in benefits, and food delivery rewards, it interfaces with advanced Coze Bot conversational configurations. This ensures high-speed querying and flexible extension capabilities.
Wool Hunter (薅羊毛助手) Use Cases
- Aggregating coupons and discounts across Taobao, JD, Pinduoduo, Douyin, Kuaishou, 1688, Suning, and Vipshop.
- Conducting unified cross-platform price comparison to identify the absolute lowest price for a specific product.
- Programmatically retrieving food delivery red envelopes, sign-in welfares, and daily promotional campaigns.
- Executing platform-specific discount lookups using targeted command-line arguments.
How Wool Hunter (薅羊毛助手) Works
- Intent Analysis: The skill parses incoming user queries for triggers like discount searches, coupon requests, or price comparison commands.
- Platform Routing: Based on the keyword and platform constraints, the agent routes the task to either the multi-platform e-commerce script or the welfare-oriented Coze Bot wrapper.
- Asynchronous Scraping: For e-commerce lookups, the system triggers
scripts/search.pyusing asynchronous HTTP calls to query current pricing and coupon availability. - Welfare Interaction: For generic promotional searches,
scripts/call_bot.pyinitiates a streaming connection (SSE) with Coze Bot to retrieve conversational welfare suggestions. - Sub-Agent Delegation: If the query pertains to local lifestyle deals (e.g., Meituan food delivery or group buying), the request is delegated to the Meituan Life Assistant skill.
- Deduplication and Formatting: Results are compiled, duplicate listings are consolidated, coupons are prioritized, and the optimized output is displayed to the user as a clear markdown table.
Wool Hunter (薅羊毛助手) Setup
Ensure you have the cross-platform Python package manager uv installed. You can install it via curl or pip:
curl -LsSf https://astral.sh/uv/install.sh | sh
# or
pip install uv
Create a configuration file at ~/.coupon_search_config.json containing your Coze Bot API credentials:
{
"coze_api_url": "YOUR_COZE_BOT_ADDRESS",
"coze_api_token": "YOUR_COZE_API_TOKEN"
}
For welfare queries, export the required environment variables used by the integration scripts:
export COZE_TOKEN="YOUR_COZE_TOKEN"
export COZE_PROJECT_ID="7646644331176067098"
export COZE_SESSION_ID="XjZXRWzSYLSKy7hlOGXGI"
export COZE_BASE_URL="https://dygv8mm7gq.coze.site/stream_run"
Wool Hunter (薅羊毛助手) Data Schema & Taxonomy
Platform Reference Table
The tool maps clean platform flags to targeted e-commerce services during parameter passing:
| Parameter Target | Platform Covered | Executed Command Script |
|---|---|---|
| Default (All) | All platforms simultaneously | scripts/search.py |
| 淘宝 | Taobao / Tmall | scripts/search.py |
| 京东 | JD.com | scripts/search.py |
| 拼多多 | Pinduoduo | scripts/search.py |
| 抖音 | Douyin E-commerce | scripts/search.py |
| 快手 | Kuaishou E-commerce | scripts/search.py |
| 1688 | Alibaba 1688 | scripts/search.py |
| 苏宁 | Suning | scripts/search.py |
| 唯品会 | Vipshop | scripts/search.py |
Configuration Object Schema (~/.coupon_search_config.json)
| Field Name | Type | Description | Required |
|---|---|---|---|
coze_api_url |
String | Endpoint URL for your custom Coze Bot | Yes |
coze_api_token |
String | Authentication token for API requests | Yes |
Environment Variable Specifications
| Variable | Type | Default Value | Description |
|---|---|---|---|
COZE_TOKEN |
String | N/A | Authorization bearer token for Coze APIs |
COZE_PROJECT_ID |
String | 7646644331176067098 |
Target workspace/project identifier |
COZE_SESSION_ID |
String | XjZXRWzSYLSKy7hlOGXGI |
Active conversation state session ID |
COZE_BASE_URL |
String | https://dygv8mm7gq.coze.site/stream_run |
API stream endpoint URL |
Wool Hunter (薅羊毛助手) Advanced Features
- Asynchronous SSE Integration: Implements aiohttp to manage Server-Sent Events stream responses from Coze, enabling real-time, responsive deal-hunting loops.
- Hierarchical Deal Prioritization: Built-in visual tagging prioritizes products containing active coupons (marked with fire emojis) and lists them above standard prices.
- Multi-Agent Delegation Workflows: Automatically handles local lifestyle queries by passing control to other Openclaw Skills such as the Meituan Life Assistant.
- Cross-Platform Price Deduplication: Automatically detects identical products across different platforms and highlights the single lowest-price alternative to simplify decision making.
SKILL.md
Loading
Related Openclaw Skills
PDF Label - Made In China
Batch-inserts "Made In China" into Amazon FBA label PDFs with barcode-aware positioning, test-page previews, and mixed-SKU support.
Pixel Asset Compiler
A utility to compile AI-generated pixel character reference sheets and individual actions into validated, game-ready assets and engine scenes.
Save Claude Notes
Save Claude Notes captures Claude Code Q&A into Markdown notes with transcript-aware defaults and flexible save targets.
TED English Learning Assistant
Converts TED talk PDFs or pasted English transcripts into structured bilingual notes, vocabulary lists, reading questions, and Obsidian Canvas maps.
Deep Doc Processor
Openclaw Skills' Deep Doc Processor turns PDFs, Word files, Markdown, web pages, and text into layered summaries, comparison reports, and deep Q&A.
Douyin Video Watermark Removal & Summary
Converts a Douyin link into a watermark-free video, extracted audio, transcript, and a structured summary in one Openclaw Skills pipeline.
Featured*
