k-skill/korean-law-search/SKILL.md

name	description	license	metadata
korean-law-search	Use korean-law-mcp first for Korean law lookups, and fall back to Beopmang when the primary service is unavailable.	MIT	category locale phase legal ko-KR v1

Korean Law Search

What this skill does

한국 법령/조문/판례/유권해석/자치법규 조회가 필요할 때 기본 경로로 korean-law-mcp를 먼저 사용하고, 기존 서비스가 동작하지 않을 때는 승인된 fallback 표면인 법망(https://api.beopmang.org) 으로 이어간다.

• 법령명 검색: search_law
• 조문 본문 조회: get_law_text
• 판례 검색: search_precedents
• 유권해석 검색: search_interpretations
• 자치법규 검색: search_ordinance
• 여러 카테고리가 섞인 검색: search_all

이 스킬은 자체 npm/python 패키지를 만들지 않는다. 한국 법령 관련 조회는 기본적으로 korean-law-mcp 로 처리하고, 해당 경로가 막히거나 실패가 반복될 때만 승인된 fallback 표면인 법망을 사용한다.

When to use

• "산업안전보건법 찾아줘"
• "관세법 제38조 보여줘"
• "부당해고 판례 찾아줘"
• "개인정보보호법 시행령 조문 확인해줘"
• "한국 법령/판례/자치법규 검색해줘"

When not to use

• 미국/일본/EU 등 비한국 법령 검색
• 실제 법률 자문·소송 전략을 단정적으로 제공해야 하는 경우
• 법령 원문이 아니라 일반 상식 설명만 필요한 경우

Prerequisites

• 인터넷 연결
• node 18+
• npm install -g korean-law-mcp (로컬 CLI/로컬 MCP server 경로일 때)
• MCP 클라이언트에 remote endpoint를 등록할 수 있는 환경
• 법망 fallback (https://api.beopmang.org) 에 접근할 수 있는 네트워크

무료 API key: https://open.law.go.kr

로컬 CLI 또는 로컬 MCP server 경로는 LAW_OC 가 필요하다. remote MCP endpoint는 사용자 LAW_OC 없이 url만으로 연결한다.

npm install -g korean-law-mcp
export LAW_OC=your-api-key

korean-law list
korean-law help search_law

로컬 설치가 운영체제 정책이나 권한 때문에 막히면 먼저 korean-law-mcp 의 remote MCP endpoint(https://korean-law-mcp.fly.dev/mcp)를 사용한다. 그래도 기존 경로가 응답하지 않거나 서비스 장애로 조회가 막히면, 승인된 fallback 표면인 법망 MCP/REST(https://api.beopmang.org)로 전환한다.

MCP client setup

Claude Desktop / Cursor / Windsurf 같은 MCP 클라이언트에는 아래처럼 연결한다.

{
  "mcpServers": {
    "korean-law": {
      "command": "korean-law-mcp",
      "env": {
        "LAW_OC": "your-api-key"
      }
    }
  }
}

설치가 막힌 환경에서는 remote endpoint를 사용한다. 이 upstream 예시는 사용자 LAW_OC 없이 url만 등록한다.

{
  "mcpServers": {
    "korean-law": {
      "url": "https://korean-law-mcp.fly.dev/mcp"
    }
  }
}

Fallback workflow (법망)

기존 korean-law-mcp 경로가 동작하지 않을 때만 아래 fallback을 사용한다.

1. MCP fallback

{
  "mcpServers": {
    "beopmang": {
      "url": "https://api.beopmang.org/mcp"
    }
  }
}

2. REST fallback

curl "https://api.beopmang.org/api/v4/law?action=search&q=관세법"
curl "https://api.beopmang.org/api/v4/tools?action=overview&law_id=001706"
curl "https://api.beopmang.org/api/v4/law?action=get&law_id=001706&article=제750조"

CLI workflow

1. 법령명부터 찾기

korean-law search_law --query "관세법"

2. 특정 조문 본문 조회

korean-law get_law_text --mst 160001 --jo "제38조"

3. 판례 검색 + 본문 조회

# 1) 판례 목록/검색: search_precedents (= 법제처 Open API 판례 목록 조회 lawSearch.do?target=prec 를 감싼 우선 경로)
korean-law search_precedents --query "부당해고"

# 2) 검색 결과의 판례 ID/일련번호를 확인한 뒤 본문(상세) 조회
korean-law get_precedent_text --id <판례일련번호>

판례 검색은 korean-law-mcp 의 search_precedents 를 먼저 쓰고, 본문이 필요하면 upstream get_precedent_text 로 이어간다. upstream 도구가 없거나 raw API를 직접 쓰는 경우에는 공식 경로를 사용한다.

• 판례 목록 조회 (official): http://www.law.go.kr/DRF/lawSearch.do?target=prec — OC, target=prec, query, 검색범위, 정렬, 선고일자, 사건번호, 데이터출처명(법원/국세청 등) 등을 지원한다.
• 판례 본문 조회 (official): http://www.law.go.kr/DRF/lawService.do?target=prec&ID=<판례일련번호> — 검색 결과의 판례 ID/일련번호를 넘겨 상세 본문을 가져온다. lawService.do?target=prec 은 법망 같은 fallback이 아니라 공식 본문 조회 경로다.

지원 필터: query(검색어), 법원(court), 사건번호(case number), 데이터출처명(source name), 선고일자/날짜(date), 정렬(sort). 활성 도구·엔드포인트가 실제로 지원하는 필터만 넘기고, 요약 전에 반환 메타데이터를 먼저 확인한다.

판례 검색 실패 모드:

• 로컬 경로에서 LAW_OC 가 없으면 확보 방법만 안내하고 임의 크롤링으로 넘어가지 않는다.
• remote MCP/공식 API가 응답하지 않거나 rate limit/timeout이면 원인을 밝히고, 그때만 법망 fallback으로 전환한다.
• 검색 결과가 0건이어도 "관련 판례가 없다"고 단정하지 말고 검색어·법원·사건번호·선고일자·출처명을 바꿔 다시 시도한다.
• 일부 출처는 본문을 HTML로만 주거나 본문을 제공하지 않을 수 있다. 본문을 못 가져오면 목록 메타데이터(사건번호·법원·선고일자·출처·요지)까지만 제공하고 본문이 없다는 점을 명시한다(없는 본문을 지어내지 않는다).
• 판례는 검색·요약·인용까지만 하고 승소 가능성이나 소송 전략 같은 법률 자문성 결론은 내리지 않는다.

4. 자치법규 검색

korean-law search_ordinance --query "서울특별시 청년 기본 조례"

5. 애매하면 통합 검색

korean-law search_all --query "개인정보 처리방침 행정해석"

Response policy

• 한국 법령 관련 요청은 항상 korean-law-mcp를 먼저 사용한다.
• 기존 korean-law-mcp 경로가 설치/네트워크/서비스 장애로 실패하면 법망(https://api.beopmang.org)을 fallback으로 사용한다.
• 약칭(화관법)이면 search_law / search_all 로 정식 법령명을 먼저 확인한다.
• 조문 요청이면 검색 결과의 식별자(mst)를 확인한 뒤 get_law_text 로 본문을 가져온다.
• 판례는 search_precedents, 유권해석은 search_interpretations, 자치법규는 search_ordinance 를 우선 사용한다.
• 판례 본문이 필요하면 search_precedents 로 찾은 판례 ID로 upstream get_precedent_text 또는 공식 lawService.do?target=prec&ID=... 본문 조회로 이어간다.
• 로컬 CLI/MCP 경로를 쓰는데 LAW_OC 가 없으면 credential resolution order에 따라 확보 방법을 짧게 안내하고, 임의의 크롤링/검색엔진 우회로 넘어가지 않는다.
• remote MCP endpoint를 쓰면 사용자 LAW_OC 없이 url 등록 상태만 확인한다.
• 법적 판단이 필요한 경우 검색 결과 요약과 원문 출처까지만 제공하고 법률 자문처럼 단정하지 않는다.

Done when

• 한국 법령 관련 질의에 대해 korean-law-mcp 사용 경로가 선택되었다.
• 필요한 검색/조회 명령이 정해졌다.
• 법령/조문/판례/유권해석/자치법규 중 맞는 도구로 결과를 조회했다.
• 판례 본문이 필요하면 get_precedent_text 또는 공식 lawService.do?target=prec ID 조회로 본문까지 연결했다.
• 유권해석이면 search_interpretations, 자치법규면 search_ordinance 까지 명시적으로 연결했다.
• 로컬 경로라면 LAW_OC 확보 방법을 정확한 변수 이름으로 안내했다.
• remote endpoint라면 사용자 LAW_OC 없이 url 등록 상태를 확인했다.
• 기존 경로 장애 시 법망 fallback(MCP 또는 REST)으로 이어지는 안내가 포함되었다.

Notes

• upstream: https://github.com/chrisryugj/korean-law-mcp
• fallback surface: https://api.beopmang.org
• official data source: 법제처 Open API (https://open.law.go.kr)
• 이 저장소 안에는 한국 법령 전용 npm package나 python package를 추가하지 않는다.