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 件までとし、実際の総数は常に表示されます。