搜尋司法院裁判書系統。

結果自動按法院權威性排序（最高法院→高等法院→地方法院），同層級按原始排序。 每筆結果含 court（法院名稱）、case_type（民事/刑事/行政）、court_level（1=最高/2=高等/3=地方）。

【重要】查特定案號時，必須用 case_word + case_number（精確查詢），不要把案號放在 keyword。 例如查「114年度上易字第503號」→ case_word="上易", case_number="503", year_from=114。 keyword 僅用於主題式全文檢索（如「預售屋 遲延交屋」）。

【進階實務研究欄位】:

• main_text: 裁判主文關鍵字 — 最有效的輸贏方篩選方式。 主文措辭高度制度化（依民刑訴訟法條生成），substring match 接近 解析半結構化欄位，精度高：

  • 「被告應將 移轉」→ 被告敗訴（物權移轉類）

  • 「被告應給付」→ 被告敗訴（金錢給付類）

  • 「原告之訴駁回」→ 原告敗訴

  • 「上訴駁回」→ 維持原審 可與 keyword 併用，例： 找「借名登記成立、被告敗訴」→ main_text="被告應將 移轉", keyword="借名登記", case_type="民事"

Args: keyword: 全文檢索關鍵字（對應 jud_kw） court: 法院名稱（如「最高法院」「臺灣高等法院」「臺灣臺北地方法院」） case_type: 案件類型（民事/刑事/行政/懲戒） year_from: 起始年度（民國年，如 110） year_to: 截止年度（民國年，如 113） case_word: 字別（如「台上」「上易」「重訴」），查特定案號時必填 case_number: 案號（數字），查特定案號時必填 main_text: 裁判主文關鍵字（對應 jud_jmain）— 結構化篩選輸贏方 max_results: 回傳筆數上限（預設 10，上限 200）

Returns: 包含搜尋結果的字典：success, query, total_count, results, cached, timestamp

取得單一裁判書全文。

支援兩種查詢方式：

1. 以 JID 查詢（優先使用 Open Data API）

2. 以 URL 查詢（直接載入頁面）

Args: jid: 裁判書 JID（如「TPSV,104,台上,472,20150326,1」），從搜尋結果取得 url: 裁判書 URL（如 https://judgment.judicial.gov.tw/FJUD/printData.aspx?id=...）

Returns: 包含裁判書全文的字典：case_id, court, date, main_text, facts, reasoning, cited_statutes, cited_cases, full_text, source_url

查詢全國法規資料庫的法規條文。

可查詢單一條文、條號範圍、或法規全文。

Args: law_name: 法規名稱（如「民法」「勞動基準法」），會自動轉換為 pcode pcode: 法規代碼（如「B0000001」），若提供 law_name 可不填 article_no: 條號（如「184」「247-1」「15-1」），查詢單一條文 from_no: 起始條號（如「184」），查詢條號範圍時使用 to_no: 截止條號（如「198」），查詢條號範圍時使用 include_history: 是否包含修法沿革（使用者詢問修法歷程、修正時間、歷次修正內容時設為 True）

Returns: 包含法規條文的字典：law (pcode, name, status), articles, source_url, history（選填）

將法規名稱轉換為全國法規資料庫的 pcode 代碼。

涵蓋 11,700+ 部法規（法律 + 命令），支援模糊比對。

Args: law_name: 法規名稱（如「民法」「勞基法」「消保法」）

Returns: 包含 pcode 的字典，或模糊比對建議

以關鍵字搜尋法規名稱。

在完整法規清單（11,700+ 部）中搜尋，回傳符合的法規名稱與 pcode。 結果按現行法規優先排序，每頁 50 筆。

Args: keyword: 搜尋關鍵字（如「勞動」「消費」「智慧財產」） offset: 分頁偏移（從第幾筆開始，預設 0） exclude_abolished: 排除已廢止法規（預設 False，已廢止法規仍可搜尋但標記狀態）

Returns: 符合關鍵字的法規列表

取得司法院大法官解釋（釋字第 1-813 號）或憲法法庭裁判（憲判字）全文。

預設層（字號/日期/爭點/解釋文）從本地快取即時回傳，無需連網。 理由書/意見書支援全文模式與關鍵字片段模式。

case_id 格式（自動解析）：「釋字第748號」「釋字748」「748」 「111年憲判字第1號」「111憲判1」

Args: case_id: 解釋/裁判字號字串 include_reasoning: 回傳理由書全文（最多 15000 字） reasoning_keyword: 在理由書中搜尋關鍵字並回片段（覆蓋 include_reasoning） include_opinions: 回傳意見書全文 opinions_keyword: 在意見書中搜尋關鍵字並回片段

列舉大法官解釋 / 憲法法庭裁判。支援關鍵字全文搜尋（搜爭點 + 理由書）。

每筆結果帶 case_id，可直接傳給 get_interpretation()。

Args: keyword: 關鍵字（標題/字號/爭點/理由書全文匹配） year: 篩選民國年度（0=不篩選，>0 只回新制憲判字） number_from: 起始號次（含），0=不篩選 number_to: 截止號次（含），0=不篩選 include_old: 包含舊制釋字（year=0 時才生效） include_new: 包含新制憲判字 max_results: 回傳筆數上限（預設 30）

從大法官解釋/憲判字的理由書中抽取所有引用的其他釋字/憲判字字號。

追溯方向：查詢指定裁判引用了哪些先前裁判（往前追溯）。

Args: case_id: 解釋/裁判字號字串（格式同 get_interpretation） include_context: 每個引用附上原文前後 80 字片段