API / FOR AI & BUILDERS
Usable from ChatGPT,
Grok and Claude.
Todo el contenido de la guía está disponible mediante JSON estático, una API REST (OpenAPI 3.1) y MCP (Model Context Protocol). Nada depende de la cuenta ni de la clave de un proveedor de IA concreto.
1. JSON estático (funciona en cualquier sitio)
Datos de solo lectura publicados con el sitio, legibles por ChatGPT, Grok o Claude con navegación, o por su propio código. Índice: /api/v1/index.json; resumen orientado 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)
Búsqueda, calculadoras y sincronización del estado de aprendizaje. Especificación: /openapi.json. En los GPT personalizados de ChatGPT, importe esta URL como Action. Para Grok o Claude, use la misma especificación para definir funciones o herramientas.
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 de Claude, ChatGPT y Grok compatibles)
Funciona por stdio y por HTTP (Streamable HTTP en /mcp). Herramientas: 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 y 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 3Todo es texto en Git (`src/content/`, `research/`). Cualquier agente de IA puede seguir `AGENTS.md` en el repositorio para contribuir bajo las mismas reglas.
5. Infraestructura común de Airffic
El inicio de sesión usa la cuenta compartida de Airffic (Supabase Auth). Los elementos guardados, el estado de lectura, las comprobaciones y las notas se sincronizan solo como registro propio del usuario mediante `inspection_pull` / `inspection_push`. Las personas y organizaciones reutilizan los registros compartidos. El cambio en la base de datos está en revisión como PR #29 de common-infra y se aplicará en producción solo tras la aprobación del fundador; hasta entonces los registros permanecen en este dispositivo.
Para comprobar hasta qué punto las apps y los SDK de drones admiten realmente una función, vea cómo contrastar las funciones de las apps de DJI con la compatibilidad del SDK en la guía Aerial.
El material de logística se puede buscar con la búsqueda en toda la guía de Logística.
Para enviar datos de drones a la API principal de Airffic World, lea la guía para desarrolladores y la API de telemetría para enviar datos de drones (en japonés).
Para invocar el diseño de aeronaves desde un asistente de IA, vea cómo conectar Claude, ChatGPT o Grok al diseño de aeronaves mediante MCP u OpenAPI.