Fitbit健康数据分析

技能简介

该技能连接Fitbit Web API，获取用户的步数、心率、睡眠、活动消耗等健康数据，支持生成每日简报和周期性健康报告。

能做什么

• 拉取步数、卡路里、距离、楼层等活动数据
• 获取静息心率、平均心率及心率区间分布
• 查询睡眠时长、效率、清醒次数及睡眠阶段
• 生成每日早间简报（含Active Zone Minutes）
• 输出周/月度健康趋势报告
• 设置步数、睡眠时长等阈值提醒

使用说明

1. 安装与配置

需预先准备Fitbit开发者账号，创建应用获取以下凭证：

export FITBIT_CLIENT_ID="your_client_id"
export FITBIT_CLIENT_SECRET="your_client_secret"
export FITBIT_ACCESS_TOKEN="your_access_token"
export FITBIT_REFRESH_TOKEN="your_refresh_token"

依赖环境：Python 3

2. 生成每日简报

python scripts/fitbit_briefing.py                    # 今日简报
python scripts/fitbit_briefing.py --date 2026-01-20  # 指定日期
python scripts/fitbit_briefing.py --format json      # JSON格式输出

3. 获取特定指标

python scripts/fitbit_api.py steps --days 7      # 近7天步数
python scripts/fitbit_api.py heartrate --days 7  # 近7天心率
python scripts/fitbit_api.py sleep --days 7      # 近7天睡眠
python scripts/fitbit_api.py report --type weekly # 周报

4. Python API调用

export PYTHONPATH="{baseDir}/scripts"
python -c "from fitbit_api import FitbitClient; c=FitbitClient(); print(c.get_steps('2026-01-01','2026-01-16'))"

5. 设置提醒

python scripts/alerts.py --days 7 --steps 8000 --sleep 7

输入与输出

见下方输入与输出表格。

风险提示

• Cardio Load数据无法通过API获取，仅Fitbit Premium App可见
• API访问受Rate Limit限制，频繁调用可能触发限流
• Access Token有效期有限，需配合Refresh Token自动续期
• 健康数据涉及个人隐私，需妥善保管凭证信息

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/kesslerio/fitbit-analytics/SKILL.md
来源类型：GitHub仓库