search_legal_interpretations_advanced
Search Taiwan's judicial interpretations database by date range and document type. Start with a category overview, then refine results using any category name.
Instructions
進階搜尋司法院法令判解系統,支援日期範圍篩選和文件類型過濾。
核心機制說明
本工具採用「兩階段查詢」設計:
第一階段:送出查詢條件(日期、關鍵字),取得 categories 統計
第二階段:根據 categories 的類型名稱,精確篩選結果
重要:categories 中的 "name" 欄位值,可以直接用於 doc_types 參數!
推薦工作流程(兩次查詢)
第一次查詢(探索):
search_legal_interpretations_advanced(
date_from="114/1/1",
date_to="114/12/31",
doc_types=None # 不指定類型
)
回傳:
categories: [
{"ty": "Q", "name": "法律問題", "count": 80},
{"ty": "D", "name": "決議", "count": 0},
{"ty": "J", "name": "精選裁判", "count": 197},
...
]第二次查詢(精確取得):
search_legal_interpretations_advanced(
date_from="114/1/1",
date_to="114/12/31",
doc_types=["法律問題"], # 直接使用 categories 的 name 值
max_results=100 # 調高上限以取得全部 80 筆
)
回傳:
全部 80 筆「法律問題」類型的結果使用範例
範例 1:查詢 96 年所有決議
# 步驟 1:先查看有多少筆
result1 = search_legal_interpretations_advanced(
date_from="96/1/1", date_to="96/12/31"
)
# categories 顯示:{"ty": "D", "name": "決議", "count": 20}
# 步驟 2:取得全部 20 筆決議
result2 = search_legal_interpretations_advanced(
date_from="96/1/1",
date_to="96/12/31",
doc_types=["決議"], # 使用 categories 的 name
max_results=50
)範例 2:查詢 114 年高院法律座談會 (注意:法律座談會在「法律問題」類別,不在「決議」類別)
# 步驟 1:查看 114 年有哪些類型
result1 = search_legal_interpretations_advanced(
date_from="114/1/1", date_to="114/12/31"
)
# categories 顯示:{"ty": "Q", "name": "法律問題", "count": 80}
# 步驟 2:取得全部 80 筆法律問題
result2 = search_legal_interpretations_advanced(
date_from="114/1/1",
date_to="114/12/31",
doc_types=["法律問題"],
max_results=100
)範例 3:查詢特定細分類型
# 只查民事決議(網站表單直接支援的細分類型)
result = search_legal_interpretations_advanced(
date_from="96/1/1",
date_to="96/12/31",
doc_types=["民事決議"]
)文件類型選項說明
概括類型(對應 categories 的 name,使用後篩選機制):
"憲法法庭裁判", "大法官解釋", "大法官不受理決議", "司法解釋"
"大法庭專區", "停止適用之判例", "精選裁判", "決議", "法律問題", "行政函釋"
細分類型(網站表單直接支援,使用前篩選機制):
"民事決議", "刑事決議", "家事決議", "行政決議"
錯誤處理: 如果 doc_types 包含無效值,工具會報錯並列出所有有效選項。
參數說明
Args: keyword: 關鍵字(選填),可用於縮小搜尋範圍 date_from: 起始日期,格式:民國年/月/日(如 "114/1/1") date_to: 結束日期,格式:民國年/月/日(如 "114/12/31") doc_types: 文件類型列表(使用 categories 的 name 值或細分類型),None = 全部類型 max_results: 最多回傳筆數(預設 20,上限 200),建議第二次查詢時調高以取得全部結果 offset: 跳過前幾筆(分頁用,預設 0)
Returns: {success, query, categories(各類筆數), total_count, results, cached, timestamp}
categories 結構:[{"ty": "代碼", "name": "類型名稱", "count": 筆數}, ...]
results 每筆含:doc_type, title, date, summary, ty, id, url
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | No | ||
| date_from | No | ||
| date_to | No | ||
| doc_types | No | ||
| max_results | No | ||
| offset | No |