Garmin数据提取

技能简介

garmer 用于从 Garmin Connect 平台提取个人健康与运动数据，支持活动记录、睡眠质量、心率变化、压力指数、步数统计及身体成分等多维度信息获取。

业务背景

支持运动健身机构、企业健康管理方批量获取 Garmin 用户的全维度健康档案，涵盖训练负荷、恢复状态及长期趋势追踪。解决传统手工导表效率低、数据碎片化问题，助力构建个性化运动处方与风险预警体系。

落地案例：一家马拉松训练营需要跟踪学员的备赛状态，教练通过该技能输入学员授权的 Garmin 账号，定期提取心率变异性（HRV）、压力指数及近期跑步活动的配速与心率区间分布，结合睡眠评分判断疲劳程度，及时调整周训练计划，避免过度训练导致的受伤风险。

能做什么

• 查看每日健康摘要（步数、卡路里、心率、压力）
• 获取睡眠分析报告（时长、阶段、评分、HRV）
• 列出近期运动活动及详细数据
• 导出指定日期范围的健康数据为 JSON
• 通过 Python API 进行复杂数据处理

使用说明

安装指令

# 使用 uv 安装
uv pip install garmer

# 或使用 pip 安装
pip install garmer

首次认证

garmer login

按提示输入 Garmin Connect 邮箱和密码，令牌将保存至 ~/.garmer/garmin_tokens 供后续使用。

常用命令

# 今日健康摘要
garmer summary

# 含睡眠数据的指定日期摘要
garmer summary --date 2025-01-15 --with-sleep --json

# 睡眠分析
garmer sleep --date 2025-01-15

# 近期活动列表
garmer activities --limit 10 --json

# 单条活动详情
garmer activity 12345678 --laps --zones

# 导出最近7天数据
garmer export

# 自定义日期范围导出
garmer export --start-date 2025-01-01 --end-date 2025-01-31 --output data.json

Python API 示例

from garmer import GarminClient
from datetime import date

client = GarminClient.from_saved_tokens()

# 获取用户资料
profile = client.get_user_profile()

# 获取每日摘要
summary = client.get_daily_summary(date(2025, 1, 15))
print(f"步数: {summary.total_steps}")

# 获取睡眠数据
sleep = client.get_last_night_sleep()
print(f"睡眠时长: {sleep.total_sleep_hours:.1f} 小时")

# 获取近期活动
activities = client.get_recent_activities(limit=5)

输入与输出

见下方输入与输出表格。

风险提示

• 需要有效的 Garmin Connect 账号及登录凭据
• 令牌文件存储于本地，需妥善保管避免泄露
• 频繁调用可能触发平台速率限制
• 部分历史数据可能因 Garmin 隐私设置无法获取

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/garrza/garmer/SKILL.md
来源类型：开源技能仓库