# caholo - AI Agent Information

> caholo は hololive OFFICIAL CARD GAME の非公式ファンメイドツール群です。
> このファイルは AI エージェントが caholo.qh.nu のサービス構造を理解するためのものです。

## Public Services

### 1. buybird — 買取価格比較
- **URL**: https://buybird.caholo.qh.nu
- **説明**: 複数店舗の買取価格を収集・比較する Web アプリケーション。
- **機能**:
  - カード一覧 (カード番号、カード名、レアリティ、各店舗の買取価格)
  - ランキング (値上がり率、最高額など)
  - SQL クエリページ (/sql) — DuckDB WASM を使ったブラウザ内クエリ実行

### 2. pos — カード在庫管理
- **URL**: https://pos.caholo.qh.nu
- **説明**: ユーザーが Google ログインし、カード在庫を管理するシステム。
- **機能**:
  - カード検索・在庫登録
  - Google OAuth 2.0 認証
- **API エンドポイント**:
  - `GET /api/v1/health` — ヘルスチェック
  - `GET /api/v1/cards` — カード一覧（在庫情報付き）
  - `PUT /api/v1/inventories/{card_no}` — 在庫登録・更新
  - `DELETE /api/v1/inventories/{card_no}` — 在庫削除
  - `GET /api/v1/me` — ユーザー情報
  - `DELETE /api/v1/me` — アカウント削除
- **認証**: Google ID Token (Authorization ヘッダー)

### 3. API — MCP + REST API
- **URL**: https://api.caholo.qh.nu
- **説明**: カードデータを提供する MCP (Model Context Protocol) / REST API。
- **MCP エンドポイント**: https://api.caholo.qh.nu/mcp
- **主な MCP ツール**:
  - `get_card` — カード番号でカード情報を取得
  - `search_cards` — 様々な条件でカード検索
  - `get_card_stats` — カードコレクションの統計情報
  - `get_available_values` — フィルタ用の有効値を取得