名称： fitbit
描述： 查询 Fitbit 健康数据，包括睡眠、心率、活动、血氧和呼吸频率。当用户询问其健身状况、睡眠质量、步数或健康指标时使用。
主页： https://www.fitbit.com
元数据：
clawdbot:
emoji: "💪"
requires:
bins: ["fitbit-cli"]

Fitbit CLI

从 Fitbit 可穿戴设备查询健康和健身数据。

命令

健康数据

# 睡眠记录（深睡、浅睡、快速眼动、清醒时间）
fitbit-cli -s                    # 今天
fitbit-cli -s yesterday          # 昨天
fitbit-cli -s last-week          # 过去 7 天
fitbit-cli -s 2026-01-01         # 指定日期

# 心率时间序列
fitbit-cli -e                    # 今天
fitbit-cli -e last-week          # 过去 7 天

# 血氧 (SpO2)
fitbit-cli -o                    # 今天
fitbit-cli -o last-3-days        # 过去 3 天

# 活动区分钟数
fitbit-cli -a                    # 今天
fitbit-cli -a last-month         # 过去一个月

# 呼吸频率
fitbit-cli -b                    # 今天

# 每日活动（步数、卡路里、距离、楼层）
fitbit-cli -t                    # 今天
fitbit-cli -t yesterday          # 昨天

账户与设备

# 用户资料
fitbit-cli -u

# 已连接设备（电量、同步状态）
fitbit-cli -d

日期格式

• 无参数：今天
• 具体日期：2026-01-05
• 日期范围：2026-01-01,2026-01-05
• 相对日期：yesterday（昨天）、last-week（过去一周）、last-month（过去一月）
• 自定义相对日期：last-2-days（过去 2 天）、last-3-weeks（过去 3 周）、last-2-months（过去 2 个月）

使用示例

用户询问：“我昨晚睡得怎么样？”

fitbit-cli -s yesterday

用户询问：“我这周心率情况如何？”

fitbit-cli -e last-week

用户询问：“今天走了多少步？”

fitbit-cli -t

用户询问：“显示我的血氧水平”

fitbit-cli -o

用户询问：“我的 Fitbit 同步了吗？”

fitbit-cli -d

用户询问：“我上个月活动量如何？”

fitbit-cli -a last-month

注意事项

• 仅对 Fitbit 数据进行只读访问
• 令牌自动刷新（8 小时后过期）
• 数据可能因设备同步而延迟
• 首次设置：运行 fitbit-cli --init-auth