WHOOP Central 是一个基于 Node.js 的命令行工具，专为访问和获取 WHOOP 健康数据而设计。它通过 WHOOP 官方 v2 API 实现了对用户睡眠、恢复、劳损及锻炼数据的全面抓取与展示。该工具支持 OAuth 2.0 认证流程，确保用户数据的安全访问，并自动处理令牌刷新，无需手动干预。无论是日常查看个人健康状态，还是批量导入历史记录到本地日志系统，WHOOP Central 都提供了灵活且高效的解决方案。其轻量级架构和脚本化操作模式，使其非常适合集成进自动化工作流或健康追踪系统中。
核心功能特点
- 支持获取 WHOOP 四大核心健康指标：睡眠质量、恢复分数、劳损水平与锻炼记录
- 提供多种命令模式，包括每日快照、完整摘要、单项查询及历史数据批量导入
- 内置 OAuth 2.0 认证机制，兼容 Postman 引导式授权与本地 HTTPS 回调两种方式
- 自动管理访问令牌与刷新令牌，实现无缝续期，避免频繁重新授权
- 输出格式支持 JSON 与 JSONL，便于与其他工具链集成或进行数据分析
适用场景
WHOOP Central 特别适合希望将 WHOOP 穿戴设备数据深度整合进个人健康管理流程的用户。例如，健身爱好者可以通过每日运行 `today.js` 脚本来快速了解当天的恢复状态与运动表现，从而调整训练强度。对于长期关注身体机能的专业运动员或研究人员，可使用 `import-historical.js` 批量导出过去数月的睡眠与 HRV 数据，结合外部分析工具研究疲劳积累与恢复周期之间的关系。此外，开发者也可利用其 JSON 输出能力，构建自定义仪表盘或健康提醒应用，实现数据驱动的健康决策。该工具尤其适用于那些依赖命令行环境、重视隐私控制（本地存储凭证）且需要自动化同步 WHOOP 数据的场景。