Documentación de notarum

Cada instancia sirve su propia documentación en /docs, armada desde el mismo contrato OpenAPI con el que contesta la API: no puede quedar desactualizada. Esta página es el mapa.

Las tres fuentes

El Boletín Oficial

Lo que se publicó cada día, por sección y fecha. La norma como salió. Sirve cuando importa la fecha, o cuando hace falta el texto tal como se publicó y sus anexos.

Normativa nacional — InfoLEG

La norma como está hoy, con sus modificaciones. Sirve cuando ya sabés qué ley querés: ley 24240 la encuentra sin fecha.

Normativa provincial — SAIJ

Lo que el Boletín nacional no publica: 24 provincias, 81 mil normas desde 1855. Se filtra por jurisdicción y por si siguen vigentes.

Saber cuál tiene tu respuesta es la mitad del trabajo, así que hay una ruta que le pregunta a las tres.

La API

De sólo lectura, JSON, con contrato OpenAPI en /v1/openapi.json.

Ruta	Qué devuelve
`GET /v1/todo`	La misma búsqueda en las tres fuentes, marcada por origen
`GET /v1/ediciones/{seccion}/{fecha}`	El sumario de una edición, con sus avisos
`GET /v1/avisos/{seccion}/{id}/{fecha}`	Un aviso, con su texto entero
`GET /v1/anexos/…`	Los anexos en PDF de un aviso
`GET /v1/buscar`	Búsqueda de texto sobre el Boletín
`GET /v1/calendario/{anio}/{seccion}`	Qué días hubo edición
`GET /v1/nacional`	Busca en las 428 mil normas nacionales
`GET /v1/nacional/{id}`	Una norma nacional
`GET /v1/nacional/{id}/modificada-por`	Qué normas modificaron a ésta
`GET /v1/nacional/{id}/modifica-a`	A qué normas modificó ésta
`GET /v1/nacional/novedades?desde=`	Qué apareció desde una fecha
`GET /v1/provincial`	Busca normativa provincial, por provincia y vigencia
`GET /v1/provincial/{id}`	Una norma provincial
`GET /v1/provincial/novedades?desde=`	Qué apareció desde una fecha
`GET /v1/salud`	Estado del servicio. Nunca se cierra ni se limita

La autenticación es un token que se crea desde la cuenta. Si el encabezado llega sin la palabra Bearer pero con el prefijo ntrm_ propio de notarum, se acepta igual: pegar el token encima de un campo que ya decía Bearer TU_TOKEN es un error que cuesta una tarde, y el secreto es el token, no la palabra.

Qué quiere decir «nuevo»

novedades contesta lo que notarum no había visto, no lo que es reciente. Los portales agregan normas viejas todo el tiempo, y una ley de 1998 que aparece hoy es una novedad para quien sigue el catálogo. Filtrar por la fecha de la norma se las perdería en silencio. La respuesta además dice si el registro llega hasta la fecha pedida: un completo: false significa que la respuesta está incompleta, no que no pasó nada.

MCP para modelos

Un servidor MCP sobre JSON-RPC 2.0, en /mcp para un cliente remoto o por entrada y salida estándar para uno local.

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

Las herramientas cubren las tres fuentes: buscar_todo, edicion, aviso, buscar, calendario, rubros, nacional_buscar, nacional_norma, nacional_relaciones, nacional_tipos, provincial_buscar, provincial_norma, provincial_tipos, novedades y estado. Cada una explica qué falta en vez de devolver una lista vacía: un modelo que recibe una lista vacía concluye que no hay nada y sigue de largo.

Alertas

Una búsqueda guardada que corre después de cada actualización y entrega sólo lo nuevo.

Elegís la fuente, qué esperar y a dónde mandarlo: un webhook de n8n, un feed Atom, o tu propia cuenta.
La primera pasada no avisa nada. Estrenar una alerta sobre un tema viejo mandaría de golpe todo lo que existe desde 1993, que es la forma más rápida de que la borres.
Lo que deja de coincidir se olvida: si vuelve a aparecer, vuelve a ser novedad.
Se rechazan los webhooks que apuntan a redes internas —loopback, rangos privados, link-local y el rango de metadatos de las nubes— y no se siguen redirecciones. La dirección la pone quien crea la alerta y notarum es el que sale a buscarla.

Armar la consulta

Cada ruta de /docs trae un panel que arma la consulta: ponés los valores y salen la dirección, la línea de curl y un nodo HTTP Request de n8n válido, listo para pegar.

Qué cubren los datos

Medido contra los catálogos publicados, no supuesto:


Normas nacionales	428.380
Con texto completo publicado por InfoLEG	alrededor del 7% — del resto, la ficha y el enlace
Relaciones de modificación	382.373 sobre 103.560 normas; 3,7 en promedio
La norma más modificada	Ley 14250 (convenios colectivos), 42.427
Normas provinciales	81.403, de 24 jurisdicciones desde 1855
Secciones del Boletín que se leen	3 — la cuarta son altas de dominios `.ar`, no normativa

Las listas de modificatorias se acotan a las 200 más nuevas, y siempre se muestra el total real.