# 在庫ワン — AIエージェント向けガイド

在庫ワンは、日本の主要家電量販店のオンライン在庫・価格・都道府県別店舗在庫を横断検索する読み取り専用サービスです。

## MCP

- Endpoint: `https://zaiko.2-38.com/mcp`
- Transport: Streamable HTTP
- Authentication: 不要
- Tool: `search_inventory`
- Tool: `list_prefectures`

### search_inventory

入力:

- `query`: 商品名・型番・JAN（2〜120文字）
- `prefecture_code`: 2桁都道府県コード（例: 東京=13、広島=34）

返却:

- 各量販店の商品名・公式商品URL
- 価格・ポイント
- オンライン在庫
- 対象都道府県の店舗在庫・住所・電話・受取情報
- 検索時刻と注意事項

型番やJANを商品名に加えると誤検出を減らせます。在庫は変動するため、最終回答には公式商品URLでの確認を促してください。

## REST API

`GET https://zaiko.2-38.com/api/search?q={query}&pref={code}`

例:

`https://zaiko.2-38.com/api/search?q=MISSION%201%20PRO%20CHDHW-011-FW&pref=34`

都道府県一覧:

`GET https://zaiko.2-38.com/api/prefectures`

OpenAPI:

`GET https://zaiko.2-38.com/openapi.json`

## 推奨ワークフロー

1. 商品名だけでなく型番やJANを確認する。
2. `list_prefectures` で地域コードを確認する。
3. `search_inventory` を呼ぶ。
4. 店舗在庫あり・残りわずかを優先し、価格とオンライン在庫も比較する。
5. 公式商品URLを付け、在庫は変動するため最終確認が必要と伝える。