GUIDE

AI エージェント(Claude Code・ChatGPT など)から姿勢ナビを操作するには?

姿勢ナビの API(β)は通常の REST API で、仕様を OpenAPI(YAML)で公開しているので、HTTP を呼べる AI エージェントからそのまま使えます。Claude Code のように手元でコマンドを実行できるエージェントには、ドキュメントの URL を渡し、API キーを環境変数に入れて頼みます。ChatGPT のカスタムアクションなど OpenAPI を読み込めるツールには、OpenAPI を読み込ませて API キー(Bearer)を設定します。

β版です。予告なく仕様を変更する場合があります。 更新日: 2026-10-29

何ができるか

AI エージェントから、API でできることをそのまま頼めます。

  • 顧客を探す・登録する・更新する(例:「外部 ID が CRM-12345 の顧客の、最近の診断を一覧にして」)
  • 正面・側面の写真を送って分析し、結果を読む(例:「この2枚の写真で山田さんの姿勢を分析して、結果を要約して」)
  • 集計を読む(例:「今年の月ごとの診断数を店舗別に表にして」)
  • 撮影画面・結果画面を開く URL を発行する

専用の連携機能を入れる必要はありません。

Claude Code など、手元でコマンドを実行できるエージェント

  1. 管理画面の「API設定 β」で AI 用のキーを発行し、ターミナルで環境変数に入れます

    export SNV_KEY="snv_xxxxxxxx_..."
    
  2. ドキュメントを渡して頼みます

    姿勢ナビの API で顧客を登録して写真を分析し結果を取得する手順を教えて。ドキュメント: https://shiseinavi.com/docs/api と https://shiseinavi.com/llms.txt
    API キーは環境変数 SNV_KEY に入っています。書き込みの前に、送る内容を見せて確認してください。
    

curl やスクリプトを実行できるので、写真の送信(multipart)まで任せられます。

ChatGPT のカスタムアクションなど、OpenAPI を読み込めるツール

  1. OpenAPI(YAML) の URL か中身を、アクションのスキーマとして読み込ませます
  2. 認証に API キー(Bearer)を設定します
  3. 必要なエンドポイントだけを残すと、AI が迷いにくくなります(例: 顧客の検索と診断の取得だけ)

写真のアップロード(multipart)に対応しているかは、お使いのツールによります。対応していない場合は、読み取り・顧客の登録などの JSON の操作に使い、写真の送信は自社のシステムから行ってください。

安全に使うために

  • AI 用に専用のキーを発行し、スコープを必要なものだけに絞ります(読むだけなら read:clients・read:examinations など)
  • 有効期限を短めにし、使い終わったら「失効する」で止めます。直近の呼び出し(50件)は管理画面で確認できます
  • キーをチャットの本文・コード・共有ドキュメントに書かないでください
  • 顧客の氏名・写真・姿勢データが外部の AI サービスに送られる場合があります。各 AI サービスのデータの扱いと、自社のプライバシーポリシー・お客様の同意の範囲でご利用ください
  • API は、顧客・診断のメモ、トークガイド、AI へのプロンプト、スタッフのメールアドレスなどを返しません(AI に渡ったときの指示の混入や漏えいを避けるため)
  • β版です。予告なく仕様を変更する場合があります。 エージェントに渡すドキュメントは、最新の llms-full.txt か OpenAPI を使ってください

関連