核心用法
whoop-cli 是一个非官方的 WHOOP 可穿戴设备命令行工具封装，为 AI Agent 提供结构化 JSON 数据访问能力，屏蔽了 OAuth2 鉴权、速率限制、数据分页等底层 API 复杂度。
典型工作流：
1. 身份验证状态检查：whoop auth status --json 验证本地 token 有效性
2. 日常数据获取：whoop day-brief --json --pretty 获取当日恢复、睡眠、 strain 综合简报
3. 健康监控：whoop health flags --days 7 --json --pretty 检测异常生理指标
4. 趋势分析：whoop sleep trend --days 30 --json --pretty 生成可图表化的长期数据
5. 数据导出：whoop sync pull --start 2024-01-01 --end 2024-01-31 --out ./whoop.jsonl 批量导出用于本地分析
显著优点
- Agent 原生设计：所有输出强制 JSON 格式，可直接解析无需正则清洗
- 安全隔离：凭证存储于
~/.whoop-cli/profiles/本地文件，Agent 不接触 client_secret - 操作语义清晰：
summary/day-brief/strain-plan等命令直观对应 WHOOP 核心概念 - 只读优先：默认推荐
sync pull、trend等非破坏性操作，降低误操作风险
潜在缺点与局限性
- 非官方集成：WHOOP API 变更可能导致功能中断，无 SLA 保障
- OAuth 配置门槛：首次使用需用户本地执行
whoop auth login完成三方授权流 - Node 环境依赖：需全局安装 npm 包，对容器/无 Node 环境不友好
- 速率限制不明：文档未说明 WHOOP API 具体配额，大规模导出可能触发限流
- 功能边界：不支持实时推送、不支持修改 WHOOP 设备设置，纯只读工具
适合人群
- 需要自动化健康数据周报/月报的健身爱好者
- 构建个人健康知识库的 Quantified Self 实践者
- 希望将 WHOOP 数据接入 Notion、Obsidian 等笔记系统的效率工具用户
- 生物黑客、教练、研究人员进行批量数据科学分析
常规风险
- 凭证泄露：若用户错误地在聊天中粘贴 client_secret，需立即在 WHOOP 开发者后台撤销
- 隐私暴露：导出的 JSON/JSONL 包含精确到分钟的心率、HRV、睡眠阶段，共享前需脱敏
- 数据断流：WHOOP 订阅到期或 token 过期后，工具静默失败需重新授权
- 过度解读：AI 可能基于有限趋势数据给出不准确的医疗建议，需明确标注非医疗用途