Ynosis では、ブラウザからの登録に加えて、AIエージェントから施設や成分表を本番データへ登録できます。この経路を Agent API と呼びます。

ここでいう AIエージェントは、特定の製品に限りません。例えば次のようなツールから使えます。

• Claude（Claude Code や、ターミナルから動かす Claude 系の CLI）
• Codex（OpenAI のコーディングエージェント）
• Gemini CLI（Google のターミナル向けエージェント）
• Cursor など、チャットやエージェント機能つきのエディタ

公開されているのは Ynosis の HTTPS API です。手元の道具は PyPI の ynosis-agent（CLI）と、対応アプリ向けの MCP（uvx で起動・事前 pip 不要）です。ソースリポジトリは非公開のため、git clone は不要です。運営がホストするリモート MCP サーバもありません。

何ができるか

• 施設の新規登録 … 名前・都道府県などを送り、マスタに下書きとして追加できる
• 成分表の登録 … 次のいずれかで解析した結果を、施設とあわせて登録できる
  • **手元の画像認識（Vision）**で分析書を文字にしてから、Ynosis が公式の形に整える（OCR の月間枠は使いません）
  • Ynosis の OCR（ブラウザの成分表読み取りと同じ仕組み）で画像を解析した結果
• 重複確認のための検索 … 登録前に、既存施設（管理者未承認の Agent 登録分を含む）を検索できる

既存の施設に当たった場合の変更は、画面からの 編集依頼 と同じく、管理者が差分を確認してから反映されます。公開データをその場で上書きはしません。

誰が使えるか

1. Ynosis に ログインする
2. マイページ 右上の 「…」 を開く
3. Agent API を選び、用途を書いて申請する
4. 管理者が許可すると、同じダイアログから API キーを発行できる（yna_ で始まる。キーは発行時に一度だけ表示されます）

キーは共有せず、漏洩したときは再発行してください。Chrome 拡張用の API キーとは別物です（拡張は Google Maps保存リストから一括登録）。

つなぎ方の選び方

どの AIエージェントを使う場合も、やることは共通です。キーを渡し、本番 API（または ynosis-agent CLI）を呼ばせることです。

セットアップ

クライアントは PyPI（ynosis-agent） から入手します。

CLI を使う場合は Python 3.11 以降で次を実行します。

pip install ynosis-agent
export YNOSIS_AGENT_API_KEY='yna_...'
# 接続先の既定は https://ynosis.jp です

MCP だけ使う場合は事前の pip install は不要です。マシンに uv（uvx）を入れ、後述のアプリ設定を貼れば足ります（uvx が同じ PyPI パッケージを取得します）。

CLI の例（おすすめ）

エージェントに「このコマンドを実行して」と頼むだけで足ります。ツールの種類は問いません。

# 重複確認
ynosis-agent search --q 草津 --limit 5

# 施設 1 件（JSON ファイル）
ynosis-agent facility facility.json

# 成分表（JSON + 画像。サーバーが圧縮保存し、管理者の承認時の根拠になる）
ynosis-agent register payload.json --image photo.jpg

# 手元の画像認識で分析書を文字にしたあと、公式の形に整える（OCR の月間枠は使いません）
ynosis-agent parse-prompt transcript.txt --out prompt.json
# prompt.json の system / user を手元の LLM に渡し、返ってきた JSON を llm_result.json に保存する
ynosis-agent parse transcript.txt --llm-json llm_result.json --for-register --out parsed.json

# Ynosis OCR で画像を解析してから登録（施設名は自分で指定）
ynosis-agent analyze photo.jpg --out analyzed.json
ynosis-agent register-from-image photo.jpg --name 〇〇温泉 --prefecture 大分県

# 複数枚の OCR は 1 枚ずつ（並列にしない）。間隔の既定は 6 秒
ynosis-agent analyze-batch ./photos --out-dir ./out

よく使う AIエージェント別のヒント

製品ごとの画面や設定名は変わることがあります。ここでは「どうつなぐか」だけを押さえます。

Claude（Claude Code / CLI）

ターミナルで動く Claude 系エージェントには、上記の ynosis-agent コマンドをそのまま実行させるのが手早いです。YNOSIS_AGENT_API_KEY をシェルに渡したうえで、検索や登録コマンドを依頼してください。

Codex

Codex もシェル経由で同じ CLI を呼べます。キーはリポジトリや会話ログに書かず、環境変数やシークレット機能側に置きます。一括登録や OCR 連続実行では、並列にしないよう指示に含めてください。

Gemini CLI

Gemini CLI も同様に、ynosis-agent を実行させる使い方が向いています。接続先の既定は https://ynosis.jp なので、本番向けなら Base URL の指定は省略できます。

Cursor など MCP 対応のエディタ

MCP に対応している場合は、アプリの設定に短い起動コマンドを貼るだけで使えます（任意）。事前の pip install は不要です（uvx が PyPI から取得します）。マシンに uv（uvx）が必要です。

起動コマンド（貼り付け用）:

uvx --from ynosis-agent[mcp] ynosis-agent-mcp

あわせて環境変数 YNOSIS_AGENT_API_KEY に発行したキーを渡します。

Cursor の例（mcp.json。yna_REPLACE_ME を置換）:

{
  "mcpServers": {
    "ynosis-agent": {
      "command": "uvx",
      "args": ["--from", "ynosis-agent[mcp]", "ynosis-agent-mcp"],
      "env": {
        "YNOSIS_AGENT_API_KEY": "yna_REPLACE_ME",
        "YNOSIS_AGENT_API_BASE": "https://ynosis.jp"
      }
    }
  }
}

Claude Code の例:

claude mcp add --transport stdio ynosis-agent \
  --env YNOSIS_AGENT_API_KEY=yna_REPLACE_ME \
  -- uvx --from 'ynosis-agent[mcp]' ynosis-agent-mcp

キーを設定ファイルに直書きしたくない場合は、各アプリのシークレット／環境変数機能を使ってください。MCP が使えない場合は、同じツールでも ynosis-agent をターミナル実行すれば足ります。

登録したデータはどう見えるか

• Agent からの 新規施設・成分表は、しばらく 一般の施設検索・詳細には出ません
• 管理者が内容を確認し、公開承認したあとに、みんなの検索対象になります
• 座標や Google マップ上の位置がはっきりしていない新規は、承認前に管理者が位置を整えることがあります

ブラウザからの通常登録（訪問登録・OCR・CSV）はこれまでどおり使えます。詳しくは 施設と成分表の登録 を参照してください。

Agent から Ynosis OCR を使う場合も、ブラウザ登録と同じ月間読み取り上限・サーバ側の同時実行制限がかかります。画像を連続で送るときは 1 枚ずつ（並列にしない）にしてください。手元の画像認識で文字起こしし、parse-prompt / parse で形を整える経路では、この OCR の月間枠は使いません。未承認のまま置ける件数にも上限があります（許可後のダイアログに表示）。

関連

• リリースノート（v4） … Agent API 公開の変更履歴
• 施設と成分表の登録 … ブラウザからの登録全般
• 施設と源泉の編集依頼 … 既存データの修正依頼
• プロフィールの設定と管理 … 申請ダイアログの場所
• 温泉データのご提供について … データ提供全般のお願い