joseon-sillok-search
nomadamas/k-skill
Search official Joseon Dynasty Annals records by keyword, king, and year from sillok.history.go.kr
What is joseon-sillok-search?
Searches the official Joseon Dynasty Annals (조선왕조실록) database at sillok.history.go.kr by scraping search results and article detail pages. Use this when you need to find historical records from the Joseon period with optional filtering by king name or Gregorian year.
- Keyword search across official Joseon Dynasty Annals records
- Optional filtering by king name (e.g., 세종, 정조)
- Optional filtering by Gregorian year (e.g., 1443)
- Extract article titles, summaries, and direct links from search results
- Retrieve Korean translation (국역) and original text (원문) excerpts from article detail pages
- Return structured JSON results with metadata
How to install joseon-sillok-search
npx skills add https://github.com/nomadamas/k-skill --skill joseon-sillok-search- Internet connection
- Python 3 installed
- No API key required; skill includes sillok_search.py helper script
How to use joseon-sillok-search
- 1.Run the search command with your keyword: python3 scripts/sillok_search.py --query "your_keyword"
- 2.Optionally add king filter: --king "세종" or "세종실록"
- 3.Optionally add year filter: --year 1443 (Gregorian year)
- 4.Optionally specify search type: --type k for Korean translation or --type w for original text
- 5.Optionally limit results: --limit 5
- 6.Review the returned JSON with article titles, summaries, links, and excerpts from sillok.history.go.kr
Use cases
- Find records about 훈민정음 (Hangul) in Sejong's reign
- Search for 측우기 (rain gauge) mentions across the annals
- Look up events from a specific year like 1443 in Joseon history
- Retrieve multiple articles about 수원 (Suwon) from Jeongjo's reign
- Search original text (원문) records for 임진왜란 (Japanese invasions)
- Korean history researchers
- Students studying Joseon Dynasty
- Historians needing primary source verification
- Cultural heritage professionals
- Anyone researching Korean historical records
joseon-sillok-search FAQ
--type k searches the Korean translation (국역) of the annals, while --type w searches the original classical Chinese text (원문). Use k for accessibility, w for scholarly precision.
King names are flexible and normalized internally. You can use 세종, 세종실록, or similar variations and the skill will match to the canonical king name.
No. The skill uses public HTML scraping from the official sillok.history.go.kr website with no API key or login required.
The skill returns an empty result set without guessing or inferring data. Try broader keywords or remove year/king filters to expand your search.
The current v1 supports filtering by a single Gregorian year with --year. For date ranges, run multiple searches with different years.
Full instructions (SKILL.md)
Source of truth, from nomadamas/k-skill.
name: joseon-sillok-search description: Search Joseon Dynasty Annals records from the official sillok.history.go.kr site with keyword search plus optional king/year narrowing. license: MIT metadata: category: history locale: ko-KR phase: v1
조선왕조실록 검색
What this skill does
국사편찬위원회 조선왕조실록 사이트(https://sillok.history.go.kr)에서 공식 검색 결과 HTML과 기사 상세 페이지를 직접 읽어 조선왕조실록 기록을 찾는다.
v1 범위는 단순 스크래핑이다.
- 키워드 검색
- 선택적 왕별 필터(
--king) - 선택적 서기 연도 필터(
--year) - 검색 결과 제목/요약/원문 링크 정리
- 기사 상세 페이지에서 국역/원문 excerpt 추출
When to use
- "조선왕조실록에서 훈민정음 찾아줘"
- "세종 때 실록에서 측우기 관련 기사 검색해줘"
- "1443년 조선왕조실록 기록 찾아줘"
- "정조실록에서 수원 관련 기록 몇 개 보여줘"
Prerequisites
- 인터넷 연결
python3- 별도 API 키 없음
- 설치된 skill payload 안에
scripts/sillok_search.pyhelper가 함께 들어 있다.
Inputs
- 필수: 검색어
- 선택: 왕 이름 (
세종,정조,세종실록등) - 선택: 서기 연도 (
1443같이 Gregorian year) - 선택: 결과 수 (
--limit) - 선택: 검색 타입 (
--type k|w)k: 국역 검색w: 원문 검색
Workflow
python3 scripts/sillok_search.py --query "..."로 공식 검색 endpoint를 호출한다.- 검색 결과 HTML에서 결과 수, 왕별 분류, 기사 링크, 요약을 파싱한다.
- 필요하면
--king,--year로 결과를 추가로 좁힌다. - 선택된 기사마다
/id/<article_id>상세 페이지를 열어 국역/원문 excerpt를 가져온다. - 구조화된 JSON으로 반환한다.
CLI examples
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, 대규모 색인 구축을 하지 않는다.
- 결과가 없으면 억지로 추정하지 말고 빈 결과를 그대로 알려준다.
Done when
- 공식 사이트에서 실제 검색 결과가 1건 이상 조회되었다.
- 필요 시 왕/연도 필터가 적용되었다.
- 적어도 하나 이상의 기사 detail excerpt가 포함되었다.
- 링크가
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 표면만 사용한다.
Related skills
More from nomadamas/k-skill and the wider catalog.
k-dart
Query Korean financial disclosures via DART OpenAPI using your API_K_DART key.
k-schoollunch-menu
Look up Korean school lunch menus by education office and school name via NEIS API.
k-skill-cleaner
Interview-driven skill auditor that identifies and safely removes unused K-skills based on trigger counts.
k-skill-setup
Configure credentials, verify runtime, and optionally enable update checks and GitHub starring for k-skill.
kakao-bar-nearby
Find nearby bars on Kakao Map by location, showing open status, menus, seating, and phone numbers.
kakao-map
Kakao Local (장소 검색·주소-좌표 변환) + Kakao Mobility (자동차 길찾기) 를 k-skill-proxy 경유로 조회한다. 사용자 키 불필요.