tw-legal-rag

Taiwan Legal RAG：台湾法律 MCP サーバーと CLI（twlegalrag）

---

無料、登録不要、API key 不要の台湾法律 MCP サーバーです。Claude、ChatGPT、Gemini CLI、Microsoft 365 Copilot、Codex、Cursor に https://tlr.dr-legal.com.tw/mcp の URL を1つ追加するだけで、AI アシスタントが台湾の裁判書、 行政解釈、憲法法廷の裁判、計2,275万件を直接セマンティック検索し、各件に引用確認を付けます。同じバックエンドを使用する公開ソースコード CLI（twlegalrag）も提供しています。

無料、登録不要、API key 不要の台湾法律 MCP サーバーと、公開ソースコードの CLI。Legal Detective の2,200万件の裁判例を対象とするセマンティック検索インフラを基盤としています。

Taiwan Legal RAG CLI は、Legal Detective の公開 TLR エンドポイントから台湾の裁判例を取得し、お使いの AI ツールで利用できる形式にまとめます。法律上の助言を生成することはなく、LLM を呼び出すこともなく、サードパーティモデルの出力が意味的に忠実であることを保証するものでもありません。組み込みの引用チェックで確認するのは、引用された裁判例が取得したバンドルに含まれているかどうかだけです。

作者：黃思齊（Aaron Huang）弁護士、法律偵探／Dr.Legal 創設者（プロフィール）。

繁體中文：Taiwan Legal RAG CLI は、公開ソースコードのコマンドラインツールです。法律偵探が構築した台湾の裁判例2,200万件を対象とするセマンティック検索サービス（22,747,053件、2026-10-27時点）に接続し、自然言語で判決を検索して、検索結果をお使いの AI ツールに取り込めます。

データの収録範囲（統計は2026-10-27時点。本番データベースから取得）

一、法規範（法的な位階別）

位階	データ種別	件数	説明
憲法	憲法位階	7部／228条	憲法本文、増修条文、施行準備手続、戒厳令解除令などの現行規範
憲法	釈字および憲判字	872件	大法官解釈813件、憲法法廷判決59件。全国の各機関および人民を拘束する効力があります
法律	法律	1,022部／44,503条	法、律、条例または通則と命名されたもの（中央法規標準法 §2）
命令	法規命令	7,253部／128,738条	規程、規則、細則、辦法、綱要、標準または準則と命名されたもの（同法 §3）
命令	行政規則	107,771件	107機関が発布した解釈規定および裁量基準（行政手続法 §159）。対外的な法規範としての効力はありません
沿革	廃止済み法規	3,526部	法律320部、法規命令3,204部、および動員戡乱時期臨時条款などの憲法位階の規範。廃止状況を表示し、参照用に提供します

二、裁判および裁決

データ種別	件数	説明
裁判書（司法院の各級裁判所）	22,747,053件	セマンティック検索＋語彙検索＋事件番号による正確な記録取得。司法院の公開データを毎日差分同期し、事後の訂正および削除も同期して反映します
不当労働行為裁決（労働部裁決委員会）	465件	労働問題の検索時に自動的に併記し、裁決であり、裁判所の判決ではないことを明確に表示します

三、補助データ

データ種別	件数	説明
審級の関連付け（上訴チェーン）	4,378,841件	判決に case_history として付属し、主文の「破棄／棄却」フラグを含みます
行政解釈の効力履歴	84,831件	廃止／適用停止／置き換えの状況を追跡し、引用前に効力を確認できます

法規範および裁判の利用方法：裁判書と行政規則は、ホスト型 MCP のセマンティック検索および番号による正確な検索を利用します。 憲法、法律、法規命令は、dr-legal.com.tw のサイトで検索します。

裁判書は毎日差分同期されます（司法院の公開データの公開には数日の遅れがあるため、極めて新しい判決については公式サイトを確認してください）。 上記の数値は本番データベースから直接取得し、統計日を明記したものであり、推定値ではありません。

裁判書の内訳（裁判所の階層／事件種別別）

裁判所の階層	件数
地方法院	17,139,047
地方法院簡易庭	3,336,358
高等法院および分院	1,360,144
最高法院	406,325
高等行政法院	203,269
最高行政法院	124,391
地方行政訴訟庭	94,460
高雄少年および家事法院	25,442
智慧財産及商業法院	24,158
その他の専門法廷・委員会	33,459
合計	22,747,053

事件種別	件数
民事	14,593,554
刑事	7,534,335
行政	593,475
その他	25,689

行政規則の発布機関の内訳（107機関、統計日 2026-10-27）

機関	件数
財政部	10,704
内政部国土管理署	8,769
金融監督管理委員会	8,392
経済部智慧財産局	7,185
労働部	7,179
法務部	7,105
内政部	6,745
経済部	6,684
行政院環境保護署	4,467
行政院公共工程委員会	4,104
銓叙部	4,009
考試院	3,382
農業部	3,089
教育部	2,912
文化部	1,519
前司法行政部	1,432
法務部行政執行署	1,417
内政部戸政司	1,391
環境部	1,121
主計総処	721
公務員保障暨培訓委員会	690
国科会	574
文化部文化資産局	561
農業部水保署	543
司法行政部	444
考選部	429
人事行政総処	323
行政院消費者保護処	269
原子能安全委員会	229
原住民族委員会	227
行政院	227
海洋委員会	224
公平交易委員会	205
僑務委員会	184
法務部矯正署	170
外交部	135
中央選挙委員会	112
農業部林業及自然保育署	103
客家委員会	97
国家発展委員会	86
個人資料保護委員会籌備処	74
故宮博物院	59
司法院	56
大陸委員会	52
台湾高等法院検察署	41
法務部政風司	37
法務部廉政署	32
経済部能源署	28
法務部調査局	20
その他58機関（各機関20件未満）	120
合計	98,678

（機関名は行政解釈の原発布機関の記載に従っており、「行政院環境保護署」「前司法行政部」など、改編済み機関の旧名称も含みます。改編前後の機関は統合せず、元の発布経緯を保持するため別々に記載しています。）

何が違うのか

これは一般的なキーワード判決検索ツールではありません。法律探偵が長期にわたって構築してきた TLR 検索サービスに接続しています。

• 22,747,053 件の台湾の裁判データ（2026-10-27 時点）を構造化処理し、ベクトル化しています。
• 意味的な曖昧検索：事件番号や裁判所、キーワードだけに頼らず、自然言語で 「概念は近いが表現が異なる」判決を検索できます。固有名詞の検索用に、語彙の 完全一致検索モードもあります。
• 事件番号による正確な取り寄せ：裁判文書の完全な事件番号が入力されると、自動で 正確な取り寄せに切り替わります。該当がない場合は「該当なしは、その裁判が存在しない ことを意味しません」と明示し、意味的に近い結果で埋め合わせることはありません。
• 審級間の関連 case_history：判決とともに、データベースに記録された上下審級と、 主文における「破棄／棄却」のフラグを提示します。引用する前に、判決が上級審で すでに破棄されているか確認できます。
• 行政規則向けの2つのツール：事件番号による完全一致検索（効力状況：有効確認済み／ 未確認／廃止済み／適用停止／置き換え済みを表示）と意味検索を併用します。行政解釈と 判決は厳密に分けて表示し、混在させず、裁判所の見解として引用できないようにしています。 詳細は docs/mcp-anchor.zh.md をご覧ください。
• 現行法条文の完全一致検索：法令名と条番号を指定して現行条文の原文を取得し、法令の 最終改正日、廃止注記、本データベースが対応する公式データセットのバージョン日付も 併せて表示します。法条を引用する前に、条番号の存在と条文の内容を確認できるため、 モデルの記憶に頼って条文を再現する必要はありません。よく使われる略称（労働基準法、 刑法、憲法）は公式の法令名に自動で変換されます。法令コーパスは毎日、全国法規データ ベースの公式バージョン更新と照合しています。提供するのは現行の統合版のみです。行為時 の法令（改正前の旧条文）については、公式の沿革検索をご利用ください。
• 引用の保護を最優先：allowed_citations のホワイトリスト（理由全文を実際に読み込んだ 判決のみを含む）、unread_candidates の表示、各バンドルに記載される検証指示に加え、 CLI 側の citation check も備えています。法律 AI で特に問題となる幻覚、つまり 事件番号は実在するが、見解が捏造されているという事態に対応した設計です。
• 本 CLI には判決データベースが組み込まれておらず、バックエンドのモデルの重み、 ベクトルインデックス、検索パイプラインの詳細も公開していません。公開 TLR retrieval endpoint に接続するツールです。

「公式サイト wrapper」型ツールとの違い

よくある別の方式は、司法院や法規の公式サイトのサイト内検索にリアルタイムでクエリを 送ることです。両者は役割が異なり、相互に補完できます。

	公式サイト wrapper	Taiwan Legal RAG
検索方法	公式サイト内のキーワード検索	2,275 万件の独自コーパスによる意味検索。概念が近く、表現が異なっても検索可能
引用の保護	通常なし	read-whitelist + 検証指示 + citation check
事件番号による取り寄せ	公式サイトの機能による	正確に取り寄せ、該当がない場合は推測できないことを明示
審級間の関連	案件ごとに自分で追跡する必要あり	case_history を直接表示し、破棄マークも含む
利用可能性	公式サイトの WAF／改版の影響を受け、検証を回避するためにローカルでブラウザーを動かす必要があることが多い	hosted endpoint のため、ローカル環境は不要
データの即時性	公式サイトはリアルタイム	ごく最近公告された裁判については公式サイトを参照してください

公式サイト wrapper の強みは即時性と公式情報源への直接接続です。本ツールの強みは意味検索の 品質と引用の規律です。

キーワードのみを使う法律検索ツールとは異なり、Taiwan Legal RAG CLI は、台湾の裁判 判決2,200万件以上を基盤とする本番環境の意味検索バックエンドに接続し、モデルの重み、 インフラ、プライベートインデックスをサーバー側に保持しながら、概念レベルの曖昧検索を 可能にします。

（表現について：公開されているのは CLI であり、モデルやベクトルデータベースでは ありません。バックエンドの検索サービス、モデルの重み、プライベートインデックスはすべて サーバー側に保持され、本ツールとともに公開されることはありません。）

できること／できないこと

できること：自然言語で判決を検索 → 構造化された一覧、判決全文の抜粋（excerpt）、 引用リンクを取得 → バンドルにまとめて、あなた自身の AI に渡します。また、AI が生成した 回答について、バンドル単位の引用チェックも行えます。

できないこと：本ツールはいかなる LLM も呼び出さず、法律意見を生成せず、モデルの 出力を保証しません。回答の生成には、あなた自身が選んだ AI（ChatGPT / Claude / Gemini / ローカルモデル）を使用してください。

組み込みの citation check で確認できること

check はバンドル単位の、ベストエフォート方式の文字列チェックで、確認するのは次の 項目です。

• 回答で引用された判決の事件番号がバンドル内にあるか（「バンドルにない事件番号を 引用している」＝捏造の疑いを検出）。
• バンドル外の判決、または存在しない判決を引用していないか。
• 引用文の存在確認（バンドル単位）：回答で「裁判所は……と述べた」とされる逐語引用が、 バンドル内のテキストのどこかに含まれているか。

確認できないこと（重要）

• 引用文が回答で示された判決そのものに由来するか（存在確認では「バンドル全体の どこかにその文があるか」だけを調べ、特定の判決とは紐付けません）。
• 裁判所の見解を正しく読み取っているか。
• 当事者の主張（原告／被告／控訴人）を裁判所の見解として扱っていないか。
• 傍論を判決の中心的な権威ある判断として扱っていないか。
• パラフレーズ（言い換え）による見解の幻覚。

これらはすべて判決全文を読まなければ判断できません。そのため、バンドルには判決全文の 抜粋と検証指示を含め、後続のモデル自身に確認するよう求めています。pass が示すのは 「引用された事件番号がバンドルの内容と一致している」ことだけであり、「法律上の推論が 正しい」ことや「引用文が実際にその判決に由来する」ことを意味しません。 また、check が 照合するのはバンドル内の内容のみで、法律探偵のデータベース全体ではありません。 後から自分で判決全文を開いて回答を書き換えた場合でも、check はバンドル作成時に 含まれていた抜粋だけを確認します。

インストール

pip install twlegalrag

依存するのは httpx / typer / rich のみです。LLM のパッケージやキーは不要です。 本ツールは LLM を呼び出しません。

使い方

# 1) 純檢索：列出符合的判決
twlegalrag search "勞資 加班費" -n 5 --read

# 2) 打包：產生可交給任何 AI 的 bundle ★主流程
twlegalrag pack "車禍對方全責,我可以求償什麼?" -o bundle.json
#   → 把 bundle.json 貼給 ChatGPT / Claude / Gemini,要求它只引用 bundle 內的判決

# 3) 引用檢查：對任何 AI 產生的答案做 bundle 層級檢查
twlegalrag check bundle.json answer.txt

# 4) 法源查證: 法條原文與函釋效力 (零 LLM)
twlegalrag law 民法 184
twlegalrag ref "台財稅第881945861號"
twlegalrag ref-search "扣繳義務人未依限申報之處罰" -n 5

# 服務是否正常
twlegalrag health

pack が生成するバンドルには、query、各判決の citation_id（J1、J2、...）、 citation_text、citation_url、doc_id、Layer-1 listing、fulltext_excerpt （判決理由の抜粋。長さの上限あり）、case_history（データベースに記録された審級間の 関連。v1.1）、allowed_citations、および後続のモデルに対し、バンドル内の判決のみを引用し、 根拠のない命題には未検証の印を付けるよう明示する verification_instructions が含まれます。 stderr にも AI USE NOTICE が出力されます。

v1.1 から、verification_instructions には見解レベルのセルフチェック規則 （OPINION-LAYER SELF-CHECK）が追加されました。回答後、後続のモデルに次の点を一つずつ 確認するよう求めます。(a) 特定の判決に帰属させた見解が、その判決の excerpt に実際に 含まれていること（別の判決のものではなく、推論によるものでもないこと）。(b) 裁判結果の 方向（勝訴／敗訴／破棄／棄却／差し戻し）を取り違えていないこと。(c) case_history で 破棄済みと示された判決を、現在も有効な見解として引用しないこと。これは check による バンドル単位の事件番号チェックを補完するものです。事件番号が実在しても、見解が実在する とは限りません。見解レベルの確認は、全文を読んだモデルのみが行えます。これらの規則は、 その確認を各バンドルの必須指示として組み込むものです。

allowed_citations は「引用可能な判決」のホワイトリストで、理由全文を実際に読み込んだ 判決のみを含みます。CLI の pack は各判決を読み込むため、両者は一致します。 Hosted Remote MCP の search_bundle（/v1/pack）で read_top < max_results の場合、 読み込まれるのは先頭の read_top 件のみです。残りの判決も閲覧用に judgments に表示 されますが、unread_candidates に移されます（権威ある情報源ではなく、裁判所の論拠として 引用できません）。詳細は docs/mcp-anchor.zh.md をご覧ください。

設定（任意）

デフォルトでは公開エンドポイント https://tlr.dr-legal.com.tw に接続し、キーなしで利用 できます。サービス提供元から API key を受け取った場合は、環境変数または ~/.twlegalrag/config.toml（git-ignore 済み。絶対に commit しないでください）に設定 できます。

export TWLEGALRAG_TLR_BASE_URL=https://tlr.dr-legal.com.tw   # 預設
export TWLEGALRAG_TLR_API_KEY=...   # 選用；公開端點不需要，僅限服務方另行核發的企業金鑰

[tlr]
# base_url = "https://tlr.dr-legal.com.tw"
# api_key  = "..."

プライバシーとデータの流れ

まず、TLR サーバーを経由することがないものを明確にします。

• AI（Claude / ChatGPT / ローカルモデル）との会話の全内容、アップロードしたファイル、AI が生成した回答は、すべてあなたと AI プロバイダーとの間で行われ、TLR を経由することはありません。TLR は検索専用のサーバーで、受け取るのは AI クライアントが送信すると決めた検索クエリ文字列と、その後に取得する判決番号だけです。
• アカウント登録は不要です。公開 REST エンドポイントはキーなしで利用でき、本サービスにはユーザーアカウントシステムがありません。検索はアカウントの身元と紐付けられません。
• 判決データそのものは台湾の公開裁判書であり、検索で返される内容には非公開の個人情報は含まれません。

その他、必ず理解しておくべきネットワーク通信について説明します。

• あなたの検索語／質問は、判決を取得するために TLR 検索エンドポイント（https://tlr.dr-legal.com.tw）へ送信されます。
• TLR は、検索品質の分析を目的として、クエリのテキスト、タイムスタンプ、IP アドレスから推定されるメタデータ、検索結果の件数をログに記録する場合があります。個人の秘密や機密事項は送信しないでください。クエリは生成モデルのトレーニングには使用されません。 （TLR のバックエンドでは、検索品質の分析を目的として、クエリ文字列、時刻、IP アドレスから推定されるメタデータ、結果の件数が平文で記録される場合があります。個人の秘密や機密事項は送信しないでください。クエリは生成モデルのトレーニングには使用されません。）
• 本ツールはLLM を呼び出さず、サーバー側のトークンも使用しません。自分で bundle を AI に渡す場合、その通信と費用はあなたと選択した AI プロバイダーとの間で発生し、本ツールとは関係ありません。
• エンドポイントの API キー（ある場合）は環境変数に設定し、設定ファイルをコミットしないでください。

citation check の仕組み

twlegalrag/faithful/ は依存関係のない純粋関数のセットです（標準ライブラリの re と unicodedata のみを使用します）。 回答テキストと bundle 内の判決抜粋を受け取り、pass / needs_review / fail を返します。誤検知を抑えるため、設計は保守的です。不確かな場合は fail ではなく needs_review を返します。LLM を呼び出さず、データベースにもアクセスしません。決定的な文字列分析を行います。

⚠️ このディレクトリは内部プログラムのスナップショットです。含まれる一部の関数（check_party_as_court / run_all_checks など）は、CLI では使用されていません。存在するからといって、CLI が見解レベルや意味の検証を行えるわけではありません。CLI が使用するのは、そのうちの bundle レベルのチェック 2 つだけです。ファイル一覧を機能一覧とみなさないでください。詳しくは twlegalrag/faithful/VENDORED.md を参照してください。

2026-08-20 サーバー側の更新（hosted MCP / REST）

• bundle の応答に result_token が追加され、bundle 内の任意の判決の全文を直接取得できるようになりました。
• 各検索結果に hit_excerpt（該当段落のプレビュー）が追加されました。引用には引き続き理由全文を使用してください。
• get_judgment_fulltext が excerpt_offset によるページネーションに対応し、長い判決も最後まで読み込めるようになりました。
• 語句の完全一致検索モード（search_type: keyword / phrase）が強化され、固有名詞や技術用語に適しています。概念的な質問には、デフォルトの hybrid をおすすめします。

以上はサーバー側の機能で、REST と Remote MCP インターフェースでは本日から利用できます。CLI v2.1.0 も対応済みです。pack が長い判決を自動でページネーションして最後まで読み込み（bundle の各判決に対する全文の予算を 2 倍に拡大）、該当段落の hit_excerpt も bundle に含めるようになりました。

その他の接続方法（同じ TLR バックエンド）

この CLI は TLR 検索サービスに接続する方法の 1 つです。同じバックエンド tlr.dr-legal.com.tw は、Remote MCP を使って判決検索を AI ツールに直接接続することもできます。どちらも同じ MCP エンドポイント https://tlr.dr-legal.com.tw/mcp を入力します。接続時に OAuth が自動的に完了するため（動的登録、申請や API キーの設定は不要です）、手動での認証設定は必要ありません。

• Claude（Remote MCP）：Settings → Connectors → Add custom connector を選び、URL に https://tlr.dr-legal.com.tw/mcp を入力します。
• ChatGPT（MCP connector）：Connectors でカスタム MCP server を追加し、URL に https://tlr.dr-legal.com.tw/mcp を入力します。
• Gemini ウェブ版（Spark）：gemini.google.com/spark/apps を開き、 「カスタムアプリ」→「Spark 用のカスタムアプリ」に https://tlr.dr-legal.com.tw/mcp を貼り付けて、「続行」を押して認証を完了します（動的登録は自動で行われ、キーは不要です）。 Gemini Spark を利用できるアカウントが必要です。接続後、Spark の入力欄で @ と入力して「法律探偵」を選ぶと、明示的に呼び出せます。通常のチャット画面からは呼び出されません。 2026-09-01 に台湾のアカウントで動作を確認済みです。
• Gemini CLI（Remote MCP）：~/.gemini/settings.json の mcpServers に {"tlr": {"httpUrl": "https://tlr.dr-legal.com.tw/mcp"}} を追加し、起動後に /mcp auth tlr を実行して認証を完了します。 詳しい手順はユーザーガイドを参照してください。
• Microsoft 365 Copilot / Copilot Studio（MCP）：Copilot Studio または Agent Builder でエージェントに MCP ツールを追加し、Server URL に https://tlr.dr-legal.com.tw/mcp を入力します。認証には OAuth 2.0 の動的探索（dynamic discovery）を選択します。事前のアプリケーション登録は不要です。 詳しい手順はユーザーガイドを参照してください。
• Claude Code（Skill、MCP ではなく CLI を使用）：この repo には、すぐに使える skill が skills/tw-legal-rag/ に含まれています。このフォルダー全体をプロジェクトの .claude/skills/ に置くだけで使用できます。この skill は CLI の pack サブコマンドをラップし、台湾の判決や法律上の論拠について質問した際に、Claude が自動で検索し、bundle 内の citation_id のみを引用するようにします。 skill に含まれる scripts/search_judgments.py は実行ファイルを自動で特定し、Windows でよくある 2 つの問題にも対処します（詳しくは skill 内の SKILL.md を参照してください）。

Remote MCP インターフェースでは、現在 6 つのツールを利用できます。

ツール	機能	追加時期	この CLI での接続
search_bundle	検索＋理由全文の読み込みを行い、引用許可リストを含む bundle を一度に返します（おすすめの入口）	2026-06	✅
search_judgments	判決検索（構造化された一覧表示。完全な事件番号を指定すると、自動で完全一致検索に切り替わります）	2026-05	✅
get_judgment_fulltext	判決理由全文（審級間の関連 case_history を含む）	2026-05	✅
get_legal_reference	行政解釈番号の完全一致検索。効力状態も表示します	2026-08	✅ ref
search_legal_references	行政解釈のセマンティック検索	2026-08	✅ ref-search
get_law_article	現行法条の完全一致検索と条番号の照合	2026-09	✅ law

各ツールの入出力仕様については、docs/mcp-anchor.zh.md を参照してください。

本サービスは公式の MCP サーバーレジストリ に登録済みで、名称は io.github.aa0101181514/tw-legal-rag です。

CLI、MCP、Claude Code skill のいずれを使う場合も、回答を生成するのはあなた自身の AIです。本サービスが提供するのは、判決内容と検証可能な引用リンクのみです。

アーキテクチャ

你的問題
   │
[檢索]  TLR /v1/search   ──►  Layer-1 listings + result_token
   │    TLR /v1/fulltext ──►  每篇判決理由全文片段 (excerpt, 有上限)
   │
[打包]  pack ──► bundle.json (citation_id / allowed_citations / verification rules)
   │            └─► 交給你自己的 AI 工具
   │
[檢查]  check ──► bundle 層級引用檢查 (在/不在 bundle + bundle 內引文存在性)

判決データベース、embedding、検索ロジックはすべてサーバー側にあり、この repo には含まれていません。この CLI は、ソースコードが公開されたクライアント兼引用チェックツールです。

免責

本工具是分析輔助,不是法律意見,也不是律師。務必自行閱讀引用的判決全文。 透過 API 取得的判決為台灣公開裁判資料,你需為自己的使用負責。

License

v2.0.0 起採 Elastic License 2.0（ELv2）。可自由使用、複製、修改與 再散布,包含商業與企業內部使用,僅有兩項限制:不得將本軟體本身作為 託管/代管服務提供給第三人,以及不得移除授權與聲明保護。 1.2.2 以前的版本維持 MIT。

託管 API 與判決語料庫從未在程式碼授權範圍內,詳見 TERMS.md。 專案名稱與標識不在授權範圍,詳見 TRADEMARK.md。 本專案不接受外部 pull request（單一作者授權策略）,詳見 CONTRIBUTING.md。