AI Agent获取个人健康数据的七种路径解析

健身训练进入平台期时，理论上需要调整训练量、更换动作、检查恢复状况和饮食安排，必要时重新规划周期。但这一切的前提是，先弄清自己卡在哪一个环节。AI Agent 介入健康管理的可能性，由此引出三个问题：

1. AI Agent 如何方便地获取个人健康数据？
2. 获取数据后，AI Agent 如何正确地处理？
3. AI 的处理结果在多大程度上可信？

这三个问题将分篇讨论，本文聚焦第一个问题：怎样让 AI 持续获取已经在记录的数据。需要说明的是，实测部分以 Apple Health 与 Oura 为主，其余厂商内容均整理自公开资料。

先判断数据在哪里

健康数据的获取方式之所以复杂，是因为数据并不集中在一处：一部分由手表直接记录，一部分经过厂商算法计算，还有一部分需要手动填写。可以将运动健康数据大致分为三层：

第一层是步数、心率、睡眠时段和运动轨迹等基础记录；第二层是 readiness、strain、resilience 等经算法计算的指标；第三层包括饮食、训练感受和其他手工记录。这些数据分散在三类来源：

• 聚合平台：Apple Health、Health Connect 与 Google Health，负责汇集设备和第三方 App 写入的通用数据；
• 厂商或专业 App：Oura、Whoop、Samsung Health、Garmin、训记、Hevy 等，通常保留平台中没有的特色指标；
• 报告或手工记录：饮食、体成分、体检报告等，未必有稳定的数字化入口。

厂商或 App 大多能把第一层以及部分第二、三层信息同步给聚合平台，但不会交出原应用里的全部内容。一方面，Apple Health 或 Health Connect 未必有对应字段；另一方面，某些复合指标本来就是订阅产品的核心卖点。因此，选择获取方式时可以先确认两件事：数据是否已经进入聚合平台，以及平台里的字段够不够用。在此基础上，本文梳理出七种获取路径。

方法一、直接在 AI 产品里使用

如果只需轻量分析、不愿投入配置成本，最直接的选择是让 AI 产品读取现成数据。ChatGPT 与 Claude 都支持在 iOS App 内接入 Apple Health。以 ChatGPT 为例，符合开放条件的用户可以授权读取健康数据，然后直接提问。

这类功能的可用性受地区、账号和开放进度等条件影响，一般只在美国先上线。不具备相关条件的用户，国内的蚂蚁阿福 App 也可以接入 Apple Health 并做问答。实测来看，相关功能还比较基础，能够应付简单的睡眠与运动问题，复杂分析的表现则较为有限。从产品呈现来看，它更侧重体检报告解读与 AI 问诊，健康管理功能似乎并不成熟。

总体而言，这种方式胜在省心，但更适合临时查询和轻量分析；如果希望长期积累、自由查询或者更换模型，还是需要把数据保存到自己能够控制的位置。

方法二、使用现成连接器或中转服务

另一种省事的路径，是使用厂商已经做好的连接器，或者让第三方服务完成数据汇集。得益于 AI 的火热，「能被 AI Agent 读取」正在成为这类服务的一项卖点。例如：

• Strava 上线了官方 MCP 连接器，面向订阅用户，可以让 AI Agent 直接获取数据。
• 训记向买断用户提供 API Skill，入口在「我的」>「数据导出和导入」。这个 API 还支持回写，Agent 可以把训练记录写回 App。
• Hevy 可以在 Settings > Developer 中生成 API Key，需要 Hevy Pro 订阅。
• Freddy 更像一台健康数据的中转服务器：它可以把多个平台的数据同步到自己的服务器，再通过 MCP 或 API 提供访问。第一个数据源免费，多数据源需要订阅，也提供价格较高的终身买断。此外，配置省事的代价，是数据需要存储在第三方服务器上。

选择连接器服务时，需要确认它能读取哪些字段、数据存放在哪里，以及停止订阅后能否完整导出。

方法三、从聚合平台持续导出

如果多个设备和 App 已经把数据写入同一个平台，从平台统一导出往往比逐个连接厂商更省事。Apple Health、Health Connect 与 Google Health 都承担这样的角色，但三者的工作方式并不完全相同。

Apple Health

Apple Watch 是主要数据来源之一，而 Apple Health 本身即是汇总平台，支持相当丰富的数据类型。除了手表记录的数据外，一些第三方 App 写入的营养和训练记录也可以汇集在这里，用户甚至可以在「健康」App 中手动添加数据。

支持 Apple Health 生态的第三方厂商也比较多。经查询，至少小米、Zepp、OPPO、佳明等都支持同步，Keep、Nike Run Club 等运动 App 也可以接入。至于是否写入具体需要的数据，建议根据自身情况进一步核实。

得益于其完善的生态，读取和导出 Apple Health 的工具已相当丰富。以下介绍快捷指令、第三方 App 和自行开发工具三种方法。

快捷指令

快捷指令是 iOS 自带的自动化工具，少数派社区里已有不少介绍和攻略文章，此处不再赘述。

快捷指令可以直接读取 Apple Health 的数据，并且支持日期、时间等条件筛选。于是，「只导出真正关心的那几项指标」以及「增量导出」成为可能；如果备有服务器或数据库，甚至可以把数据直接送上云端。

这同样有现成的方案，例如 Aimee1129/apple-health-shortcuts-mcp。可以跟着教程搭建适合自己的快捷指令，一键把所需数据上传到云端数据库，再让 AI Agent 通过 MCP 读取。

实测中，这个方法能够覆盖大多数常用数据类型。主要门槛在于需要一些动手配置的耐心，当然，这个过程也可以请 AI 协助：

请用快捷指令持续导出特定的 Apple Health 数据。先完整阅读指定教程再回答，不要凭记忆推测操作步骤。环境信息：iPhone 型号与系统版本、有无 Apple Watch、有无 Cloudflare 账号；要导出的指标；最终目标（例如：每天睡醒自动同步昨天的睡眠数据，每天运动完自动同步运动数据，每天 0 点自动同步状态数据）。请先确认这些指标是否都在默认支持范围内；如有超出，说明需要修改的位置及改动难度。方案中请说明如何处理迟到的数据、重复记录和后续修改。交付方式：一步一步来，每步给一个动作，完成后回复「好了」或发截图，再给下一步。如果文档里的步骤和实际界面不一致，指出差异并给出替代路径。

现成工具：花一点钱，少做一些配置

如果不想自己搭快捷指令，可以使用专门的导出工具。

例如，Health Push 是一个简单的小工具，可以将数据导出为 JSON，供 AI Agent 读取和分析。

Health Auto Export 的功能则更完整。它支持选择数据类型、时间范围和导出格式，也可以把数据自动发送到 REST API 或云存储（需要高级版）。接收端可以放在电脑、NAS、服务器上，也可以使用 Supabase、Cloudflare 一类云服务。数据库建表和数据清洗等工作，可以交给 AI Agent 协助完成。可惜的是，国区目前不支持终身买断。

自己写 App：自由度更高，门槛也最高

倘若有一台 Mac，并且拥有开发者账号，又稍微懂一点 iOS 应用开发，也可以自己做一个自用 App 来导出数据，甚至同步到自己的服务器或电脑。

GitHub 上有可用的 SDK，例如 the-momentum/open_wearables_ios_sdk。所谓 SDK，就是别人写好、封装好的一段可复用功能，只需调用即可，不必从零写起，交给 AI 稍作修改包装即可上手。

可以先让 Agent 按 SDK 文档做出一个最小应用，在真机上完成授权和一次同步，再增加数据类型与更新机制。

请基于这个 SDK，开发一个个人自用的 iOS App：https://github.com/the-momentum/open_wearables_ios_sdk

请先阅读项目文档，确认支持范围，不要凭记忆编写接口。

环境信息：Mac 型号、Xcode 版本、iOS 版本、开发者账号类型；需要读取的 Apple Health 数据；历史范围；保存目标：本地文件／自己的电脑／服务器。

先做最小版本：真机安装 > 读取授权 > 按日期查询 > 导出 JSON。保留时间、单位、来源和记录标识，确认数据正确后，再增加上传、增量同步、去重和失败重试。后台同步以 iOS 实际支持的能力为准。

先给方案，确认后再执行。遇到文档缺失或权限限制，明确说明，不要猜测。

不过，开发、安装和长期稳定使用是不同的事情。苹果允许通过 Xcode 的 Personal Team 在个人设备上测试应用，只是免费签名有有效期等限制。

Google Health 与 Health Connect

Android 这边，首先需要理清几个容易混淆的名字：

• Google Health：既是 App，也是云端服务。它由 Fitbit App 更名而来，2026 年 5 月完成替换；Fitbit 与 Pixel Watch 的数据直接汇入其中，对外提供 Google Health API（v4，即 Fit API 的继任者）。
• Health Connect：Android 系统层的数据中转站，在本地存储数据并管理授权，让不同的健康类 App 读写同一份记录。从 Android 14 起，它已并入系统框架，无需另装。
• Google Fit：上一代产品，正在退场。官方说明 Fit API 支持到 2026 年底，App 本身也将并入 Google Health。

如果使用 Fitbit 或 Pixel Watch，数据会直接进入 Google Health。其他品牌则要看对应 App 能否把所需数据写入 Health Connect。

从公开信息和网上讨论看，OPPO、vivo、小米等国内厂商的国际版，以及非国行的三星设备，都支持向 Health Connect 写入数据。以小米为例，可以在 Mi Fitness 的「账号—添加账号」中授权。部分国行三星设备也可以通过开发者设置与地区调整启用 Health Connect；这类方法依赖具体系统版本，不能直接视为通用方案。

在 Health Connect 一侧，老牌工具 Health Sync 和开源项目 Health Data Export 都是现成的选择。前者可以把数据导出到网盘或者服务器，支持多种格式；后者支持导出到 Google 表格并增量更新。

如果想自己定制，可以参考 Health Connect 官方文档或第三方项目 the-momentum/open_wearables_android_sdk。相比 iOS，Android 自用应用的安装通常更灵活，调试和安装到自己的手机上不需要商店开发者账号。

方法四、直接调用官方 API 或 SDK

如果平台不能提供需要的数据，就要回到数据来源。厂商提供的 API、SDK 或官方连接器，能够直接读取原服务里的数据，通常也更适合自动更新。

Google Health API

Google Health 提供了一条与 Apple Health 本地接入不同的路径：通过 API 从 Google Health 云端直接获取数据。大致流程是：创建 Google Cloud 项目、启用 API、配置 OAuth 应用和所需权限，再完成账号授权。个人自用可以全程自助；只有支持超过 100 名用户时，才会触发安全审核。

谷歌还提供了 Google-Health-API/google-health-cli。它覆盖四十余种数据类型，可输出 JSON、CSV 或终端表格，仓库里也附有 Agent Skill 文件。对于想让 Agent 直接读取自己数据的人，这算得上是一种官方适配。

Oura 与 Whoop

Oura 与 Whoop 的生态位颇为相近：硬件价格较高，完整体验依赖订阅，生态相对封闭，但开发者接口对个人较为开放，前提是订阅仍然有效。

如有开发需求，可以直接在 Oura 和 Whoop 的开发者中心注册应用，取得 client_id 和 client_secret，再按文档完成授权。接下来，就可以让 AI Agent 协助建立数据抓取、存储和分析程序。

以 Oura 为例，可以这样向 Agent 提需求：

请先读一遍 Oura 官方文档再回答，不要凭记忆写端点和参数：https://cloud.ouraring.com/v2/docs。认证部分：https://cloud.ouraring.com/docs/authentication。

目标：写一个本地脚本，定期把自己的 Oura 数据拉下来，存进本地 SQLite。

环境：脚本跑在 Mac 或 Docker 上，语言用 Python，依赖可以自由安装。

认证：已在 Oura 后台创建了 OAuth 应用，拿到了 client_id 和 client_secret。

要拉的数据（例如 daily_sleep、daily_readiness、daily_activity、sleep、workout；heartrate 暂不拉或只拉最近 N 天）；历史回补范围；之后的更新频率。

方案里请明确处理这几点：

1. 授权码流程怎么在本地跑通；
2. token 的有效期和刷新机制是什么，刷新后如何持久化新 token，以及失效时的恢复路径；
3. 增量拉取的判重键和断点续传。

先给方案，把不确定点和默认假设一次性列出来，确认后再写代码。

（安全提示：令牌更适合在本地配置，不要直接粘贴进对话。）

如果开发基础薄弱，也没必要重复造轮子。spxrogers/oura-toolkit 面向 AI Agent 使用场景，直接把仓库地址交给 Agent 即可开始配置；Whoop 也有现成的社区项目，如 dpshde/whoop-mcp。

需要留意的是，Oura 已于 2025 年 12 月弃用 Personal Access Token（PAT），目前需要采用 OAuth 2.0；WHOOP 也已迁移到新版 API，旧版 webhook 已移除。网上不少旧脚本和教程已经不再适用。

WHOOP 还有一个容易忽略的细节：它不按自然日组织数据，基本单位是 physiological cycle（生理周期）。让 Agent 处理数据前，需要明确这个定义，否则它可能直接按日历日期聚合，得到一份时间错位的分析。

三星：Health Connect 或 Data SDK

按官方文档，Samsung Health 与 Health Connect 之间支持双向同步，但只覆盖有限的类别。

如果想读取 Energy Score 等特色数据，可以使用 Samsung Health Data SDK。在 Samsung Health 里连点十次版本号打开开发者模式，再按 SDK 要求申请权限并读取数据。

具体做法与前文类似：让 Agent 创建一个 Android 应用，接入 SDK，申请所需权限，读取后保存为文件或上传到接收端。

国内厂商：个人接口普遍有限

华为、小米、OPPO、vivo 都有面向合作方的健康开放平台，但普通用户和个人开发者能够使用的范围有限。四家的情况可以归纳如下：