조선왕조실록 検索

このスキルがすること

国史編纂委員会の조선왕조実録サイト(https://sillok.history.go.kr)から公式検索結果HTMLと記事詳細ページを直接読み込んで조선왕조実録の記録を検索します。

v1の範囲は単純なスクレイピングです。

• キーワード検索
• オプショナルな王別フィルター(--king)
• オプショナルな西暦年フィルター(--year)
• 検索結果のタイトル/要約/原文リンクの整理
• 記事詳細ページから国訳/原文excerptの抽出

いつ使うか

• 「조선왕조실록で訓民正音を探してほしい」
• 「世宗の時代の実録から測雨器関連の記事を検索してほしい」
• 「1443年の조선왕조実録の記録を探してほしい」
• 「正祖実録で水原関連の記録をいくつか見せてほしい」

必要条件

• インターネット接続
• python3
• 別途APIキーなし
• インストール済みのskill payloadにscripts/sillok_search.pyヘルパーが含まれている

入力値

• 必須: 検索キーワード
• オプション: 王の名前(世宗、正祖、世宗実録など)
• オプション: 西暦年(1443のようなGregorian year)
• オプション: 結果数(--limit)
• オプション: 検索タイプ(--type k|w)
  • k: 国訳検索
  • w: 原文検索

ワークフロー

1. python3 scripts/sillok_search.py --query "..."で公式検索endpointを呼び出す
2. 検索結果HTMLから結果数、王別分類、記事リンク、要約をパースする
3. 必要に応じて--king、--yearで結果をさらに絞り込む
4. 選択された各記事の/id/<article_id>詳細ページを開いて国訳/原文excerptを取得する
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

レスポンスポリシー

• 結果は公式実録サイトで確認した記事タイトル + リンク + 要約 + 詳細excerptを中心に答える
• --yearは西暦年を基準にフィルタリングする
• 入力された王の名前は世宗、世宗実録のようにやや異なっていても正規形の王名に正規化する
• v1ではsemantic search、embedding、大規模索引の構築は行わない
• 結果がない場合は無理に推定せず、空の結果そのままを通知する

完了条件

• 公式サイトから実際の検索結果が1件以上取得された
• 必要に応じて王/年度フィルターが適用された
• 少なくとも1つ以上の記事詳細excerptが含まれている
• リンクがhttps://sillok.history.go.kr/id/...の形式で整理されている

注釈

• 公式メイン: https://sillok.history.go.kr
• 検索endpoint: https://sillok.history.go.kr/search/searchResultList.do
• 記事詳細: https://sillok.history.go.kr/id/<article_id>
• このリポジトリv1は公開HTML表面のみを使用します