API / FOR AI & BUILDERS

ChatGPTからも、Grokからも、
Claudeからも使える。

このガイドの中身は、静的なJSON、REST API（OpenAPI 3.1）、MCP（Model Context Protocol）の三つの入口から使える。特定のAI会社のアカウントや鍵には依存しとらんよ。

1. 静的JSON（どこでも読める）

サイトと一緒に公開される読み取り専用のデータじゃ。ChatGPT・Grok・Claude のブラウズ機能や、自前のプログラムからそのまま読める。一覧は /api/v1/index.json、AI向けの案内は /llms.txt.

curl https://inspection.airfficworld.com/api/v1/assets/bridge.json
curl https://inspection.airfficworld.com/api/v1/countries/jp.json

2. REST API（OpenAPI 3.1）

検索・計算・学習記録の同期ができる。仕様は /openapi.json。ChatGPT の GPTs の「Actions」には、この仕様のURLをそのまま読み込ませればええ。Grok や Claude からは、関数呼び出し（tool use）の定義に同じ仕様を使える。

npm start   # http://localhost:8787
curl "http://localhost:8787/v1/search?q=bridge+gnss&lang=en"
curl -X POST http://localhost:8787/v1/calc/gsd -H 'content-type: application/json' \
  -d '{"sensorWidthMm":13.2,"focalLengthMm":8.8,"imageWidthPx":5472,"distanceM":3}'

3. MCP（Claude・ChatGPT・Grok の対応クライアント）

標準入出力（stdio）と HTTP（Streamable HTTP の /mcp）の両方で動く。道具は「search_guide」「get_asset」「get_environment」「list_cases」「get_regulation」「list_country_sources」「calc_gsd」「calc_coverage」「calc_cost」。

# Claude Desktop / Claude Code (stdio)
{ "mcpServers": { "airffic-inspection": { "command": "node", "args": ["tools/mcp.mjs"] } } }

# Remote MCP (ChatGPT connectors, xAI/Grok remote tools, Claude)
https://<your-host>/mcp

4. CLI と Git

npm run cli -- search "トンネル 非GPS"
npm run cli -- asset sewer --lang en
npm run cli -- gsd --sensor 13.2 --focal 8.8 --width 5472 --distance 3

中身はすべて Git のテキスト（`src/content/`、`research/`）。どの AI エージェントも、リポジトリの `AGENTS.md` を読めば同じ規則で追記できる。

5. Airffic 共通基盤（common-infra）との接続

ログインは Airffic 共通のアカウント（Supabase Auth）。保存・読了・チェック・メモは、共通基盤の `inspection_pull` / `inspection_push` で本人の記録としてだけ同期する。人・組織は共通の記録を使い、このサイトで作り直さん。同期の DB 変更は common-infra の提案（PR #29）としてレビュー中で、本番への適用は Founder の承認後じゃ。それまでは記録はこの端末に保存されるよ。