korean-law-search

Korean Law Search

What this skill does

默认通过向 https://k-skill-proxy.nomadamas.org/v1/korean-law/... 发起请求来查询韩国的法律法规、具体法条、司法判例、权威行政解释以及地方法规。本服务基于韩国法制处（国家法律情报中心）官方 Open API（open.law.go.kr 的 DRF lawSearch.do/lawService.do）构建，整体设计参考了 chrisryugj/korean-law-mcp 的只读工具层。

用户无需准备任何 API key（LAW_OC），也无需在本地安装 CLI 工具。LAW_OC 密钥以及浏览器 User-Agent/Referer 头的注入均在代理服务器端统一处理。

• 搜索/列表：GET /v1/korean-law/search
• 正文/详情：GET /v1/korean-law/detail

When to use

• “帮我查一下《产业安全保健法》”
• “显示《关税法》第38条”
• “搜一下关于不当解雇的判例”
• “确认一下《个人信息保护法实施令》的具体条款”
• “检索韩国的法律法规、判例或地方法规”

When not to use

• 检索美国、日本、欧盟等非韩国法律法规
• 需要给出明确、具有法律约束力的正式法律意见或诉讼策略建议时
• 无需检索法律原件，仅需要通用常识性解释时

Prerequisites

无。用户无需准备或配置任何 API key。上游所需的 LAW_OC 会由代理服务器自动注入。

Default path

无需额外的客户端 API 封装层，直接向代理服务器发送 HTTP 请求即可。

优先使用环境变量 KSKILL_PROXY_BASE_URL；若未设置，则默认使用基础路径 https://k-skill-proxy.nomadamas.org。

Supported endpoints

搜索/列表查询

GET /v1/korean-law/search?target={target}&query={검색어}

target 用于指定只读的法律信息类型。

target	说明
law	现行法律法规
eflaw	施行日法律法规
elaw	英文法律法规
prec	司法判例
detc	宪法裁判所裁决例
expc	法律解释例（权威行政解释）
admrul	行政规则
ordin	地方法规
trty	条约
lstrm	法律术语

支持的筛选参数：query（搜索关键字）、display、page、sort、date、prncYd（宣判日期）、nb（案件编号）、datSrcNm（数据来源名称）、curt（法院）、org、knd、gana、nw、efYd、ancYd。接口响应保留韩国法制处 DRF 原样 JSON 数据，仅附加了 proxy 元数据。在对结果进行总结前，请先核对返回的元数据。

正文/详情查询

GET /v1/korean-law/detail?target={target}&ID={일련번호}

传入搜索结果中的唯一标识符（ID 或 MST/LID）以获取完整正文。指定具体法条可传入 JO（例如：000200 代表第2条），指定语言可传入 LANG。

Example requests

按法律名称检索：

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-law/search' \
  --data-urlencode 'target=law' \
  --data-urlencode 'query=관세법'

检索判例：

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-law/search' \
  --data-urlencode 'target=prec' \
  --data-urlencode 'query=부당해고'

获取判例正文：

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-law/detail' \
  --data-urlencode 'target=prec' \
  --data-urlencode 'ID=228541'

Response policy

• 所有涉及韩国法律的请求必须统一通过此代理 endpoint 处理，切勿绕过代理使用网络爬虫或通用搜索引擎。
• 若用户输入的是法律简称（如 화관법），应先使用 target=law 查出官方正式名称。
• 若用户请求特定法条，先从搜索结果中获取标识符（MST/ID），再调用 detail 接口读取正文。
• 司法判例使用 target=prec，行政解释使用 target=expc，地方法规使用 target=ordin 进行查询。
• 需要获取判例全文时，拿到搜索结果中的判例序号后，继续调用 detail?target=prec&ID=... 获取正文。
• 即使搜索结果为 0 笔，也不要贸然断定“没有相关规定”，应尝试更换搜索词、法院名称、案号、宣判日期或数据来源后再试一次。
• 部分数据源可能不提供全文。若无法获取正文，只需提供列表元信息（案号、法院、宣判日期、来源、摘要），并明确声明无正文（切勿捏造不存在的正文）。
• 涉及法律判断时，仅提供“搜索结果摘要”和“原文出处”，切勿像正式法律顾问那样给出断言式的结论。

Failure modes

• 未提供 target 或传入不支持的值时返回 HTTP 400
• 未提供搜索关键字或标识符时返回 HTTP 400
• 代理服务器缺失 LAW_OC 时返回 HTTP 503
• 上游韩国法制处 API 返回用户验证失败（사용자 정보 검증 실패）时，代理会返回 502 + law_user_verification_failed（需排查代理服务器端的 OC/UA/Referer 设置）
• 韩国法制处 API 临时返回空数据或 HTML 格式时，代理在重试后会返回 502 + upstream_unstable

Done when

• 已成功将韩国法律相关的查询路由至代理 endpoint。
• 根据查询类型正确匹配了目标类型：法律法规使用 target=law（必要时跟进 detail）、判例使用 target=prec、行政解释使用 target=expc、地方法规使用 target=ordin。
• 需要获取判例或法条全文时，已通过标识符跟进调用了 detail 接口。
• 已对结果进行总结归纳，并附上了原文出处（韩国法制处国家法律情报中心）。

Notes

• 架构参考（上游）：https://github.com/chrisryugj/korean-law-mcp
• 官方数据源：韩国法制处 Open API（https://open.law.go.kr，DRF lawSearch.do/lawService.do）
• 代理服务运营者专用密钥：LAW_OC（普通使用者无需关心）。免费申请地址：https://open.law.go.kr
• 本仓库内切勿新增任何韩国法律专属的 npm 或 Python 软件包。