API / FOR AI & BUILDERS
Usable from ChatGPT,
Grok and 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 自定义 GPT 中,可将此 URL 作为 Action 导入。对于 Grok 或 Claude,可用同一份规范定义函数/工具。
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 公共基础设施
登录使用共享的 Airffic 账户(Supabase Auth)。收藏、阅读状态、检查项和笔记仅作为用户本人的记录,通过 `inspection_pull` / `inspection_push` 同步。人员和组织复用共享记录。数据库变更正作为 common-infra PR #29 接受审查,仅在创始人批准后才会应用到生产环境;在此之前,记录仅保存在本设备上。
要确认无人机应用和 SDK 对某项功能的实际支持程度,请参阅对照 SDK 支持情况核查 DJI 应用功能(航拍指南内)。
物流资料可以使用物流指南的全站搜索。
要将无人机数据发送到 Airffic World 主 API,请阅读用于发送无人机数据的开发者指南和遥测 API(日语)。
要从 AI 助手调用机体设计,请参阅通过 MCP 或 OpenAPI 将 Claude、ChatGPT 或 Grok 连接到机体设计。