API / FOR AI & BUILDERS
Usable from ChatGPT,
Grok and Claude.
Todo o conteúdo do guia está disponível por JSON estático, por uma API REST (OpenAPI 3.1) e por MCP (Model Context Protocol). Nada depende da conta ou da chave de um fornecedor de IA específico.
1. JSON estático (funciona em qualquer lugar)
Dados somente leitura publicados com o site, legíveis pela navegação do ChatGPT, Grok ou Claude, ou pelo seu próprio código. Índice: /api/v1/index.json; visão geral orientada a IA: /llms.txt.
curl https://inspection.airfficworld.com/api/v1/assets/bridge.json
curl https://inspection.airfficworld.com/api/v1/countries/jp.json
2. API REST (OpenAPI 3.1)
Busca, calculadoras e sincronização do estado de aprendizagem. Especificação: /openapi.json. Nos GPTs personalizados do ChatGPT, importe esta URL como uma Action. Para Grok ou Claude, use a mesma especificação nas definições de funções/ferramentas.
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 (clientes Claude, ChatGPT e Grok compatíveis)
Funciona por stdio e por HTTP (Streamable HTTP em /mcp). Ferramentas: 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 e 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 3Tudo é texto no Git (`src/content/`, `research/`). Qualquer agente de IA pode seguir o `AGENTS.md` do repositório para contribuir sob as mesmas regras.
5. Infraestrutura comum Airffic
O login usa a conta Airffic compartilhada (Supabase Auth). Itens salvos, status de leitura, verificações e notas sincronizam apenas como registro próprio do usuário via `inspection_pull` / `inspection_push`. Pessoas e organizações reutilizam os registros compartilhados. A alteração no banco de dados está em revisão como PR #29 da infraestrutura comum e só será aplicada em produção após aprovação do fundador; até lá, os registros ficam neste dispositivo.
Para verificar até que ponto os aplicativos e SDKs de drones realmente suportam um recurso, veja como verificar os recursos dos aplicativos DJI em relação ao suporte do SDK no guia Aerial.
O material de logística pode ser pesquisado com a busca em todo o guia de Logística.
Para enviar dados de drones à API principal do Airffic World, leia o guia do desenvolvedor e a API de telemetria para enviar dados de drones (em japonês) (em japonês).
Para acionar o projeto de fuselagens a partir de um assistente de IA, veja como conectar Claude, ChatGPT ou Grok ao projeto de fuselagens via MCP ou OpenAPI (em inglês).