Metadata-Version: 2.4
Name: ynosis-agent
Version: 0.2.4
Summary: CLI and MCP client for the Ynosis Agent API (facilities and spring analyses)
Author: Ynosis
License: Proprietary
Project-URL: Homepage, https://ynosis.jp
Project-URL: Documentation, https://ynosis.jp/notes/usage-037
Keywords: ynosis,onsen,agent,mcp
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: pykakasi>=2.3
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.0; extra == "mcp"

# ynosis-agent

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

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

## CLI

```bash
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 の別パッケージ。

```text
npx -y ynosis-agent-mcp
```

```json
{
  "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 からも起動しません。

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

```json
{
  "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 公開

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

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