SuperAPI AI 工具集

garmin-health-analysis

数据与分析

查看项目

更新于 10-15 21:39

技能介绍

用途:用自然语言向 Garmin 数据提问,例如“昨晚睡得怎么样”“本周恢复情况如何”“心率趋势怎样”。技能查询 Garmin Connect 的健康指标,并可生成交互式 HTML 图表。

主要能力:读取睡眠、Body Battery、HRV、心率(静息/最高/最低)、活动与训练、压力,以及带平均值的综合摘要和用户资料;输出 JSON。图表基于 Chart.js,可生成睡眠、Body Battery、HRV 与静息心率、活动等图表或完整仪表板,并自动在浏览器打开。

使用方式:两种安装路径——Clawdbot Skill(用于自动化与主动健康监测)或 MCP Server(配合标准 Claude Desktop)。首次需安装依赖 pip3 install garminconnect,并通过 Clawdbot 配置的 skills.entries.garmin-health-analysis.env(GARMIN_EMAIL、GARMIN_PASSWORD)、技能目录下的 config.json 或命令行参数提供凭据。认证命令示例:python3 scripts/garmin_auth.py login。会话令牌存于 ~/.clawdbot/garmin-tokens.json 并自动刷新,可用 status 检查状态。取数示例:python3 scripts/garmin_data.py sleep --days 14(也支持 body_battery、hrv、heart_rate、activities、stress、summary、profile,以及 --start/--end 自定义日期范围)。绘图示例:python3 scripts/garmin_chart.py dashboard --days 30,可用 --output 指定保存路径。

适用场景:个人健康趋势追踪、睡眠与恢复分析、训练负荷观察、按周/月生成健康仪表板。分析可参考 references/health_analysis.md 的解读框架,但需声明内容仅供参考、非医疗建议。

限制与注意:数据源依赖非官方的 garminconnect 库,Garmin 可能调整 API,失败时可尝试升级库;部分指标需支持 HRV 的设备;历史数据可能因未佩戴设备而缺失;新账号历史有限;可能触发 Garmin 速率限制,需稍后重试。凭据与令牌仅本地存储,数据仅发送至 Garmin 官方服务器,删除令牌文件即可撤销访问。