# User: weibo-scraper

## Target Users
- 内容运营 Agent
- 热点追踪需求的运营 Agent
- 需要实时热点数据的内容创作者

## User Needs
| 需求 | 描述 |
|------|------|
| 实时热点 | 最新热搜榜单和热门微博 |
| 结构化输出 | 可消费的JSON格式，含互动数据 |
| 分类筛选 | 按娱乐、社会、科技等分类获取 |
| 增量更新 | 定时爬取，支持增量对比 |

## Output Format
```json
{
  "source": {
    "platform": "weibo",
    "category": "...",
    "hot_id": "...",
    "url": "..."
  },
  "engagement": {
    "likes": 0,
    "comments": 0,
    "shares": 0,
    "read_count": 0
  },
  "content": {
    "title": "...",
    "text": "...",
    "media_urls": [],
    "category_tags": []
  },
  "author": {
    "username": "...",
    "followers": 0,
    "verified": false
  },
  "timestamp": "",
  "metrics": {
    "hot_rank": 0,
    "hot_score": 0,
    "trend": "up|down|stable"
  }
}
```

## Usage Examples
```bash
# 获取热搜榜
/node weibo-scraper.js --category 娱乐 --limit 20

# 获取特定话题
/node weibo-scraper.js --topic 热门微博 --limit 50

# 定时增量更新
/node weibo-scraper.js --cron --incremental
```