Ni Caselaw

@pipeworx/ni-caselaw

judiciaryni.uk からリアルタイムで取得する北アイルランドの裁判所および審判所の司法判断です。控訴院、刑事法院、王座部、家庭部、検死官裁判所、マスターの判断、評価審判所などを扱います。

Pipeworx の一部です。AI エージェントを1683以上のリアルタイムデータソースに接続するMCPゲートウェイです。

ツール

• search_ni_decisions(query?, court?, year?, limit?) — キーワード、裁判所コード（例："nica"）、年で司法判断を検索します。各結果について、タイトル、中立引用、裁判所、日付、裁判官、司法判断のPDFへのリンクを返します。
• get_ni_decision(slug) — judiciaryni.uk のスラッグで司法判断を1件取得します（例："2026-nica-36"）。完全なメタデータと pdf_url を返します。text は常に null、text_extracted は常に false です。詳細は以下をご覧ください。

認証

キーは不要です。運用者キーは必要ありません。

データソース

• https://www.judiciaryni.uk/judicial-decisions — Drupal Views の一覧です。 2026-09-18 にライブ環境で調査しました。実際にサーバー側にあるファセットは 3 つです。 /judicial-decisions/date/<year>（<year>-<month> も可）、 /judicial-decisions/type/<slug-id>、/judicial-decisions/judiciary/<id>、 さらにキーワード入力欄（?query_decisions=<text>）があります。裁判所のファセットはありません。 判決が属する裁判所は、中立引用の中と、最近の判決の大半についてはその URL スラッグ （/judicial-decisions/2026-nica-36）の中でのみ確認できます。したがって、search_ni_decisions の court フィルターは、一覧をページ送りしながらクライアント側で適用され、上流にはクエリパラメーターとして渡されません。まれな裁判所をすばやく絞り込むには、year と組み合わせてください。1 回の呼び出しで取得できるページ数には上限（20 ページ）があり、年を指定しないと、件数の少ない裁判所で十分な一致結果を見つけるまでに上限を超えるページ数が必要になることがあります。その場合は「該当する判決はこれ以上ありません」という意味ではなく、レスポンスの truncated／pages_scanned フィールドでそのことが示されます。

  query_decisions は、裁判所のフィルターではなく、コーパス全体を対象にした正規の全文検索です。"NICA" で検索すると 2,822 件が返されます。この文字列は、他の裁判所による NICA 事件の引用にも含まれているためです。ここでは、サイト独自の検索ボックスと同様に、キーワード検索専用として提供しています。

  このサイトの rss.xml は 0 件を返します。推測ではなく、ライブ環境で確認済みであり、使用していません。

  ここでは User-Agent が通常とは異なる形で重要です。「Bot」という単語を含む UA 文字列（テストしたもの："...PipeworxBot/1.0..."）は、このサイトのエッジ（Varnish）から一律で 405 を返されます。一方、通常の識別用 UA（モノレポで一般的に使われるパターンと同じ pipeworx-mcp-ni-caselaw/1.0 (+https://pipeworx.io)）なら、通常どおり 200 が返されます。これは robots.txt の問題ではありません。制限のない公開データであり、robots に関する判断も確定しています。サイトがボットをブロックしていると誤解する前に知っておくとよい WAF の癖です。

• **本文は PDF のみです。**各判決の全文は /files/judiciaryni/<yyyy-mm>/<name>.pdf にある PDF です。サイトの HTML に抽出済みテキストは含まれていません。このパックでは PDF を解析しません。このモノレポ内のどこにも PDF テキスト抽出用のヘルパーはありません（mcps/*、shared/src を確認済み）。また、PDF のみを提供する他の司法情報ソースを扱うパック（gao-protests、recap）も同じ形式で、メタデータと直接リンクを提供し、推測したり、何もないままにしたりせず、text_extracted を false に設定しています。get_ni_decision は常に text: null, text_extracted: false を返し、その説明と note フィールドでもその旨を伝えます。これはサイレントゼロ方針に沿ったもので、呼び出し元が本文がないことを必ず知らされるようにし、空のフィールドに気づくのを待つことはありません。

• 裁判所コードは、サイト上で統制された語彙ではありません。中立引用に記載されているものが使われます。ライブ環境で確認した一般的なコードは次のとおりです。nica（控訴院）、nicc（刑事法院）、nikb（王座部。2022 年の加盟以前は niqb と呼ばれていたため、古い判決ではどちらの場合もあります）、nifam（家庭部）、nicoroner（検視裁判所）、nimaster（Master の判決）、nivt（評価審判所。スラッグに年のプレフィックスがなく、例：nivt-325）。古い社会保障／児童扶養コミッショナーの判決（例："C12/25-26(PIP)"）は、明確な裁判所コードに変換できません。deriveCourt は推測せずにそのようなケースでは null を返し、court フィルターも一致しません（これは正しい動作であり、バグではありません）。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "ni-caselaw": {
      "url": "https://gateway.pipeworx.io/ni-caselaw/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/ni-caselaw/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック独自のツールとともに約 30 個の共有ツールが一覧表示されます。接続の initialize レスポンスに正確な範囲が示されており、その日の状況を確認するための信頼できる情報源です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが対象としていない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1683 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/search_ni_decisions \
  -H 'Content-Type: application/json' \
  -d '{"court":"nica","year":2026,"limit":5}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/search_ni_decisions を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "ni-caselaw": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ni-caselaw"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-ni-caselaw

stdin/stdout 経由で MCP をやり取りし、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Ni Caselaw data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT