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/mcp

Come collegarlo

  1. In Claude

    Su claude.ai o nell'app desktop: Impostazioni, Connettori, Aggiungi connettore personalizzato, poi incollate l'indirizzo del server.

  2. 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.

  3. 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