SuperAPI AI 工具集

garmin-connect

数据与分析

查看项目

更新于 10-15 21:34

技能介绍

用途:该技能让你通过命令行查询自己的 Garmin Connect 账户数据,适合回答需要手表数据的健康与运动类问题,例如睡眠、步数、静息心率、HRV、训练准备度、活动列表等。

主要能力与子命令:whoami 查看身份;daily、sleep、hrv、readiness、training 查询单日指标(默认今天);summary 汇总某日的数据包;activities 按日期区间列出活动,支持 --limit;weekly 查询以某日结尾的 7 天窗口。所有命令向 stdout 输出 JSON,错误(含 MFA 提示)输出到 stderr。分析类问题建议先选最小范围查询,再基于 JSON 推理;单指标用单个子命令。

使用方式:首次需设置环境变量 GARMIN_EMAIL 与 GARMIN_PASSWORD,然后执行登录。若开启 MFA,需两步:先运行 bun run scripts/garmin.ts login,收到验证码后 10 分钟内以 GARMIN_MFA=123456 bun run scripts/garmin.ts login 完成;未开启 MFA 一步即可。令牌本地缓存并自动刷新,仅当约一年的 OAuth1 令牌过期时才重新提示 MFA。示例:bun run scripts/garmin.ts daily 2026-04-14 --pretty、bun run scripts/garmin.ts activities --from 2026-04-08 --to 2026-04-14 --pretty。管道传入自身上下文时建议加 --pretty。

限制:不写入数据回 Garmin(如上传活动、修改设置),也不同步到外部系统或其他数据源(Apple Watch、Whoop、Oura 等)。Garmin 接口始终以明确日期为准,“本周”“本月”需自行计算日期区间。脚本设计为零依赖单文件,按资料说明在 Garmin 接口变动时可就地修复(检查消费者凭据轮换、登录接口迁移、User-Agent 拦截、端点路径或响应结构变化),并避免新增 npm 依赖、避免模拟网页端 CSRF 流程、不硬编码用户专属值。部分故障可等待或重新登录解决,具体以实际报错为准。