Agent skill
court-divorce-cases
법제처 국가법령정보 API를 통해 이혼 판례를 검색하고 다운로드합니다.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/court-divorce-cases
SKILL.md
판례 검색 및 다운로드 스킬
목적
법제처 국가법령정보 Open API를 사용하여 이혼 관련 판례를 검색하고 다운로드합니다.
사용 시점
다음과 같은 작업을 할 때 사용됩니다:
- 이혼 판례 검색
- 판례 상세 내용 다운로드
- Markdown 파일로 저장
주요 기능
법제처 Open API를 통한:
- 판례 키워드 검색
- 판례 상세 내용 조회
- Markdown 형식 자동 저장
API 정보
법제처 국가법령정보 Open API
- URL: https://open.law.go.kr
- 제공 기관: 법제처
- 데이터: 대한민국 각급 법원 판례 전문
- 인증: Open API 키 필요 (무료)
API 인증키 발급
1. 국가법령정보 공동활용 회원가입
절차:
- https://open.law.go.kr 접속
- 회원가입 (무료)
- 로그인 후 "OPEN API" 메뉴 선택
- API 키 신청 (자동 승인)
- 발급된 API 키 확인
특징:
- 무료 제공
- 즉시 발급
- XML 형식 응답
- 검색 조건: 판례 분류, 키워드, 사건번호 등
2. 법제처 판례 검색 API (권장) ✅
절차:
- https://open.law.go.kr 접속
- 회원가입 및 로그인
- "OPEN API" 메뉴에서 API 키 확인
- 이메일 ID의 @ 앞부분을 OC 파라미터로 사용 (예: [email protected] → OC=g4c)
API 정보:
- 요청주소:
http://www.law.go.kr/DRF/lawSearch.do - 검색 대상: 판례 (precedent)
- 승인: 회원가입 시 자동 발급
- 출력 형식: XML (권장, 실제 작동 확인됨), JSON (빈 결과 반환), HTML
요청 파라미터:
OC: 사용자 이메일 ID의 @ 앞부분 (필수, 예: [email protected] → nfbs2000)target:prec(판례 검색, 필수)type:XML(필수, JSON은 작동하지 않음)query: 검색어 (예: "이혼", "유책배우자")search: 검색 범위 (1=판례명, 2=전문 검색, 기본값: 2 권장)display: 결과 개수 (최대 100, 기본값: 20)page: 페이지 번호 (기본값: 1)org: 법원 유형 (400201=대법원, 400202=하급심)curt: 법원명sort: 정렬 (lasc, ldes, dasc, ddes, nasc, ndes, 기본값: ddes)prncYd: 선고일자 범위 (예: 20200101~20241231)nb: 사건번호
중요 사전 준비:
- https://open.law.go.kr 회원가입
- [OPEN API] → [OPEN API 신청] 메뉴
- "판례" 항목 체크 (필수! 체크하지 않으면 "미신청된 목록/본문" 에러 발생)
- 저장 후 즉시 사용 가능
응답 필드:
prec: 판례 정보판례일련번호: 고유 ID판례명: 사건명사건번호: 법원 사건번호선고일자: 판결 날짜법원명: 판결 법원법원종류코드: 법원 유형 코드사건종류명: 사건 유형판결유형: 판결 종류판례상세링크: 상세 페이지 URL
예시 요청:
http://www.law.go.kr/DRF/lawSearch.do?OC=test&target=prec&type=XML&query=이혼&search=2&display=100
Python 예제 (법제처 판례 검색 API):
def search_precedents(oc: str, keyword: str = "이혼", search_type: int = 2, display: int = 100):
"""
법제처 판례 검색 API로 판례 검색
Args:
oc: 사용자 이메일 ID (@ 앞부분)
keyword: 검색 키워드
search_type: 1=판례명, 2=전문 검색
display: 결과 개수 (최대 100)
"""
base_url = "http://www.law.go.kr/DRF/lawSearch.do"
params = {
'OC': oc,
'target': 'prec', # 판례 검색
'type': 'XML',
'query': keyword,
'search': search_type,
'display': display,
'page': 1
}
response = requests.get(base_url, params=params)
if response.status_code != 200:
raise Exception(f"API 호출 실패: {response.status_code}")
# XML 파싱
root = ET.fromstring(response.content)
# 결과 추출
cases = []
for item in root.findall('.//prec'):
case = {
'판례일련번호': item.findtext('판례일련번호', ''),
'판례명': item.findtext('판례명', ''),
'사건번호': item.findtext('사건번호', ''),
'선고일자': item.findtext('선고일자', ''),
'법원명': item.findtext('법원명', ''),
'법원종류코드': item.findtext('법원종류코드', ''),
'사건종류명': item.findtext('사건종류명', ''),
'판결유형': item.findtext('판결유형', ''),
'판례상세링크': item.findtext('판례상세링크', '')
}
cases.append(case)
return pd.DataFrame(cases)
이혼 판례 검색 API 사용법
1. 판례 목록 조회 (검색)
API 엔드포인트:
http://www.law.go.kr/DRF/lawSearch.do
Python 예제:
import requests
import xml.etree.ElementTree as ET
import pandas as pd
from typing import List, Dict
def search_divorce_cases(api_key: str, keyword: str = "유책배우자", display: int = 100):
"""
이혼 판례 검색
Args:
api_key: 국가법령정보 API 키
keyword: 검색 키워드 (예: "유책배우자", "이혼 사유")
display: 한 페이지당 결과 수 (최대 100)
Returns:
판례 목록 데이터프레임
"""
base_url = "http://www.law.go.kr/DRF/lawSearch.do"
params = {
'OC': api_key, # API 키
'target': 'prec', # 판례 검색
'type': 'XML', # XML 형식
'query': keyword, # 검색어
'display': display, # 결과 수
'page': 1 # 페이지 번호
}
# API 호출
response = requests.get(base_url, params=params)
if response.status_code != 200:
raise Exception(f"API 호출 실패: {response.status_code}")
# XML 파싱
root = ET.fromstring(response.content)
# 판례 목록 추출
cases = []
for prec in root.findall('.//PrecService'):
case = {
'판례일련번호': prec.findtext('판례일련번호', ''),
'사건번호': prec.findtext('사건번호', ''),
'사건명': prec.findtext('사건명', ''),
'선고일자': prec.findtext('선고일자', ''),
'법원명': prec.findtext('법원명', ''),
'사건종류명': prec.findtext('사건종류명', ''),
'판시사항': prec.findtext('판시사항', ''),
'판결요지': prec.findtext('판결요지', ''),
'참조조문': prec.findtext('참조조문', ''),
'참조판례': prec.findtext('참조판례', '')
}
cases.append(case)
df = pd.DataFrame(cases)
print(f"검색 결과: {len(df)}건")
return df
# 사용 예제
api_key = "YOUR_API_KEY_HERE"
divorce_cases = search_divorce_cases(api_key, keyword="유책배우자 이혼")
# CSV 저장
divorce_cases.to_csv('divorce_cases.csv', index=False, encoding='utf-8-sig')
2. 판례 본문 조회 (상세 내용)
API 엔드포인트:
http://www.law.go.kr/DRF/lawService.do
요청 파라미터:
OC: 사용자 이메일 ID (@ 앞부분)target:prec(판례, 필수)type:XML(권장),HTML,JSONID: 판례일련번호 (필수)mobileYn:Y(모바일 최적화, 선택)
Python 예제:
import xml.etree.ElementTree as ET
import requests
from pathlib import Path
def get_case_detail(oc_id: str, case_serial_no: str):
"""
특정 판례의 전문(full text) 조회
Args:
oc_id: 사용자 이메일 ID (@ 앞부분)
case_serial_no: 판례일련번호
Returns:
판례 전문 내용
"""
base_url = "http://www.law.go.kr/DRF/lawService.do"
params = {
'OC': oc_id,
'target': 'prec',
'type': 'XML',
'ID': case_serial_no,
'mobileYn': ''
}
response = requests.get(base_url, params=params)
response.raise_for_status()
root = ET.fromstring(response.content)
# 판례 상세 정보 추출
detail = {
'판례일련번호': case_serial_no,
'사건번호': root.findtext('.//사건번호', ''),
'사건명': root.findtext('.//사건명', ''),
'선고일자': root.findtext('.//선고일자', ''),
'법원명': root.findtext('.//법원명', ''),
'사건종류명': root.findtext('.//사건종류명', ''),
'판시사항': root.findtext('.//판시사항', ''),
'판결요지': root.findtext('.//판결요지', ''),
'참조조문': root.findtext('.//참조조문', ''),
'참조판례': root.findtext('.//참조판례', ''),
'전문내용': root.findtext('.//전문내용', ''),
'판례내용': root.findtext('.//판례내용', '')
}
return detail
def save_case_to_file(detail: dict, output_dir: str):
"""
판례 상세 내용을 개별 파일로 저장
Args:
detail: 판례 상세 정보 딕셔너리
output_dir: 출력 디렉토리
"""
output_path = Path(output_dir)
output_path.mkdir(parents=True, exist_ok=True)
# 파일명: {판례일련번호}_{사건번호}.md
case_id = detail['판례일련번호']
case_no = detail['사건번호'].replace('/', '_')
filename = f"{case_id}_{case_no}.md"
filepath = output_path / filename
# Markdown 형식으로 저장
content = f"""# {detail['사건명']}
## 기본 정보
- **판례일련번호**: {detail['판례일련번호']}
- **사건번호**: {detail['사건번호']}
- **선고일자**: {detail['선고일자']}
- **법원명**: {detail['법원명']}
- **사건종류**: {detail['사건종류명']}
## 판시사항
{detail['판시사항']}
## 판결요지
{detail['판결요지']}
## 참조조문
{detail['참조조문']}
## 참조판례
{detail['참조판례']}
## 전문내용
{detail['전문내용'] or detail['판례내용']}
"""
with open(filepath, 'w', encoding='utf-8') as f:
f.write(content)
print(f"✅ 저장 완료: {filename}")
return filepath
# 사용 예제
oc_id = "nfbs2000"
case_detail = get_case_detail(oc_id, case_serial_no="609501")
save_case_to_file(case_detail, "/path/to/output/dir")
환경 변수 설정
.env 파일
# 법제처 판례 검색 API
# 이메일 ID의 @ 앞부분 (예: [email protected] → g4c)
LAW_OC_ID=your_email_id_before_at
주요 검색 키워드
유책배우자 관련
- "유책배우자"
- "유책배우자 이혼 청구"
- "부정행위"
- "간통"
- "악의적 유기"
이혼 사유 관련
- "이혼 사유"
- "혼인 계속 곤란 사유"
- "배우자 학대"
- "가정폭력"
- "성격차이"
법원별 검색
- "대법원 이혼"
- "가정법원 이혼"
- "고등법원 이혼"
참고 링크
공식 API
- 국가법령정보 Open API: https://open.law.go.kr/LSO/openApi/guideList.do
- 공공데이터포털 판례 API: https://www.data.go.kr/data/15057123/openapi.do
- 판례 목록 조회 가이드: https://open.law.go.kr/LSO/openApi/guideResult.do?htmlName=precListGuide
- 판례 본문 조회 가이드: https://open.law.go.kr/LSO/openApi/guideResult.do?htmlName=precInfoGuide
판례 검색 포털
- 대법원 판례 검색: https://glaw.scourt.go.kr/wsjo/panre/sjo050.do
- 사법정보공개포털: https://portal.scourt.go.kr/pgp/index.on?m=PGP1011M01
- 빅케이스: https://bigcase.ai/
- LBOX: https://lbox.kr/
베스트 프랙티스
✅ DO (권장)
- API 키 보안: 환경 변수 사용, 코드에 하드코딩 금지
- 점진적 다운로드: 대량 판례는 페이지 단위로 분할 다운로드
- 오류 처리: XML 파싱 실패, API 오류 대비 try-except 구현
- 캐싱: 이미 다운로드한 판례 중복 방지
- AI 분석 검증: Gemini 분석 결과를 법률 전문가가 검토
- 개인정보 보호: 당사자 이름 등 개인정보 마스킹 처리
❌ DON'T (비권장)
- API 키를 코드에 직접 작성
- 대량 판례 한 번에 다운로드 (서버 부하)
- XML 파싱 오류 무시
- AI 분석만으로 법적 판단
- 판례 내용 무단 재배포
- 상업적 목적 무단 사용
법적 고지
주의사항:
- 본 스킬은 교육 및 연구 목적으로만 사용해야 합니다
- 판례 분석 결과는 참고용이며, 법적 효력이 없습니다
- 실제 법률 문제는 변호사와 상담하세요
- 판례 데이터의 저작권은 법제처 및 법원에 있습니다
- API 이용약관을 준수하세요
스킬 상태: 완료 ✅ 줄 수: 500줄 미만 ✅ 베스트 프랙티스: Anthropic 가이드라인 준수 ✅
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?