joseon-sillok-search

조선왕조실록 검색

這個技能的功能

直接從國史編纂委員會朝鮮王朝實錄網站（https://sillok.history.go.kr）讀取官方搜尋結果 HTML 與條目詳細頁面，查找朝鮮王朝實錄記錄。

v1 範圍為單純的網頁爬取。

• 關鍵字搜尋
• 可選的君王篩選（--king）
• 可選的西元年份篩選（--year）
• 整理搜尋結果的標題、摘要、原文連結
• 從條目詳細頁面擷取國譯/原文摘錄

使用時機

• 「幫我在朝鮮王朝實錄中找訓民正音」
• 「搜尋世宗時期實錄中關於測雨器的條目」
• 「幫我找 1443 年的朝鮮王朝實錄記錄」
• 「顯示正祖實錄中關於水原的幾筆記錄」

前置需求

• 網路連線
• python3
• 無需額外 API 金鑰
• 安裝的技能負載中已包含 scripts/sillok_search.py 輔助腳本

輸入參數

• 必填：搜尋詞
• 選填：君王名稱（如 세종、정조、세종실록 等）
• 選填：西元年份（如 1443）
• 選填：結果數量（--limit）
• 選填：搜尋類型（--type k|w）
  • k：國譯搜尋
  • w：原文搜尋

工作流程

1. 使用 python3 scripts/sillok_search.py --query "..." 呼叫官方搜尋端點。
2. 從搜尋結果 HTML 中解析結果數量、君王分類、條目連結與摘要。
3. 必要時以 --king、--year 進一步縮小結果。
4. 對每個選取的條目，開啟 /id/<article_id> 詳細頁面，取得國譯/原文摘錄。
5. 以結構化 JSON 回傳。

CLI 範例

python3 scripts/sillok_search.py --query "훈민정음"
python3 scripts/sillok_search.py --query "훈민정음" --king "세종" --year 1443 --limit 3
python3 scripts/sillok_search.py --query "측우기" --king "세종실록" --limit 5
python3 scripts/sillok_search.py --query "임진왜란" --type w --limit 5

回應原則

• 回答應以官方實錄網站確認的條目標題、連結、摘要與詳細摘錄為主。
• --year 以西元年份為準進行篩選。
• 輸入的君王名稱即使略有差異（如 세종、세종실록），也會正規化為標準君王名稱。
• v1 不進行語意搜尋、嵌入向量或大規模索引建置。
• 若無結果，請如實告知空結果，不要胡亂推測。

完成條件

• 官方網站上實際查詢到至少一筆搜尋結果。
• 必要時已套用君王/年份篩選。
• 至少包含一個條目的詳細摘錄。
• 連結整理為 https://sillok.history.go.kr/id/... 格式。

備註

• 官方主頁：https://sillok.history.go.kr
• 搜尋端點：https://sillok.history.go.kr/search/searchResultList.do
• 條目詳細頁：https://sillok.history.go.kr/id/<article_id>
• 此儲存庫 v1 僅使用公開的 HTML 表面資料。