Back to Details

joseon-sillok-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

조선왕조실록 검색

朝鲜王朝实录搜索

What this skill does

功能说明

국사편찬위원회 조선왕조실록 사이트(
https://sillok.history.go.kr
)에서 공식 검색 결과 HTML과 기사 상세 페이지를 직접 읽어 조선왕조실록 기록을 찾는다.
v1 범위는 단순 스크래핑이다.
  • 키워드 검색
  • 선택적 왕별 필터(
    --king
    )
  • 선택적 서기 연도 필터(
    --year
    )
  • 검색 결과 제목/요약/원문 링크 정리
  • 기사 상세 페이지에서 국역/원문 excerpt 추출
从国史编纂委员会朝鲜王朝实录网站（
https://sillok.history.go.kr
）中直接读取官方搜索结果HTML和文章详情页，查找朝鲜王朝实录的相关记录。
v1版本仅支持简单爬取功能：
  • 关键词搜索
  • 可选按国王筛选（
    --king
    ）
  • 可选按公元年份筛选（
    --year
    ）
  • 整理搜索结果的标题/摘要/原文链接
  • 从文章详情页提取韩文译版/原文片段

When to use

适用场景

  • "조선왕조실록에서 훈민정음 찾아줘"
  • "세종 때 실록에서 측우기 관련 기사 검색해줘"
  • "1443년 조선왕조실록 기록 찾아줘"
  • "정조실록에서 수원 관련 기록 몇 개 보여줘"
  • "帮我在朝鲜王朝实录中查找训民正音相关内容"
  • "帮我搜索世宗时期实录中有关测雨器的记载"
  • "帮我查找1443年的朝鲜王朝实录记录"
  • "给我看几条正祖实录中与水原相关的记录"

Prerequisites

前置要求

  • 인터넷 연결
  • python3
  • 별도 API 키 없음
  • 설치된 skill payload 안에 
    scripts/sillok_search.py
    helper가 함께 들어 있다.
  • 网络连接
  • python3
  • 无需额外API密钥
  • 已安装的skill包中附带
    scripts/sillok_search.py
    辅助工具

Inputs

输入参数

  • 필수: 검색어
  • 선택: 왕 이름 (
    세종
    , 
    정조
    , 
    세종실록
    등)
  • 선택: 서기 연도 (
    1443
    같이 Gregorian year)
  • 선택: 결과 수 (
    --limit
    )
  • 선택: 검색 타입 (
    --type k|w
    ) 
    • k
      : 국역 검색
    • w
      : 원문 검색
  • 必填：搜索词
  • 可选：国王名称（
    世宗
    、
    正祖
    、
    世宗实录
    等）
  • 可选：公元年份（如
    1443
    ，即公历年份）
  • 可选：返回结果数量（
    --limit
    ）
  • 可选：搜索类型（
    --type k|w
    ） 
    • k
      ：韩文译版搜索
    • w
      ：原文搜索

Workflow

工作流程

  1. python3 scripts/sillok_search.py --query "..."
    로 공식 검색 endpoint를 호출한다.
  2. 검색 결과 HTML에서 결과 수, 왕별 분류, 기사 링크, 요약을 파싱한다.
  3. 필요하면 
    --king
    , 
    --year
    로 결과를 추가로 좁힌다.
  4. 선택된 기사마다 
    /id/<article_id>
    상세 페이지를 열어 국역/원문 excerpt를 가져온다.
  5. 구조화된 JSON으로 반환한다.
  1. 执行
    python3 scripts/sillok_search.py --query "..."
    调用官方搜索接口
  2. 从搜索结果HTML中解析出结果数量、按国王分类的结果、文章链接、摘要
  3. 如有需要，通过
    --king
    、
    --year
    参数进一步筛选结果
  4. 对每篇选中的文章，打开
    /id/<article_id>
    详情页，获取韩文译版/原文片段
  5. 以结构化JSON格式返回结果

CLI examples

CLI使用示例

bash
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
bash
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

Response policy

返回规则

  • 결과는 공식 실록 사이트에서 확인한 기사 제목 + 링크 + 요약 + 상세 excerpt 중심으로 답한다.
  • --year
    는 서기 연도 기준으로 필터링한다.
  • 입력한 왕 이름은 
    세종
    , 
    세종실록
    처럼 조금 달라도 canonical 왕명으로 정규화한다.
  • v1 에서는 semantic search, embedding, 대규모 색인 구축을 하지 않는다.
  • 결과가 없으면 억지로 추정하지 말고 빈 결과를 그대로 알려준다.
  • 回答以官方实录站点查询到的文章标题+链接+摘要+详情片段为核心内容
  • --year
    参数按公历年份进行过滤
  • 输入的国王名称哪怕存在些许差异（比如
    世宗
    、
    世宗实录
    ），都会标准化为规范的国王名称
  • v1版本不支持语义搜索、embedding、大规模索引构建
  • 若无搜索结果，不强行臆测内容，直接告知无结果

Done when

完成条件

  • 공식 사이트에서 실제 검색 결과가 1건 이상 조회되었다.
  • 필요 시 왕/연도 필터가 적용되었다.
  • 적어도 하나 이상의 기사 detail excerpt가 포함되었다.
  • 링크가 
    https://sillok.history.go.kr/id/...
    형태로 정리되었다.
  • 从官方站点查询到至少1条有效搜索结果
  • 按需应用了国王/年份筛选条件
  • 返回内容包含至少1条文章的详情片段
  • 链接整理为
    https://sillok.history.go.kr/id/...
    格式

Notes

注意事项

  • 공식 메인: 
    https://sillok.history.go.kr
  • 검색 endpoint: 
    https://sillok.history.go.kr/search/searchResultList.do
  • 기사 상세: 
    https://sillok.history.go.kr/id/<article_id>
  • 이 저장소 v1 은 공개 HTML 표면만 사용한다.
  • 官方主站：
    https://sillok.history.go.kr
  • 搜索接口：
    https://sillok.history.go.kr/search/searchResultList.do
  • 文章详情页：
    https://sillok.history.go.kr/id/<article_id>
  • 本仓库v1版本仅使用公开可访问的HTML页面内容