Garmin Connect (Fixed) 是一个专为 Clawdbot 生态集成的健身数据同步工具,旨在将用户 Garmin 设备上的健康与运动数据自动、安全地同步到本地系统。该工具通过 OAuth 认证机制实现与 Garmin Connect 的无缝对接,无需在代码中明文存储密码,保障了用户隐私与安全。每5分钟通过定时任务自动拉取最新数据,确保信息实时更新。支持同步的数据类型广泛,包括每日步数、静息心率、卡路里消耗、活跃分钟数、距离以及详细的睡眠分析(总时长、深浅睡阶段划分)和近期运动记录(如跑步、骑行等活动的距离、时长、平均/最大心率)。所有数据在本地缓存,既提升了访问速度,也避免了频繁调用 API 带来的限制。整个流程设计简洁高效,适合希望将可穿戴设备数据融入自动化工作流或数据分析项目的开发者使用。
核心功能特点
- 基于 OAuth 的安全认证,无需保存密码,保障账户安全
- 每5分钟自动同步一次数据,保持信息实时性
- 支持步数、心率、卡路里、睡眠、运动等多维度健康指标采集
- 数据本地缓存,提升读取效率并支持离线访问
- 易于集成到 Clawdbot 脚本中,提供格式化输出与原始字典两种接口
适用场景
Garmin Connect (Fixed) 特别适合那些希望将个人健身数据整合进自动化系统的开发者或健康爱好者。例如,在构建个人健康仪表盘时,可通过该工具定期获取用户的活动数据,结合图表库生成每日运动趋势图;或者用于智能提醒场景,当检测到连续多日步数未达标时,自动触发通知。对于依赖可穿戴设备数据进行行为分析的研究项目,该工具提供的结构化 JSON 输出极大简化了数据处理流程。此外,由于采用本地缓存机制,即使网络短暂中断也不影响已有数据的可用性,非常适合部署在家庭服务器或边缘设备上长期运行。无论是用于个人健康管理、家庭健康档案维护,还是作为更大规模物联网健康平台的一部分,它都能稳定可靠地完成数据桥接任务。
