Korea Ground-Truth / Tools / search_law

법령 검색 API — 현행 법률·시행령·시행규칙 조회 (법제처 국가법령정보)

Korean Law Search API (current statutes — Ministry of Government Legislation)

Cost: 2 credits/call (cache hit: 1).20원/호출 · 출처: 법제처 (law.go.kr) · 캐시 24시간

어떤 문제를 푸나

법령명으로 현행 법률과 하위 법령을 찾고, 소관부처·공포일·시행일·상세 링크를 확인합니다. 법률 답변 전 근거 법령의 존재와 최신 개정 여부를 확인하는 용도입니다.

호출 방법

REST

curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/search_law \
  -H "Authorization: Bearer kgt_live_..." \
  -H "content-type: application/json" \
  -d '{"query":"주택임대차보호법","per_page":2}'

MCP (Claude Code / Cursor / any MCP client)

claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# then ask: "search_law 툴로 {"query":"주택임대차보호법","per_page":2} 조회해줘"

API 키 발급 (사람 불필요, 무료 50 credits)

curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'

입력

fieldtyperequireddescription
querystringyes법령명 검색어
pageintegerno (default 1)
per_pageintegerno (default 20)

응답 예시 (실제 응답, 2026-08-26)

{
  "ok": true,
  "data": {
    "source": "법제처 국가법령정보 (law.go.kr)",
    "total": 2,
    "page": 1,
    "results": [
      {
        "law_id": "001248",
        "law_serial_no": "276291",
        "name": "주택임대차보호법",
        "short_name": "주택임대차법",
        "law_type": "법률",
        "ministry": "국토교통부,법무부",
        "promulgation_date": "20251001",
        "promulgation_no": "21065",
        "enforcement_date": "20260102",
        "revision_type": "타법개정",
        "is_current": true,
        "detail_url": "https://www.law.go.kr/DRF/lawService.do?OC=lawoc&target=law&MST=276291&type=HTML&mobileYn=&efYd=20260102"
      },
      {
        "law_id": "004950",
        "law_serial_no": "287183",
        "name": "주택임대차보호법 시행령",
        "short_name": null,
        "law_type": "대통령령",
        "ministry": "국토교통부,법무부",
        "promulgation_date": "20260623",
        "promulgation_no": "36423",
        "enforcement_date": "20260701",
        "revision_type": "타법개정",
        "is_current": true,
        "detail_url": "https://www.law.go.kr/DRF/lawService.do?OC=lawoc&target=law&MST=287183&type=HTML&mobileYn=&efYd=20260701"
      }
    ]
  },
  "meta": {
    "tool": "search_law",
    "cost": 2,
    "balance_remaining": 48,
    "cache_hit": false,
    "source": "법제처 (law.go.kr)",
    "fetched_at": "2026-08-26T14:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.

함께 쓰는 툴

llms.txt · openapi.json · pricing.json