mcpField
A
apple-health-skill

apple-health-skill

github.com/nftechie其他343 次安装37 周前更新
代码仓库

关于 apple-health-skill

通过 Transition 让 AI Agent 查询 Apple Health 数据的技能，支持用自然语言询问训练和健康指标，并提供训练、表现及个人资料接口。

主要功能

  1. 01基于 Apple Health 数据的 AI 对话
  2. 02按日期范围获取训练记录
  3. 03CTL、ATL 和 TSB 表现图表
  4. 04表现统计数据与运动员资料
  5. 05无需认证的每日训练接口

适用场景

  1. 01询问心率或睡眠趋势
  2. 02比较训练量或跑步配速
  3. 03查看体能、疲劳和状态指标
  4. 04生成快速结构化训练计划

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nftechie/apple-health-skill --skill apple-health-skill

安装后在 Claude Code 中输入/apple-health-skill确认已加载。

附带文件README.md

详细介绍

Apple Health 技能

使用 AI 与 Apple Health 数据对话。询问训练、心率趋势、活动圆环、VO2 Max 等信息。由 Transition 提供支持，它会与 Apple Health 同步，让 AI Agent 能访问你的健身数据。

设置

  1. 下载 Transition 并授予其 Apple Health 访问权限
  2. 前往 Settings > API Keys，然后轻点 Generate New Key
  3. 设置环境变量：
export TRANSITION_API_KEY="tr_live_xxxxxxxxxxxxxxxxxxxxx"

无需身份验证

每日训练

生成随机的结构化训练计划——无需账户。

curl "https://api.transition.fun/api/v1/wod?sport=run&duration=45"

参数：

  • sport — run、bike、swim 或 strength（默认：run）
  • duration — 分钟数，10-300（默认：45）

需要身份验证的端点

基础 URL： https://api.transition.fun 身份验证： 每次请求都传入 X-API-Key 标头。

AI 教练聊天

询问有关 Apple Health 数据的问题。AI 教练可以全面了解你的训练和健康指标。

curl -X POST -H "X-API-Key: $TRANSITION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message": "How has my resting heart rate changed over the last month?"}' \
  "https://api.transition.fun/api/v1/coach/chat"

问题示例：

  • “我这周进行了多少次训练？”
  • “我的 VO2 Max 趋势如何？”
  • “我这周的睡眠趋势如何？”
  • “比较我这个月和上个月的跑步配速”
  • “根据我最近的训练情况，我应该休息一天吗？”
获取训练记录

获取指定日期范围内的计划训练。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/workouts?start=2026-02-09&end=2026-02-15"

参数：

  • start — 开始日期（YYYY-MM-DD，必填）
  • end — 结束日期（YYYY-MM-DD，必填）
  • start 和 end 之间的最大日期范围为 90 天。
表现管理图表（PMC）

获取根据 Apple Health 训练计算出的 CTL（体能）、ATL（疲劳度）和 TSB（状态）。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/pmc"
表现统计数据

获取从 Apple Health 数据中得出的 FTP、阈值配速、心率区间及其他指标。

curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/performance/stats"
运动员档案
curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/profile"
聊天记录
curl -H "X-API-Key: $TRANSITION_API_KEY" \
  "https://api.transition.fun/api/v1/coach/history"

速率限制

层级读取端点AI 端点
免费100/天3/天
付费10,000/天100/天

给 Agent 的建议

  1. 将教练聊天作为主要交互方式。 它可以全面了解用户的 Apple Health 训练、心率和表现——只需用自然语言提问。

  2. 推荐高强度训练前先检查疲劳度。 调用 GET /api/v1/performance/pmc 并查看 TSB。如果 TSB 低于 -20，说明运动员已经疲劳。

  3. 快速生成训练计划时使用免费 WOD 端点。 无需身份验证——适合只想获取训练建议的用户。

  4. 所有日期参数都必须使用 YYYY-MM-DD 格式。

评论

支持 Markdown