BuyWise

SKILL.md

---
name: BuyWise
description: |
  BuyWise is your personal shopping advisor — it helps you decide whether to buy, where to buy, and when to buy, across all major global and Chinese platforms.

  Instead of manually checking Amazon, eBay, AliExpress, Temu, JD, Taobao, and Tmall one by one, BuyWise aggregates prices from all platforms into a single comparison table with clear best-pick recommendations. It goes beyond simple price lookup: BuyWise analyzes historical price trends to detect fake promotions (the inflate-then-discount trick common in Double 11 / 618 sales), distills thousands of user reviews into a concise strengths/complaints/red-flags summary, recommends better alternatives at lower prices, and tells you whether to buy now or wait for the next major sale event.

  Just tell BuyWise what you want to buy — it handles the rest.

keywords: shopping assistant, price comparison, buy or wait, deal checker, is it worth buying, fake discount, fake sale, discount detection, product review, review analysis, review summary, alternatives, best deal, best price, lowest price, price tracker, price history, Amazon price history, buy timing, pre-purchase research, save money, shopping decision, shopping guide, consumer guide, product research, shopping advisor, Amazon, eBay, AliExpress, Temu, JD, Taobao, Tmall, Pinduoduo, CamelCamelCamel, smzdm, Double 11, 11.11, 618 sale, Black Friday, Cyber Monday, cross-border shopping, budget alternative, all-time low
metadata:
  openclaw:
    runtime:
      node: ">=18"
---

# BuyWise — Global Shopping Decision Assistant

> Price comparison · Fake discount detection · Review analysis · Alternative recommendations · Buy timing

## When to use

- User asks "is this worth buying?" or "what do you think of this?"
- User asks "compare prices", "where is the cheapest?", "best price for X"
- User asks "is this Double 11 deal real?", "should I wait for 618?", "is now a good time to buy?"
- User asks "summarize the reviews" or "any known issues with this?"
- User asks "any cheaper alternatives?" or "anything better for the price?"
- User shares a product link and asks whether it's worth purchasing

---

## 🌐 Language rules

- Default to the user's language
- Display prices in the user's local currency (¥ for China, $ for international)
- Keep platform names in their original form (Amazon, JD, Temu, etc.)

---

## 🛒 Platform coverage

| Market | Platforms |
|--------|-----------|
| China | JD, Taobao, Tmall, Pinduoduo (100B subsidy), Xianyu (used) |
| International | Amazon, eBay, AliExpress, Temu |

---

## 🔌 Data sources

BuyWise navigates **real product pages via the browser tool** — no guesswork from web_search alone:

| Data type | Source | Platforms covered |
|-----------|--------|-------------------|
| China market prices | **smzdm.com** | JD, Taobao, Tmall, Pinduoduo |
| Amazon price history | **CamelCamelCamel** | Amazon global |
| Amazon current price | amazon.com search | Amazon |
| eBay prices | ebay.com search | eBay |
| AliExpress prices | aliexpress.com search | AliExpress |
| Temu / Xianyu | web_search supplement | Temu, Xianyu |
| Reviews | web_search + Zhihu / Xiaohongshu / Reddit | Multi-platform |

> BuyWise navigates real data pages directly — no extra skill dependency required.

---

## 📋 Features

### Full buying decision (main)
Triggered when user asks to evaluate a product:
1. **Multi-platform price comparison** — browser navigates smzdm / Amazon / eBay / AliExpress for real prices, compiled into one table
2. **Fake discount detection** — browser checks CamelCamelCamel + smzdm price history to expose inflate-then-discount tactics
3. **Review analysis** — extracts top 3 strengths / 3 complaints / who it's for / red flags from JD, Zhihu, Xiaohongshu, Reddit
4. **Alternative recommendations** — finds 2–3 better-value options in the same category
5. **Buy timing** — 🟢 Buy now / 🟡 Wait / 🔴 Skip verdict based on price history, sale calendar, current price

### Price comparison only
Triggered when user only asks "how much is X" or "cheapest place to buy X" — returns comparison table, skips full analysis.

### Discount authenticity check
Triggered when user asks "is this Double 11 price real?" or "is this discount genuine?" — focused analysis of price history.

### Deep review scan
Triggered when user asks "tell me more about the reviews" or "what's the reputation like?" — deep search across review platforms, forums, and complaint records.

---

## 🔧 Scripts

```bash
# Full buying decision (main entry)
node scripts/advise.js <product> [--lang zh|en]
# Examples:
node scripts/advise.js "Dyson V15"
node scripts/advise.js "Sony WH-1000XM5" --lang en

# Price comparison only
node scripts/compare.js <product> [--lang zh|en]
node scripts/compare.js "AirPods Pro 2"

# Fake discount check
node scripts/deal-check.js <product> [--price current] [--was listed] [--lang zh|en]
node scripts/deal-check.js "iPhone 16" --price 5999 --was 7999

# Review analysis
node scripts/review-scan.js <product> [--lang zh|en]
node scripts/review-scan.js "Xiaomi Router BE7000"
```

---

## ⚠️ Notes

1. Prices are based on real-time search and may have slight delays — confirm on the platform before purchasing
2. Price history analysis relies on public data; if a platform does not publish history, search results are used as reference
3. Review summaries are based on public sources and do not represent all user experiences
4. Sale event timing (Double 11 / 618) follows the Chinese e-commerce calendar; international sales reference Black Friday / Prime Day
5. Alternative recommendations contain no ads or sponsorships — based solely on value-for-money analysis