Documentazione di notarum

Ogni istanza serve la propria documentazione su /docs, costruita a partire dallo stesso contratto OpenAPI con cui risponde l’API: non può invecchiare. Questa pagina è la mappa.

Le tre fonti

La Gazzetta Ufficiale

Ciò che è stato pubblicato ogni giorno, per sezione e data. La norma com’è uscita. Serve quando conta la data, o quando serve il testo pubblicato esatto e i suoi allegati.

Normativa nazionale — InfoLEG

La norma com’è oggi, con le sue modifiche. Serve quando sai già quale legge vuoi: ley 24240 la trova senza data.

Normativa provinciale — SAIJ

Ciò che la Gazzetta nazionale non pubblica: 24 province, 81.000 norme dal 1855. Filtrabile per giurisdizione e per vigenza.

Sapere quale ha la risposta è metà del lavoro: c’è una rotta che le interroga tutte.

L’API

Sola lettura, JSON, con contratto OpenAPI su /v1/openapi.json.

Rotta	Che cosa restituisce
GET /v1/todo	La stessa ricerca sulle tre fonti, etichettata per origine
GET /v1/ediciones/{seccion}/{fecha}	Il sommario di un’edizione, con i suoi avvisi
GET /v1/avisos/{seccion}/{id}/{fecha}	Un avviso, con il testo integrale
GET /v1/anexos/…	Gli allegati PDF di un avviso
GET /v1/buscar	Ricerca testuale sulla Gazzetta
GET /v1/calendario/{anio}/{seccion}	Quali giorni hanno avuto edizione
GET /v1/nacional	Cerca nelle 428.000 norme nazionali
GET /v1/nacional/{id}	Una norma nazionale
GET /v1/nacional/{id}/modificada-por	Quali norme hanno modificato questa
GET /v1/nacional/{id}/modifica-a	Quali norme ha modificato questa
GET /v1/nacional/novedades?desde=	Che cosa è comparso da una data
GET /v1/provincial	Cerca la normativa provinciale, per provincia e vigenza
GET /v1/provincial/{id}	Una norma provinciale
GET /v1/provincial/novedades?desde=	Che cosa è comparso da una data
GET /v1/salud	Stato del servizio. Mai chiuso, mai limitato

L’autenticazione è un token creato dal tuo account. Se l’intestazione arriva senza la parola Bearer ma con il prefisso ntrm_ proprio di notarum, viene accettata lo stesso: incollare il token sopra un campo che diceva già Bearer TU_TOKEN è un errore che costa un pomeriggio, e il segreto è il token, non la parola.

Che cosa vuol dire «nuovo»

novedades risponde ciò che notarum non aveva visto, non ciò che è recente. I portali aggiungono norme vecchie di continuo, e una legge del 1998 che compare oggi è una novità per chi segue il catalogo. Filtrare per la data della norma le perderebbe in silenzio. La risposta dice anche se il registro arriva fino alla data chiesta: completo: false significa che la risposta è incompleta, non che non sia successo nulla.

MCP per i modelli

Un server MCP su JSON-RPC 2.0, su /mcp per un client remoto o via standard input/output per uno locale.

{
  "mcpServers": {
    "notarum": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/diegoparras/notarum:latest", "mcp"]
    }
  }
}

Gli strumenti coprono le tre fonti: buscar_todo, edicion, aviso, buscar, calendario, rubros, nacional_buscar, nacional_norma, nacional_relaciones, nacional_tipos, provincial_buscar, provincial_norma, provincial_tipos, novedades ed estado. Ognuno spiega che cosa manca invece di restituire una lista vuota: un modello che riceve una lista vuota conclude che non c’è niente e tira dritto.

Avvisi

Una ricerca salvata che gira dopo ogni aggiornamento e consegna solo le novità.

• Scegli la fonte, che cosa aspettare e dove mandarlo: un webhook n8n, un feed Atom, o semplicemente la tua pagina account.
• Il primo passaggio non notifica nulla. Inaugurare un avviso su un tema vecchio manderebbe di colpo tutto ciò che esiste dal 1993, il modo più rapido per farlo cancellare.
• Ciò che smette di corrispondere viene dimenticato: se torna, è di nuovo una novità.
• I webhook che puntano a reti interne vengono rifiutati — loopback, intervalli privati, link-local e l’intervallo dei metadati dei cloud — e i redirect non vengono seguiti. L’indirizzo lo mette chi crea l’avviso, ed è notarum ad andarlo a chiamare.

Costruire la query

Ogni rotta di /docs ha un pannello che costruisce la query: inserisci i valori ed escono l’URL, la riga curl e un nodo HTTP Request di n8n valido, pronto da incollare.

Senza modelli di mezzo

Il nodo n8n è costruito da notarum a partire dal proprio contratto, non generato da un modello linguistico. È sempre valido, non costa nulla e non richiede alcuna chiave. L’assistente resta per ciò che non si può mettere a modello: una richiesta in linguaggio naturale che combina più rotte.

Che cosa coprono i dati

Misurato sui cataloghi pubblicati, non supposto:

Norme nazionali	428.380
Con testo integrale pubblicato da InfoLEG	circa il 7% — per il resto, la scheda e il collegamento
Relazioni di modifica	382.373 su 103.560 norme; 3,7 in media
La norma più modificata	Legge 14250 (contratti collettivi), 42.427
Norme provinciali	81.403, di 24 giurisdizioni dal 1855
Sezioni della Gazzetta lette	3 — la quarta sono registrazioni di domini .ar, non normativa

Gli elenchi di modifiche sono limitati alle 200 più recenti, con il totale reale sempre in vista.

Non è una fonte ufficiale

notarum legge dati pubblici e rimanda a essi. Non ha legami con la Gazzetta Ufficiale, InfoLEG o il Ministero della Giustizia, e non sostituisce il testo ufficiale. Per qualsiasi cosa con effetto giuridico, consulta la fonte che indica.