核心用法
weibo-cli 是一款基于 Node.js 的命令行工具，通过调用微博移动端公开 API 获取社交媒体数据。主要功能模块包括：
- 热搜榜单：
weibo hot获取实时热搜 Top 50，支持关键词详情查询（阅读量、讨论量） - 内容搜索：
weibo search支持 8 种搜索类型（综合/实时/视频/图片/文章/用户/话题），可叠加--stats获取话题统计 - 用户数据：通过 UID 查询用户资料、微博动态、关注/粉丝列表，支持按热度排序和分页
- 单条博文：获取帖子详情及评论列表
所有命令均支持 --json 输出，便于配合 jq 进行数据清洗和自动化处理。
显著优点
1. 零门槛使用：无需注册、登录或申请 API Key，开箱即用
2. 数据结构友好：原生 JSON 输出，与现代数据处理工具链无缝衔接
3. 功能覆盖全面：从宏观趋势（热搜）到微观互动（单条评论）的全链路数据获取
4. 自动化友好：支持环境变量注入 Cookie 提升限流阈值，适合爬虫和监控场景
潜在局限
- 数据来源受限：仅依赖公开移动端 API，无法获取私密内容、粉丝可见微博或完整用户画像
- 稳定性风险：非官方工具，API 端点变更或反爬策略升级可能导致功能失效
- 反爬机制：默认访客身份有严格限流（建议 1-2 分钟冷却），高频调用易触发封禁
- UID 依赖：用户相关操作需要预先知道数字 UID，不支持昵称直接查询
适合人群
- 舆情监测与社交媒体分析从业者
- 需要批量采集微博公开数据的研究人员
- 希望快速验证热点话题的开发者/产品经理
- CLI 重度用户和自动化工作流搭建者
常规风险
| 风险类型 | 说明 |
|---------|------|
| 合规风险 | 抓取数据需遵守《微博服务使用协议》，商用场景建议通过官方开放平台获取授权 |
| 账号安全 | 注入 `WEIBO_COOKIE` 时存在凭证泄露风险，避免在公共 CI/CD 日志中硬编码 |
| 数据时效 | 热搜数据实时变化，缓存策略需根据业务场景调整 |
| 法律边界 | 用户粉丝数据、评论内容涉及个人信息，存储和分析需符合 GDPR/个人信息保护法要求 |