核心用法
Weibo Skill 是基于微博开放平台官方 API 的自动化数据采集工具，专为中文社交媒体监测设计。其核心功能包括：
1. OAuth2 认证流程：完整的授权码模式实现，通过 oauth-authorize-url 生成授权链接，交换 code 获取 access_token
2. 标准端点封装：预置 public-timeline（公共时间线）、user-timeline（用户时间线）、search-topics（话题搜索）等高频接口
3. 通用 API 调用：call 命令支持任意官方端点的 GET 请求，保持与微博 API 文档同步
4. CLI 优先设计：weibo_cli.sh 提供可复现的命令行界面，适合自动化脚本和 Agent 工作流
显著优点
- 官方数据源：直接对接
api.weibo.com，数据权威性高于爬虫或第三方聚合 - 结构化输出：默认 JSON 格式，便于下游 NLP 分析、情感计算和时序存储
- Secret 管理友好：明确区分敏感与非敏感凭证，
WEIBO_APP_SECRET通过primaryEnv机制强制安全注入 - 降级方案：配套
weibo-brave-search技能，API 受限时可切换至商业搜索 API
潜在缺点与局限
- 准入门槛：需微博开放平台开发者账号，个人开发者接口权限受限，企业资质审核周期较长
- 频率限制：未明确披露但存在隐性限流，大规模采集需申请高级权限
- 数据完整性：部分用户微博因隐私设置不可见，公共时间线存在采样偏差
- Token 生命周期：未提及自动刷新机制，长期运行需手动维护
- 仅支持 GET：
call命令文档未覆盖 POST/PUT/DELETE，写操作能力存疑
适合人群
- 社交媒体分析师与舆情监测团队
- 需要微博数据训练的中文 NLP 研究者
- 自动化内容聚合与趋势预警系统开发者
- 已有微博开放平台资质的企业技术团队
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | `WEIBO_APP_SECRET` 和 `WEIBO_ACCESS_TOKEN` 若提交至版本控制可导致账号接管 |
| 合规风险 | 采集数据需遵守《微博开放平台开发者协议》及《网络安全法》，商用需额外授权 |
| 服务依赖 | 微博 API 策略调整可能导致端点废弃或权限收缩 |
| 数据偏差 | 公共时间线不代表全量微博，热点话题存在算法策展干扰 |
安全建议
- 强制使用
SecretRef注入敏感凭证，避免环境变量明文 - 定期轮换
WEIBO_APP_SECRET，监控异常调用日志 - 采集数据脱敏存储，用户 UID 与内容分离加密
- 生产环境配置 API 调用熔断，避免触发平台封禁