대한민국 법령을 내 PC에서 조문 단위로 검색하기 — legalize-search
legalize-kr의 법령 Markdown 데이터를 SQLite FTS5 검색 DB로 만들고, 웹 화면에서 조문과 개정 이력을 찾아보게 한 Python 프로그램입니다.
"벌금과 징역이 함께 나오는 조문"이나 "개인정보를 다루면서 파기 이야기는 없는 조문"을 법령 전체에서 찾고 싶을 때가 있습니다. 법령 한 건씩 열어 보는 방식으로는 이런 질문에 답하기 어렵습니다.
legalize-kr는 대한민국 법령을 Markdown 파일로 정리해 Git 저장소로 관리하는 프로젝트입니다. legalize-search는 이 데이터를 받아 SQLite FTS5 전문 검색 DB로 만들고, 브라우저에서 검색하는 화면을 붙였습니다.
써 보기
Python 3.12 이상이 필요합니다.
# 1. 법령 데이터 클론
git clone https://github.com/legalize-kr/legalize-kr.git
# 2. 의존성 설치
pip install pyyaml flask
# 3. DB 구축
python build_db.py --data ./legalize-kr/kr
# 4. 검색 서버 실행
python search_app.py
# → http://localhost:8080 에서 검색
search_app.py는 --db(DB 파일), --port(기본 8080), --no-browser(브라우저 자동 열기 끄기) 옵션을 받습니다.
DB는 이렇게 만듭니다
build_db.py는 kr/ 아래 법령 폴더를 돌면서 파일마다 다음을 처리합니다.
- 위쪽 YAML 머리말에서 제목, 법령 구분, 소관 부처, 공포일, 시행일, 상태 같은 정보를 꺼냅니다.
- 본문을
##### 제N조 (제목)형태의 제목 기준으로 잘라 조문 하나를 레코드 하나로 저장합니다. 장·편 제목도 함께 기록하고, 부칙 아래는 한 덩어리로 둡니다. - legalize-kr이 Git 저장소이므로
git log를 읽어 법령 파일별 개정 이력을 모읍니다. 커밋 메시지의 괄호에서일부개정,타법개정같은 개정 유형도 뽑습니다.
한 폴더 안의 법률, 시행령, 시행규칙은 한 묶음으로 저장해 서로 오갈 수 있게 했습니다. 입력 파일 6,884개를 넣으면 빌드에 약 2분(Git 이력 포함) 걸리고, DB는 약 473MB, 개정 이력은 약 81,500건이 됩니다.
검색 문법
검색어에는 SQLite FTS5 문법을 그대로 씁니다.
| 문법 | 예시 | 설명 |
|---|---|---|
| AND | 징역 AND 벌금 |
둘 다 포함 |
| OR | 벌금 OR 과태료 |
하나 이상 포함 |
| NOT | 개인정보 NOT 파기 |
제외 |
| 구문 | "개인정보 보호" |
이어진 구문 |
| 접두어 | 행정* |
앞부분 일치 |
| 근접 | NEAR(벌금 징역, 5) |
5토큰 이내 |
법률, 대통령령, 부령 같은 분류로 좁힐 수 있고, 결과에는 걸린 부분이 강조 표시된 조문 일부가 나옵니다. 결과를 누르면 법령 전체 조문과 변경 이력 탭, 같은 묶음의 시행령·시행규칙으로 가는 버튼이 있는 상세 창이 열립니다. 같은 기능을 /api/search, /api/law/:id, /api/law/:id/history 같은 REST API로도 부를 수 있습니다.
낱말 단위 검색
토크나이저는 unicode61이라 한글을 공백과 문장부호 기준으로 자릅니다. 글자 단위가 아니므로 개인정보는 하나의 토큰으로 처리됩니다.
알아 둘 점
- legalize-kr 저장소를 Git으로 받아야 개정 이력이 채워집니다.
.git이 없으면 이력 수집을 건너뜁니다. - 데이터가 바뀌면(
git pull후)build_db.py를 다시 돌립니다. 기존 DB는 지우고 새로 만듭니다. - 검색 화면은 CSS와 JavaScript를 넣은 HTML 파일 하나(
web/index.html)라 따로 빌드하지 않습니다.
소스와 설계 문서(docs/)는 GitHub 저장소에 있습니다.