Dati / API e agenti AI

API e agenti AI

Oltre alla mappa, i dati di FlyItalyADSB sono interrogabili programmaticamente: una REST API per sviluppatori e un server MCP (Model Context Protocol) che permette ad agenti AI come Claude o ChatGPT di rispondere a domande sul traffico aereo in tempo reale, ovunque nel mondo.

REST API

Base URL https://api.flyitalyadsb.com/v2, risposte JSON, autenticazione via header X-Api-Key.

GET /icao/{hex} Un aeromobile per indirizzo ICAO a 24 bit.
GET /callsign/{callsign} Un aeromobile per nominativo/numero di volo.
GET /reg/{reg} Un aeromobile per marche di registrazione.
GET /lat/{lat}/lon/{lon}/dist/{km} Tutti gli aeromobili in un raggio da un punto, record completi — funziona ovunque nel mondo, non solo in Italia.
GET /mil Traffico militare attualmente tracciato.
GET /pia Aeromobili con indirizzo ICAO privato (Privacy ICAO Address).
GET /ladd Aeromobili nel programma FAA Limiting Aircraft Data Displayed.

Limite: 300 richieste/minuto per IP. Le richieste senza X-Api-Key vengono respinte a livello edge.

Server MCP per agenti AI

Il Model Context Protocol è lo standard con cui assistenti come Claude o ChatGPT chiamano strumenti esterni. Il nostro server espone tre tool in sola lettura su https://flyitalyadsb.com/mcp:

find_aircraft Cerca un aeromobile per hex ICAO, callsign o registrazione.
aircraft_near Tutti gli aeromobili in un raggio da un punto (o da un aeroporto italiano per nome), con record completi — il tool più usato.
special_traffic Traffico militare, PIA (privacy) o LADD attualmente tracciato.

Per collegarlo, aggiungi l'URL come connector nel tuo client MCP (es. Claude.ai → Settings → Connectors), con la tua X-Api-Key quando richiesta: 

POST https://flyitalyadsb.com/mcp
Content-Type: application/json
X-Api-Key: <la-tua-chiave>

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"aircraft_near","arguments":{"airport":"FCO","limit":5}}}

Ottieni una API key

REST API e server MCP condividono la stessa chiave, passata nell'header X-Api-Key. Istantanea e gratuita: inserisci un'email, la chiave arriva lì — non compare mai in questa pagina. Se richiedi di nuovo con la stessa email, quella vecchia smette di funzionare e ne ricevi una nuova (è anche il modo per recuperarla se l'hai persa).