apple-health-skill について
Transition を通じて AI エージェントから Apple Health データを照会するスキルです。トレーニングや健康指標について自然言語で質問でき、運動、パフォーマンス、プロフィールの API も利用できます。
主な機能
- 01Apple Health データに基づく AI チャット
- 02期間指定によるワークアウト取得
- 03CTL、ATL、TSB のパフォーマンスチャート
- 04パフォーマンス統計とアスリートプロフィール
- 05認証不要のワークアウト提案エンドポイント
活用シーン
- 01心拍数や睡眠の傾向を質問
- 02運動量やランニングペースを比較
- 03フィットネス、疲労、フォーム指標を確認
- 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 エージェントがフィットネスデータにアクセスできるようにします。
セットアップ
- Transition をダウンロードし、Apple Health へのアクセスを許可します
- Settings > API Keys に移動し、Generate New Key をタップします
- 環境変数を設定します:
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"
レート制限
| Tier | 読み取りエンドポイント | AI エンドポイント |
|---|---|---|
| Free | 100/日 | 3/日 |
| Paid | 10,000/日 | 100/日 |
エージェント向けのヒント
-
コーチチャットを主要なインターフェースとして使います。 ユーザーの Apple Health のワークアウト、心拍数、パフォーマンスをすべて把握しているため、自然な質問をするだけで利用できます。
-
ハードなワークアウトを勧める前に疲労を確認します。
GET /api/v1/performance/pmcを呼び出して、TSB を確認します。TSB が -20 を下回っている場合、アスリートは疲労しています。 -
手軽なワークアウトには無料の WOD エンドポイントを使います。 認証は不要です。ワークアウトの提案だけを求めているユーザーに最適です。
-
すべての日付パラメーターで日付形式は常に YYYY-MM-DD です。