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 不进行语义搜索、嵌入或大规模索引构建。
• 如果没有结果，如实告知空结果，不要强行推测。

完成条件

• 在官方网站上实际查询到至少 1 条搜索结果。
• 如有需要，已应用国王/年份筛选。
• 至少包含一篇以上文章的详细摘录。
• 链接整理为 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 表面。