Dati
Citoyen per agenti IA e sviluppatori
I dati di Citoyen possono leggerli anche gli assistenti IA e i programmi, non solo le persone sullo schermo. Un server pubblico, in sola lettura, fornisce le stesse serie delle schede, ciascuna con il suo produttore ufficiale, il periodo e l'unità, così una risposta può dire da dove viene un numero.
Il server MCP
Il Model Context Protocol (MCP) è lo standard con cui assistenti come Claude o ChatGPT chiamano strumenti esterni. Il server di Citoyen è gratuito, non richiede chiave né account e si limita a leggere: non conserva nulla delle domande poste, conta solo le chiamate per mantenere il servizio disponibile.
Indirizzo del server
https://citoyenapp.com/mcpCome collegarlo
In Claude
Su claude.ai o nell'app desktop: Impostazioni, Connettori, Aggiungi connettore personalizzato, poi incollate l'indirizzo del server.
In altri assistenti
ChatGPT in modalità sviluppatore e gli altri assistenti che accettano server MCP remoti: aggiungete un connettore HTTP con l'indirizzo del server.
In un editor di codice
Cursor, VS Code, Claude Code e strumenti simili: aggiungete il server alla loro configurazione MCP, come qui sotto.
Configurazione per i client che leggono un file MCP:
{
"mcpServers": {
"citoyen": {
"type": "http",
"url": "https://citoyenapp.com/mcp"
}
}
}Gli strumenti
- search
- Trova gli indicatori con il loro codice, i paesi nominati nella domanda e le pubblicazioni collegate.
- get_series
- La serie di un indicatore per un paese, come la mostra la sua scheda: valori per periodo, unità, produttore e link alla fonte. Ultimi 10 anni per impostazione predefinita.
- compare_countries
- Un indicatore per 2-8 paesi, da un'unica fonte armonizzata perché i valori siano confrontabili.
- get_ranking
- Tutti i paesi coperti in classifica su un indicatore, per l'ultimo periodo in comune, dal valore più alto al più basso.
- get_publication
- I punti chiave di una nota di sintesi, di un'analisi o di una scheda di riforma, con il link al testo completo.
- get_release_calendar
- Le prossime pubblicazioni delle serie: date ufficiali del produttore o finestre stimate.
Limiti e regole
- 60 chiamate al minuto per indirizzo. Oltre, il server chiede di riprovare tra poco.
- Le serie coprono 10 anni per impostazione predefinita (fino a 80 su richiesta, al massimo 600 punti per risposta); un confronto riguarda da 2 a 8 paesi.
- Le serie di produttori privati, e le serie militari che il SIPRI pubblica tramite la Banca mondiale, danno solo l'ultimo valore e il link alla scheda: le loro condizioni non consentono di trasmettere la serie completa.
- Le pubblicazioni danno i punti chiave e il link, mai il testo completo.
- I valori indicati come proiezioni sono previsioni, mai dati osservati.
- Ogni risposta nomina il suo produttore: citatelo, con il link alla pagina di Citoyen indicata nella risposta.
- Le chiamate sono contate per giorno con una chiave anonima derivata dall’indirizzo IP, che cambia ogni giorno; l’indirizzo non viene mai conservato e i conteggi sono tenuti 30 giorni.
Altri accessi
- Ogni pagina di indicatore offre la sua serie in CSV: aggiungete /data.csv al suo indirizzo (tranne le serie di produttori privati).
- Una mappa del sito in testo semplice per i crawler IA: /llms.txt
- Ogni scheda può essere incorporata in un altro sito con il suo pulsante « Incorpora ».
Come citare
Citate il produttore ufficiale indicato con ogni dato, e Citoyen come luogo in cui è stato letto, con il link alla sua pagina.
Le selezioni, i controlli e i testi di Citoyen sono protetti, e l'estrazione sistematica della sua banca dati non è consentita. I dettagli: Note legali
