TrendRadar

SKILL.md

# TrendRadar

> Scan social media and communities to detect trending products before they peak — then act on them with BuyWise and CouponClaw.

TrendRadar monitors 小红书, 微博, Reddit, Google Trends, and Product Hunt in real time. It assigns a trend direction (↑↑ surging / ↑ rising / → stable / ↓ cooling) and a commercial signal to each item, so you know whether to buy now, wait, or skip.

## What TrendRadar does differently

Most tools show you what's already popular. TrendRadar shows you what's about to peak — so you can get the best price before demand drives it up, or avoid buying into something already fading.

It is the upstream signal source for the entire ecosystem:
- Feed trending products into **BuyWise** for price and review analysis
- Feed trending stores into **CouponClaw** for coupon and cashback stacking
- Daily briefing surfaces the top 3 most commercially interesting trends each morning

## Trigger phrases

- "什么在爆"
- "最近什么在火"
- "小红书在推什么"
- "Reddit trending"
- "今日爆款"
- "热销商品"
- "trending products"
- "what's hot right now"
- "what's going viral"
- "trending on TikTok"
- "trending on xiaohongshu"
- "hot items"

## Scripts

| Script | Command | Description |
|---|---|---|
| `scan.js` | `node scripts/scan.js [keyword/category] [--region cn\|us\|global\|all] [--lang zh\|en]` | Scan social platforms for trending products related to a keyword, or scan all categories if no keyword given |
| `daily-hot.js` | `node scripts/daily-hot.js [--region cn\|us\|global\|all] [--lang zh\|en]` | Generate full daily trending briefing across all categories (for cron push) |

To schedule a daily push, add a cron job directly:
```
openclaw cron add --schedule "0 0 8 * * *" --cmd "node scripts/daily-hot.js --region all --lang zh" --channel telegram
```

## Trend signals explained

| Direction | Meaning | Commercial action |
|---|---|---|
| ↑↑ Surging | >200% growth in 7 days | Buy before price rises |
| ↑ Rising | 50-200% growth in 7 days | Good timing — more competition = better deals |
| → Stable | High volume, growth slowing | Safe choice, no urgency |
| ↓ Cooling | Declining 3+ days | Wait for price drop |

## Ecosystem integration

```
TrendRadar (signal)
    ↓
BuyWise (analysis: price / reviews / buy timing)
    ↓
CouponClaw (action: coupons + cashback stacking)
```

TrendRadar is also called by:
- **NewsToday** — surfaces trending consumer products from the news feed
- **GiftRadar** *(planned)* — uses trending items to inform gift recommendations

## Data sources

| Platform | Region | What it tracks |
|---|---|---|
| 小红书 (Xiaohongshu) | CN | Post volume, engagement velocity |
| 微博热搜 | CN | Search trend ranking |
| 什么值得买 | CN | Save/comment growth rate |
| 抖音热榜 | CN | Viral product videos |
| Reddit | US/Global | Upvotes, post frequency |
| Google Trends | Global | Search volume trajectory |
| Product Hunt | US/Global | New product launches |

## No API required

TrendRadar uses browser navigation to read live platform data directly. No API keys needed.