Airffic InspectionO guia para o futuro da inspeção com drones

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 3

Tudo é 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.