notarum 文档

每个实例都会在 /docs 提供自己的文档，由 API 应答时所依据的同一份 OpenAPI 契约生成，因此不会过时。本页是一张地图。

三个来源

官方公报

每天刊出的内容，按版块和日期组织。法规刊出时的样子。当日期重要，或者需要确切的刊出文本及其附件时使用。

国家法规 — InfoLEG

法规今天的样子，含其修改。当你已经知道要哪部法律时使用：ley 24240 无需日期即可找到。

省级法规 — SAIJ

国家公报从不刊登的内容：24 个省，自 1855 年以来 8.1 万条法规。可按辖区和是否现行有效筛选。

知道答案在哪一个来源，工作就完成了一半——所以有一条路由会同时问这三个。

API

只读，JSON，OpenAPI 契约位于 /v1/openapi.json。

路由	返回什么
`GET /v1/todo`	同一次检索在三个来源上的结果，并标注来源
`GET /v1/ediciones/{seccion}/{fecha}`	某一期的摘要及其公告
`GET /v1/avisos/{seccion}/{id}/{fecha}`	一则公告及其全文
`GET /v1/anexos/…`	某则公告的 PDF 附件
`GET /v1/buscar`	对公报的全文检索
`GET /v1/calendario/{anio}/{seccion}`	哪些日子有刊次
`GET /v1/nacional`	在 42.8 万条国家法规中检索
`GET /v1/nacional/{id}`	一条国家法规
`GET /v1/nacional/{id}/modificada-por`	哪些法规修改了这一条
`GET /v1/nacional/{id}/modifica-a`	这一条修改了哪些法规
`GET /v1/nacional/novedades?desde=`	自某日期起出现了什么
`GET /v1/provincial`	检索省级法规，可按省份与效力筛选
`GET /v1/provincial/{id}`	一条省级法规
`GET /v1/provincial/novedades?desde=`	自某日期起出现了什么
`GET /v1/salud`	服务状态。从不关闭，也不限流

认证使用从账号中创建的令牌。如果请求头没有 Bearer 这个词，但带着 notarum 自己的 ntrm_ 前缀，也会被接受：把令牌粘贴到一个原本写着 Bearer TU_TOKEN 的输入框上，是一个能白白耗掉一下午的错误，而秘密是令牌本身，不是那个词。

「新」是什么意思

novedades 回答的是notarum 此前没见过的内容，而不是最近发布的内容。这些门户随时会补录旧法规，一部 1998 年的法律今天出现在目录里，对跟踪目录的人来说就是新消息。按法规自身日期过滤会悄悄漏掉它们。响应还会说明记录是否回溯得够远：completo: false 表示答案不完整，而不是什么都没发生。

面向模型的 MCP

基于 JSON-RPC 2.0 的 MCP 服务，远程客户端用 /mcp，本地客户端走标准输入输出。

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

这些工具覆盖三个来源：buscar_todo、edicion、aviso、buscar、calendario、rubros、 nacional_buscar、nacional_norma、nacional_relaciones、nacional_tipos、provincial_buscar、 provincial_norma、provincial_tipos、novedades 和 estado。每个工具都会说明缺了什么，而不是返回一个空列表：模型拿到空列表就会断定「没有内容」，然后走开。

提醒

保存下来的检索，会在每次更新后运行，并且只推送新出现的内容。

你选择来源、要盯住什么，以及送到哪里：n8n 的 webhook、Atom 订阅源，或者就留在你的账号页面。
第一次运行不会发出任何通知。对一个老话题新建提醒，会把 1993 年以来存在的一切一次性发给你—— 这是让人立刻删掉它的最快方式。
不再匹配的内容会被忘记：如果它再次出现，那就又是新消息。
指向内网的 webhook 会被拒绝——回环地址、私有网段、链路本地地址，以及云厂商的元数据网段—— 并且不跟随重定向。地址是创建提醒的人填的，而出去发请求的是 notarum。

构建请求

/docs 中的每条路由都有一个构建面板：填入数值，就会生成 URL、curl 命令，以及一个可直接粘贴的 n8n HTTP Request 节点。

数据究竟覆盖了多少

对已发布目录实测所得，而非假设：


国家法规	428,380
InfoLEG 已发布全文的比例	约 7% —— 其余提供条目与链接
修改关系	103,560 条法规上共 382,373 条；平均 3.7
被修改最多的法规	第 14250 号法律（集体劳动合同），42,427
省级法规	81,403 条，来自 24 个辖区，自 1855 年起
读取的公报版块	3 个 —— 第四版块是 `.ar` 域名注册，不是法规

修改列表截取最新的 200 条，真实总数始终显示。