CouponClaw

SKILL.md

# CouponClaw

> Find coupons, stack cashback, and maximize savings — across China, US, UK, Australia, Southeast Asia, and DTC brands worldwide.

CouponClaw is the only coupon skill that covers every major market in one place. It searches verified coupon databases, finds cashback portal rates, and calculates the best stacking strategy so you always know the exact final price before checkout.

## What makes CouponClaw different

Most coupon tools check one platform in one country. CouponClaw runs a 3-layer strategy:
1. **Layer 1 — Coupons**: Real-time browser search across region-specific coupon sites (smzdm, RetailMeNot, VoucherCodes, OzBargain, ShopBack, and more)
2. **Layer 2 — Cashback stacking**: Compares 返利网, Rakuten, TopCashback, and ShopBack rates — and checks if they stack with the coupon
3. **Layer 3 — DTC brand check**: Detects hidden first-order discounts and newsletter signup offers on brand official sites

It also runs a daily deals briefing (via cron) that surfaces the hottest community-verified deals from each region every morning.

## Trigger phrases

Use CouponClaw when you say things like:
- "is there a coupon for..."
- "promo code for..."
- "discount code"
- "voucher code"
- "coupon code"
- "cashback for..."
- "有没有优惠券"
- "有没有券"
- "优惠码"
- "折扣码"
- "返利"
- "省钱"
- "领券"
- "打折"
- "今日优惠"
- "daily deals"
- "best deals today"

## Scripts

| Script | Command | Description |
|---|---|---|
| `find.js` | `node scripts/find.js <product or store> [--region cn\|us\|uk\|au\|sea\|all] [--lang zh\|en]` | Find all available coupons + cashback stacking for a product or store |
| `cashback.js` | `node scripts/cashback.js <store> [--spend amount] [--lang zh\|en]` | Look up and compare cashback rates across all platforms |
| `daily-deals.js` | `node scripts/daily-deals.js [--region cn\|us\|uk\|au\|sea\|all] [--lang zh\|en]` | Generate today's top deals briefing (for cron push) |
| `push-toggle.js` | `node scripts/push-toggle.js on\|off\|status <userId> [--morning HH:MM] [--region ...] [--channel telegram\|slack\|feishu\|discord] [--lang zh\|en]` | Manage daily deal push subscription |

## Region coverage

| Region | Coupon sources | Cashback |
|---|---|---|
| 🇨🇳 China | 什么值得买, 京东领券中心, 淘宝聚划算, 折800 | 返利网, 什么值得买返利 |
| 🌏 Chinese overseas | Dealmoon (North America) | Rakuten |
| 🇺🇸 US | RetailMeNot, Slickdeals, Amazon Coupons | Rakuten, TopCashback |
| 🇬🇧 UK | VoucherCodes, HotUKDeals, MyVoucherCodes | TopCashback |
| 🇦🇺 Australia | OzBargain, Cashrewards | ShopBack |
| 🌏 Southeast Asia | ShopBack, iPrice | ShopBack |
| 🏷️ DTC brands | Official site popup detection, newsletter signup offers | Rakuten / TopCashback |

## No API required

CouponClaw uses browser navigation to read real-time data directly from coupon and cashback sites. No API keys, no subscriptions.