Google Health API に CLI ツール「ghealth」登場：Fitbit データを AI エージェントへ

Google Health API は、Fitbit Web API の公式後継者です。これは Google Health API v4 を対象としており、開発者を Google OAuth 2.0 へと移行させます。現在、ターミナルや AI エージェント向けにこの API をラップするオープンソースの CLI コマンドラインツール「ghealth」が登場しました。 本ツールは Apache 2.0 ライセンスの下で提供される単一の Go バイナリです。40 の検証済みデータタイプを構造化 JSON として公開します。この設計により、睡眠、心拍数、歩数のデータをエージェントのコンテキストにパイプラインで流し込むことが可能になります。 ghealth とは何か？ ghealth は Google Health API v4 上のラッパーです。ソースコードから go build -o ghealth .. コマンドでビルドします。1 つの自己完結型バイナリとして配布されます。 本ツールは明示的にエージェントファーストに設計されています。すべてのコマンドは、安定した形状を持つ簡略化された JSON を返します。また、決定論的な終了コード、--dry-run フラグ、および --raw フラグも提供しています。 リポジトリには 2 つの Agent Skills が SKILL.md ファイルとして同梱されています。1 つ目は認証、セットアップ、グローバルフラグをカバーするものであり、もう 1 つ目はすべての 40 のデータタイプ、操作、パターン、および注意点を文書化したものです。エージェントは npx skills add コマンドでこれらをインストールします。 CLI は Google-Health-API GitHub オrganization に存在します。この組織はまた、長年運営されている Fitbit のオープンソースリポジトリもホストしています。 データサーフェス：40 件の検証済みタイプ 40 のタイプは、Fitbit および Pixel Watch のシグナルのほとんどを網羅しています。例としては、歩数、心拍数、睡眠、体重、酸素飽和度、および心拍変動があります。心電図などの臨床データタイプには、ecg.readonly スコープが必要です。 各タイプは操作のサブセットをサポートしています。一般的な操作には、list（一覧表示）、rollup（集計）、daily-rollup（日次集計）、reconcile（照合）があります。書き込み可能なタイプ（exercise（運動）、sleep（睡眠）、weight（体重）、body-fat（体脂肪率）、height（身長））では、create（作成）、update（更新）、delete（削除）が追加されます。 reconcile 操作は、複数のソースからの重複するデータポイントを統合します。これは v4 API の Reconciled Stream に相当します。 睡眠データはパターン分析の好例です。デフォルトの list コマンドでは要約情報が返されますが、--detail オプションを指定すると、段階ごとの詳細データ（覚醒、深部睡眠、REM 睡眠）が取得できます。これにより、週ごとのパターンを把握しやすくなります。 セットアップ：実際に行われること セットアップは単一のコマンド ghealth setup で実行されます。ウィザードが GCP プロジェクトと OAuth の設定を案内します。Google Cloud Console で Desktop タイプの OAuth クライアントを作成する必要があります。 OAuth 認証情報はユーザー自身が用意します。このツールは共有キーを保持しません。ファイルは ~/.config/ghealth/ ディレクトリに、権限モード 0600 で書き込まれます。トークンは自動的に更新されます。 Google Health API のすべてのスコープは「Restricted（制限付き）」に分類されています。本番環境でのアクセスには、プライバシーおよびセキュリティ審査が Google によって要求されます。個人利用の場合、ユーザーは自身のアカウントに対して自身のプロジェクトを認証します。この API は Fitbit、Pixel Watch、および接続されたサードパーティソースからのデータを返します。 ヘッドレスフローでは、PKCE（Proof Key for Code Exchange）方式の S256 チャレンジが使用され、完了時にランダムな state パラメータも検証されます。 実践：コマンドと出力 データ読み取りはタイプを問わず一貫しています。すべての読み取り操作は、dataPoints フィールドに rows を含むオブジェクトを返します。 Copy CodeCopiedUse a different Browser # 最近の心拍数データ ghealth data heart-rate list --from today --limit 10 # 1 週間の歩数合計 ghealth data steps daily-rollup --from 2026-03-22 --to 2026-03-29 # 過去 5 晩の睡眠ステージ ghealth data sleep list --limit 5 --detail 歩数の結果は集約された JSON 形式で返されます: Copy CodeCopiedUse a different Browser { "dataPoints": [ {"date": "2026-03-28", "countSum": "9037"}, {"date": "2026-03-27", "countSum": "2408"} ] } 出力はデフォルトで簡略化されます。元の API レスポンスを取得するには --raw を使用してください。また、--format csv または --format table を指定することで、他の形式（CSV やテーブル）での出力も可能です。-o フラグを使用するとファイルに書き出し、スキーマのプレビューも表示されます。 ページネーションは完全なデータ保持を前提としています。大量のリストを取得する場合は nextPageToken が返されます。このトークンを --page-token として渡すことで、次のページのデータを取得できます。 使用例と具体案 睡眠パターンをエージェントに読み込ませる: --detail オプションで数晩分のデータを取得し、その JSON を Claude Code や Codex のセッションにパイプします。エージェントに対して、1 週間の深い睡眠の傾向を要約するよう指示してください。 ワークアウトデータを pandas に読み込む: ghealth data exercise export-tcx --id [ID] --output ride.csv --as csv コマンドを実行します。各行は心拍数と GPS データを含む 1 つのトラックポイントです。その後、pd.read_csv でファイルを読み込みます。 安静時心拍数のビューを構築する: 30 日間の daily-resting-heart-rate をクエリし、--format csv で CSV 形式で出力します。ノートブックやダッシュボードでグラフ化してください。 ghealth の比較 以下の表は、ghealth を生 API および他の 2 つの CLI と比較したものです。他の 2 つの CLI はどちらも公式ではないことを自ら明記しています。 ghealth（この CLI）Google Health API v4（直接 REST）rudrankriyam/Google-Health-CLI googlehealth-cli (npm) インストール方法 git clone + go build 不要；HTTP/gRPC を自分で呼び出す Go ソースからビルド npm i -g googlehealth-cli 言語 Go、単一バイナリ Any（任意の言語）Go Node.js 認証 自分の OAuth クライアント、PKCE S256 Google OAuth 2.0 自分の OAuth クライアント 自分の OAuth クライアント エージェント出力 簡略化された JSON、終了コード、SKILL.md 生 JSON / gRPC 予測可能な JSON 安定した --json エンベロープ データ型 40 種類がライブ API で検証済み v4 の全表面をカバー ドキュメント化された v4 表面の一部 タイプのサブセット 公式ステータス いいえ；コミュニティ、Google-Health-API オrg 内 Yes; Google はいえ；非公式と表明 いいえ；無関係と表明 生制御が必要な場合は、直接 REST API が真実の基準です。ターミナルやエージェントの使用においては、ghealth は認証とフォーマットのボイラープレート（定型コード）を削減します。 インタラクティブな解説器 The post The Google Health API Got a CLI: ghealth is an Open-Source Tool for Your Fitbit Air Data appeared first on MarkTechPost. この投稿「Google Health API に CLI が登場：ghealth はあなたの Fitbit Air データのためのオープンソースツール」は、MarkTechPost で最初に公開されました。

Google Health API に CLI ツール「ghealth」登場：Fitbit データを AI エージェントへ

背景や根拠まで確認しますか？

関連記事

調べる

選ぶ

サイト