k-skill 韩国法律检索 Skill 实战指南基于 k-skill-proxy 的 법제처 国家法令信息中心 Open API 封装【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill本篇技术指南讲解 k-skill 仓库中korean-law-searchSkill 的完整设计与使用方式该 Skill 通过k-skill-proxy代理服务器把韩国法务部법제처国家法令信息中心的官方 Open APIopen.law.go.kr的 DRFlawSearch.do/lawService.do封装为两个只读 REST 端点用于检索韩国现行法令、法条、判例、有权解释유권해석与自治法规。读完本文你将掌握该 Skill 的端点协议、target参数体系、查询参数白名单、响应策略与失败模式并理解代理层如何注入LAW_OC密钥与浏览器请求头让最终用户无需任何 API Key 或本地 CLI 即可完成韩国法律检索。Skill 定位与设计动机korean-law-search是 k-skill 面向韩语用户法律检索场景提供的一个 Skill。其核心设计是用户端不做任何上游对接仅向托管代理k-skill-proxy发起 HTTP 请求由代理完成对 법제처 官方 Open API 的调用与鉴权。这一点在 Skill 说明文档 中有明确交代基础路径为https://k-skill-proxy.nomadamas.org/v1/korean-law/...上游数据源是 법제처国家法令信息中心官方 Open API 的 DRF 端点lawSearch.do搜索/列表与lawService.do详情/正文设计参考了chrisryugj/korean-law-mcp的只读工具表面但改以托管 REST 代理形式暴露用户无需准备LAW_OCAPI Key也无需本地 CLI 安装——LAW_OC与浏览器 User-Agent/Referer 注入全部由代理服务器处理。Skill 元数据文件 skill.json 显示其 profiles 为proxy、browser、lookup归类为legal类别、ko-KR区域属于 v1 阶段的能力描述明确限定其用途为 Search Korean statutes, articles, precedents, interpretations, and local ordinances via k-skill-proxy。适用场景When to use文档给出的典型触发语句包括산업안전보건법 찾아줘帮我找《产业安全保健法》관세법 제38조 보여줘展示《关税法》第 38 条부당해고 판례 찾아줘帮我找不当解雇的判例개인정보보호법 시행령 조문 확인해줘确认《个人信息保护法》施行令条款한국 법령/판례/자치법규 검색해줘检索韩国法令/判例/自治法规不适用场景When not to use检索美国、日本、欧盟等非韩国法令需要给出确定性的法律咨询或诉讼策略Skill 只做检索与摘要不做法律意见只需要一般常识性说明而非法令原文。两个只读端点search 与 detailSkill 只暴露两个 GET 端点全部通过代理服务器实现调用链为用户 Agent → k-skill-proxy → 법제처 DRF Open API。端点作用上游映射GET /v1/korean-law/search检索/列表DRFlawSearch.doGET /v1/korean-law/detail正文/详情DRFlawService.do路由在 server.js 中注册分别绑定normalizeKoreanLawSearchQuery与normalizeKoreanLawDetailQuery做参数归一化并配置了korean-law-search/korean-law-detail两个缓存路由键。默认路径Default path文档明确无需额外的客户端 API 层直接向代理服务器发 HTTP 请求即可。代理基地址通过环境变量KSKILL_PROXY_BASE_URL覆盖缺省为https://k-skill-proxy.nomadamas.org。target 参数体系九类韩国法源两个端点都依赖target参数来区分要查询的法源类型。文档给出的完整取值表如下target说明law现行法令현행법령eflaw施行日法令시행일 법령elaw英文法令영문법령prec判例판례detc宪法法院决定例헌재결정례expc法令解释例/有权解释법령해석례, 유권해석admrul行政规则행정규칙ordin自治法规자치법규trty条约조약lstrm法令用语법령용어从代理源码 korean-law.js 的ALLOWED_TARGETS集合看代理层还额外允许lsHstInf법령 연혁法令沿革这一未在 Skill 文档表格中列出的 target。也就是说代理层的能力面比文档表格略大Agent 在使用时仍应以文档表格的九类为准但可以推断代理层有意保留了沿革查询的扩展空间。任何不在白名单内的target都会被normalizeTarget直接以 400bad_request拒绝korean-law.js测试用例normalizeKoreanLawSearchQuery rejects an unsupported target验证了这一点。端点协议详解检索/列表GET /v1/korean-law/searchGET /v1/korean-law/search?target{target}query{검색어}支持过滤器代理白名单内的透传参数见 korean-law.js 的SEARCH_PASSTHROUGH_PARAMSquery/search检索词display每页显示条数page页码sort排序date日期过滤prncYd判决日期선고일자nb案件编号사건번호datSrcNm数据来源名称curt法院법원org、knd、gana、nw法令机关/种类/가나다 排序等过滤efYd施行日期ancYd公布日期。响应体为 법제처 DRF JSON 原样透传仅追加proxy元数据代理名、缓存命中状态与 TTL、请求时间戳见 server.js。文档提醒做摘要前应先检查返回的元数据。一个重要的校验规则query、search、nb、datSrcNm四个参数至少提供一个否则抛 400 A search query is requiredkorean-law.js对应测试normalizeKoreanLawSearchQuery requires a search query。未传type时默认JSON且type仅允许JSON/XML/HTML三种。正文/详情GET /v1/korean-law/detailGET /v1/korean-law/detail?target{target}ID{일련번호}将搜索结果中的标识符ID或MST/LID传入以获取正文。指定具体条款用JO例如000200表示第 2 条语言用LANG。代理层的DETAIL_PASSTHROUGH_PARAMS白名单为ID、MST、LID、LM、JO、LANG、chrClsCd、ancYnChkkorean-law.js。校验规则ID、MST、LID三者必须至少提供一个korean-law.js否则 400。实战示例三段 curl 调用以下示例均来自 Skill 文档直接可复制运行代理基地址缺省。按法令名检索如《关税法》curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-law/search \ --data-urlencode targetlaw \ --data-urlencode query관세법检索判例如不当解雇curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-law/search \ --data-urlencode targetprec \ --data-urlencode query부당해고获取判例正文按判例编号curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-law/detail \ --data-urlencode targetprec \ --data-urlencode ID228541服务端集成测试server.test.js覆盖了这三类路径搜索端点代理转发、成功响应缓存、detail 端点路由到lawService.do、缺 query 返回 400、缺LAW_OC返回 503。代理层关键实现原理阅读 korean-law.js 源码可以确认文档中密钥与请求头由代理注入的底层实现密钥注入buildKoreanLawUrl会把OC即LAW_OC连同target、type及透传参数拼进上游 URLkorean-law.js。LAW_OC从代理服务环境变量读取server.js未配置时返回 503upstream_not_configured。浏览器请求头注入law.go.kr 即使OC合法也会拒绝缺少浏览器 User-Agent/Referer 的请求返回사용자 정보 검증에 실패。因此代理默认注入 Chrome UA 与https://www.law.go.kr/Refererkorean-law.js并允许通过LAW_USER_AGENT/LAW_REFERER环境变量覆盖server.js。瞬时失败重试law.go.kr 偶尔会对 200 响应返回空 body 或 HTML 维护页fetchKoreanLaw将其视为瞬时故障最多重试 3 次MAX_ATTEMPTS 3退避间隔300ms * attempt请求超时 20 秒korean-law.js。对应测试fetchKoreanLaw retries empty/HTML responses then succeeds验证了空响应→HTML→成功的三级重试路径。用户校验失败识别isUserVerificationFailure用正则匹配사용자 정보 검증/검증에 실패/IP주소 및 도메인等特征串命中则映射为 502law_user_verification_failedkorean-law.js提示运营方检查LAW_OC与 UA/Referer 配置。响应缓存搜索/详情端点在代理层按路由键做 TTL 缓存命中时在proxy元数据中标注cache.hit trueserver.js可有效缓解对上游的重复请求压力。响应策略Agent 的正确用法Skill 文档对 Agent 的响应行为给出了明确约束这些规则决定了检索结果如何被呈现韩国法令相关请求一律走代理端点不绕行独立爬虫或搜索引擎遇到简称如화관법时先用targetlaw确认正式法令名请求条款时先看搜索结果中的标识符MST/ID再用detail拉取正文判例用targetprec有权解释用targetexpc自治法规用targetordin需要判例正文时用搜索结果中的判例编号继续请求detail?targetprecID...搜索结果为零时不得断言不存在相关规范应更换检索词、法院、案件编号、判决日期、来源名后重试部分来源可能不提供正文此时只给出列表元数据案件编号、法院、判决日期、来源、要旨并明确说明正文缺失绝不编造正文涉及法律判断时只提供检索结果摘要 原文出处不以下定论的法律咨询口吻作答。失败模式速查失败条件响应说明target缺失或不在白名单400bad_request检索词/标识符缺失400search 需query/search/nb/datSrcNm至少其一detail 需ID/MST/LID至少其一代理未配置LAW_OC503upstream_not_configured법제처 API 返回用户验证失败사용자 정보 검증 실패502law_user_verification_failed需检查服务器 OC/UA/Referer법제처 API 瞬时返回空/HTML 响应502upstream_unstable代理重试后仍失败上游非 2xx原样透传由proxyKoreanLawRequest直接返回上游状态与正文完成判定Done when一份合格的检索响应应满足以下全部条件这也是该 Skill 的完成标准韩国法令相关提问已路由到代理端点按类型正确选择 target法令/条款用targetlaw必要时接detail判例用targetprec有权解释用targetexpc自治法规用targetordin需要判例/条款正文时已用标识符通过detail获取正文结果已做摘要并同时给出原文出处법제처 国家法令信息中心。运营与密钥说明上游数据源법제처 Open APIopen.law.go.krDRFlawSearch.do/lawService.doLAW_OC可在该站免费申请LAW_OC属于代理运营方专有机密最终用户无需持有Skill 硬性规则也禁止在对话、文件或 shell 参数中索取/打印/存储明文凭据代理层允许通过LAW_USER_AGENT、LAW_REFERER覆盖默认浏览器头适配不同环境下的上游校验策略本仓库不新增韩国法令专用的 npm package 或 python package法律检索能力统一收敛到代理端点。延伸阅读Skill 指令全文instruction.mdSkill 元数据skill.json代理实现源码src/korean-law.js路由注册与缓存逻辑src/server.js单元测试test/korean-law.test.js端到端路由测试test/server.test.js【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考