google-health-cli
Google Health API 的 CLI 工具，专为 AI Agent 和开发者设计
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：google-health-cli。 它的用途是：Google Health API 的 CLI 工具，专为 AI Agent 和开发者设计 完整的 Skill 内容见：https://321skill.com/skills/google-health-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我获取最近7天的步数汇总数据。' 它会调用 `ghealth data steps daily-rollup --from 2026-04-01 --to 2026-04-07` 获取步数每日汇总，然后以表格或摘要形式返回。如果AI需要批量处理心率数据，可以执行 `ghealth data heart-rate list --from 2026-04-01 --to 2026-04-07 --limit 100` 获取最近100条心率记录，并分析趋势。
介绍
ghealth 是一个命令行工具，用于通过 Google Health API v4 访问和管理个人健康数据。它解决了 AI Agent 和开发者需要以编程方式获取步数、心率、运动、睡眠、体重、血氧、HRV、ECG、血糖、营养等 40 多种已验证数据类型的问题。传统上，与 Google Health 交互需要手动构造 HTTP 请求、处理复杂的 OAuth 流程，而 ghealth 将这些封装为简洁的 CLI 命令，并输出结构化的 JSON 结果，便于 AI Agent 直接解析。
使用方法非常简单：首先通过 ghealth setup 完成一次性的 GCP 项目配置和 OAuth 认证，然后即可使用 ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29 获取周步数汇总，或 ghealth data heart-rate list --from today --limit 10 获取最近心率读数。它还支持非交互式设置、无头 OAuth 流程、令牌导出导入等，适合 CI/CD 和远程环境。
ghealth 适合以下人群：后端开发人员需要将 Google Health 数据集成到自己的应用中；智能体开发者希望 AI Agent 能够读取用户健康数据以提供个性化建议；数据分析师需要批量获取健康数据集进行分析。它也可以作为研究人员的健康数据获取工具使用。
使用建议：首次使用前请确保已安装 Go 环境，并按照提示创建 GCP 项目和 OAuth 凭据。注意 OAuth 令牌有有效期，但工具会自动刷新。对于非交互式环境（如服务器或 CI），推荐使用 --non-interactive-auth 和 --complete 参数完成无头认证。另外，请妥善保管 ~/.config/ghealth/ 下的凭据文件，避免泄露。
核心特点
与手动调用 Google Health REST API 相比，ghealth 提供了 40 多种数据类型的预定义命令、确定性退出码、`--dry-run` 和 `--raw` 模式，并且支持非交互式设置和令牌迁移，专为 AI Agent 的自动化流程优化，无需理解 OAuth 细节或 HTTP 请求。
注意事项
ghealth 依赖于 Google Health API 的可用性和用户授权，无法离线使用；且目前仅支持 Google Health v4 接口，不提供数据可视化或分析功能，仅作为数据获取层。
常见问题
ghealth 需要 Google 账号吗？
是的，需要 Google 账号并创建 GCP 项目，启用 Health API 并设置 OAuth 凭据。
ghealth 支持哪些数据类型？
支持步数、心率、运动、睡眠、体重、血氧、HRV、ECG、血糖、营养等 40 多种。运行 `ghealth schema types` 可查看完整列表。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/google-health-cli/raw/index.md 读取 google-health-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/google-health-cli/raw/index.md（查看排版版本）