Normattiva Open Data: cos’è e come usarlo con Claude Code o Codex

Normattiva Open Data: cos’è e come usarlo con Claude Code o Codex

Normattiva Open Data espone la normativa statale con API pubbliche. Claude Code e Codex possono usarle attraverso una skill che guida ogni passaggio.

Accesso: il servizio non richiede account, chiave API, email, cookie o SPID. L’agente invia le richieste direttamente.

,

Che cos’è Normattiva Open Data

È il servizio di dati aperti collegato a Normattiva, la banca dati pubblica della normativa statale. Documentazione e specifiche sono su dati.normattiva.it.

Il servizio offre ricerche, esportazioni di singoli atti e collezioni preconfezionate. Ogni esportazione indica la modalità: originale, vigente o multivigente.

Come funziona una esportazione

Lo scaricamento di un atto segue un flusso asincrono in più passaggi:

  1. una ricerca avanzata individua l’atto con tipo, data e numero;
  2. l’agente controlla che il risultato sia proprio l’atto richiesto;
  3. una nuova ricerca asincrona chiede l’esportazione nel formato scelto;
  4. una conferma avvia la preparazione del file;
  5. l’agente controlla lo stato fino al file pronto e scarica lo ZIP.

La risposta finale può arrivare come reindirizzamento con l’indirizzo del file. Per questo la skill legge ogni risposta senza seguire i reindirizzamenti in automatico.

Claude Code e Codex

Claude Code e Codex lavorano sul tuo computer e possono inviare richieste HTTP. La skill LeLeggi spiega all’agente il flusso e i controlli da eseguire.

Claude Code legge le skill personali da ~/.claude/skills/. Codex le legge da ~/.agents/skills/.

Python resta facoltativo. Serve per il programma alternativo della skill e per le copie in Markdown, se già installato.

I controlli sui file

  • verifica del certificato TLS, sempre attiva;
  • controllo di identità dell’atto prima dell’esportazione;
  • apertura e verifica di ogni archivio ZIP;
  • impronta SHA-256 dei file, quando lo strumento è disponibile;
  • manifest con data richiesta, data di acquisizione ed esito.

Uno ZIP vuoto non conta come successo. La skill conserva lo stato e riprende la stessa richiesta.

Come iniziare

La pagina della skill LeLeggi contiene il messaggio da incollare nell’agente. L’agente legge le istruzioni, verifica il file e lo installa dopo la tua conferma.

Gli esempi di richieste sono nell’articolo Come scaricare tutte le leggi italiane con l’IA.

Scarica la skill LeLeggi

LeLeggi è un progetto di IAperAvvocati.it. Il download è libero e non richiede registrazione. La pagina contiene il messaggio da incollare nell’agente e le condizioni d’uso.

Vuoi creare skill come questa?

Nel Workshop e nel Master parti da un’esigenza dello studio e scrivi le istruzioni per l’agente.