ynosis-agent

Ynosis Agent API 用の 公開クライアント（CLI / Python MCP）。

リポジトリは非公開です。ソース clone は不要です。

CLI

pip install ynosis-agent
export YNOSIS_AGENT_API_KEY='yna_...'   # マイページ → … → Agent API で発行
ynosis-agent search --q 草津 --limit 5
ynosis-agent parse-prompt transcript.txt --out prompt.json
ynosis-agent parse transcript.txt --llm-json llm_result.json --for-register
ynosis-agent register payload.json --image photo.jpg

施設登録の推奨: 重複確認 → 既存なら編集依頼（認定・タグ不足時も追記）→ 新規のみ Places 候補から座標を選ぶ。MCP ツール: find_existing_facility, prepare_facility_for_register, remediate_duplicate_facility 等。詳細は CHANGELOG.md。

接続先の既定は https://ynosis.jp（リダイレクトを追います）。

MCP

アプリに設定を貼るだけ。詳細・トラブルシュートは https://ynosis.jp/notes/usage-037。

Cursor など Node がある場合（推奨）: npm の別パッケージ。

npx -y ynosis-agent-mcp

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

Python / uv がある場合: このパッケージの extra。uv（uvx）は別途インストールが必要です。ターミナルで which uvx が通らないと、Cursor からも起動しません。

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

{
  "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"
      }
    }
  }
}

貼ったあと Cursor を再起動し、Customize → MCPs で有効か、チャットのツール一覧に search_facilities が出るかを確認してください。スレッド作り直しは必須ではありません。

uv が無い場合の Python 常設: pip install 'ynosis-agent[mcp]' のあと command を ynosis-agent-mcp にする。

運営向け: PyPI 公開

cd packages/ynosis-agent
python -m build
twine upload dist/*

バージョンは pyproject.toml の version を上げてからビルドする。