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. |
| GET /history/{icao} | Date con storico disponibile per un aeromobile — vedi l'archivio storico. |
| GET /history/{icao}/{data} | Traccia completa (posizione, quota, velocità, prua) di un aeromobile in un giorno. |
Limite: 100 richieste/minuto per IP. Le richieste senza X-Api-Key vengono respinte a livello edge.
Uso commerciale consentito entro questo limite. Per volumi più alti, SLA o rivendita dei dati serve un accordo enterprise — contattaci.
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
quattro 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. |
| aircraft_history | Traccia storica di un aeromobile per un giorno, o le date disponibili — self-serve, solo giorni recenti. |
Come collegarlo a Claude
- Su claude.ai, apri Impostazioni → Connettori (dal menu del tuo profilo).
- Clicca "Aggiungi connettore personalizzato".
- Incolla l'URL
https://flyitalyadsb.com/mcpe dagli un nome, es. "FlyItalyADSB". - Nelle impostazioni avanzate del connettore, aggiungi un'intestazione personalizzata:
X-Api-Keycon la chiave ricevuta via email. - Salva e prova chiedendo a Claude qualcosa come "che aerei ci sono ora vicino a Roma Fiumicino?"
Mockup illustrativo — l'interfaccia reale del tuo client può variare leggermente.
Per altri client MCP
Qualunque client MCP che supporti Streamable HTTP con intestazioni personalizzate (ChatGPT, altri assistenti, codice tuo) funziona allo stesso modo — anche via chiamata raw:
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}}}Domande frequenti
Serve una API key?
Sì, sia per la REST API (api.flyitalyadsb.com/v2/*) sia per il server MCP (flyitalyadsb.com/mcp): stessa chiave per entrambi, passata nell'header X-Api-Key. È self-service e istantanea: basta un indirizzo email, la chiave arriva via email in pochi secondi, senza approvazione manuale.
Come uso il server MCP con Claude o ChatGPT?
Aggiungi https://flyitalyadsb.com/mcp come connector/MCP server nelle impostazioni del tuo client (es. Claude.ai → Settings → Connectors), fornendo la tua X-Api-Key quando richiesta. Poi puoi chiedere in chat cose come "che aerei ci sono ora su Fiumicino?" o "c'è traffico militare sopra Roma?" e l'agente chiamerà i tool automaticamente.
Cosa può fare il server MCP che la mappa non fa?
Restituisce dati strutturati (JSON) invece di una pagina web: lookup di un aeromobile per hex ICAO/callsign/registrazione, ricerca di tutti gli aeromobili in un raggio da un punto qualsiasi al mondo con record completi, e liste filtrate di traffico militare, PIA (privacy) o LADD.
La rete copre solo l'Italia?
No. FlyItalyADSB è nata in Italia ma è una rete globale con oltre 3.200 feeder diretti nel mondo: sia la REST API sia l'MCP accettano coordinate ovunque sul pianeta, non solo in Italia.
Come si confronta con altre API ADS-B aperte (adsb.fi, airplanes.live, adsb.lol...)?
Vedi il confronto fattuale su flyitalyadsb.com/dati/confronto: rate limit, requisito feeder e uso commerciale di ciascuna, messi a confronto senza giudizi di merito.
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).