拓冰网站定制 
k-skill 实战使用 national-pension-workplace 技能查询韩国国民年金국민연금参保事业场所信息【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill导读national-pension-workplace 是 k-skill 仓库中面向韩国商业场景的查询类技能它通过k-skill-proxy代理调用公共数据门户공공데이터포털的「国民年金公团_国民年金参保事业场所信息服务」data.go.kr 3046071V2 接口用来查询某家企业的国民年金参保人数、当月告知金额以及月度参保趋势从而间接判断公司员工规模及其增减变化。读完本文你将掌握该技能的完整用法、命令行参数、凭证配置方式、响应结构与失败排查方法并能理解其源码层面「只报事实、不做解读、不妄断同一性」的设计边界。技能定位与核心能力能查什么该技能围绕一个核心入口GET /v1/national-pension/workplace通过 instruction.md 定义的调用链可以提供三类查询结果参保事业场所候选列表用「事业场所名称상호 事业者登记号前 6 位」匹配出的事业场所列表同一资料生成年月dataCrtYm的重复数据按「每个事业场所保留最新月份」去重整理单一事业场所明细当候选唯一确定时返回参保人数jnngpCnt、当月告知金额crrmmNtcAmt、新增取得/丧失人员数月度参保现状时间序列按月份展示参保人数与告知金额的变动轨迹。一个关键前提事业者登记号只公开前 6 位国民年金数据中事业者登记号사업자등록번호只公开前 6 位后位被掩码无法做全号精确匹配。因此事业场所名称--name是必填参数候选结果由「名称 前 6 位前缀」共同决定当候选有多个时技能不擅自判定哪一个是要查的企业而是把列表原样返回由用户或下游流程自行确认。设计原则只报事实不做解读技能文档明确了两条设计原则见 instruction.md不生成任何解读性标签不输出分数、等级、「危险/风险」之类的判断只保留 upstream公共数据门户上游接口返回的事实候选不唯一时不断言同一性多个候选匹配时绝不说「这就是你查的那家公司」。这套原则在代理层源码中得到了一致的落实。national-pension.js 的响应中带有disclosure_note字段明确说明「事业者登记号只公开前 6 位无法全号匹配列出名称 6 位前缀匹配的候选多个匹配时由调用方自行确认身份」并且候选选取逻辑chosen只在去重后列表唯一、或精确同名唯一时才选定否则为null。使用场景技能文档列出的典型提问包括「○○ 公司员工规模大概多大用国民年金参保人数来看」「这个事业场所当月国民年金告知金额是多少」「最近人数是增加还是减少了按月看一下」。这类查询常用于交易对手尽职调查실사、入职前雇主评估、市场调研等正当核实场景。skill.json 中的profiles标注为proxy与lookup说明它属于「经代理查询」型的 lookup 技能不涉及任何写入或提交动作。运行前提与环境要求前置条件可访问互联网本机装有python3具备 helper 脚本 national_pension_workplace.py可访问 hosted 或 self-host 的k-skill-proxy的/v1/national-pension/workplace路由。凭证要求Credentials用户侧无需任何必填密钥——这是该技能的核心便利点因为 API Key 保存在代理运营端KSKILL_PROXY_BASE_URL仅在使用 self-host 代理时设置为空时默认使用 hosted 代理https://k-skill-proxy.nomadamas.orgDATA_GO_KR_API_KEY只放在代理运营服务器环境变量中并且需要在公共数据门户完成「国民年金公团_国民年金参保事业场所内역」的 활용신청服务利用申请。从 helper 源码 national_pension_workplace.py 可以看到代理地址解析逻辑resolve_proxy_base_url()会优先使用--proxy-base-url或环境变量若值被设为off、false、0、disable、disabled、none等则会抛出「KSKILL_PROXY_BASE_URL 已被禁用」错误若设为占位符replace-me或留空则回落至默认 hosted 地址。这种设计保证了 API 密钥永不落入用户侧。输入参数详解参数必填说明--name是事业场所名称상호。因为登记号只公开前 6 位名称是身份识别的主要依据--b-no否事业者登记号允许带连字符实际仅取其前 6 位作为前缀过滤条件Python helper 对--b-no的校验见 national_pension_workplace.py先用正则剔除所有非数字字符再要求恰好为 10 位数字\d{10}否则抛出「사업자등록번호는 숫자 10자리여야 합니다 (하이픈 허용)」错误校验通过后把完整 10 位数字传给代理。代理侧 national-pension.js 的normalizeNationalPensionQuery()则做了同样的归一化兼容wkplNm/name/b_nm与b_no/bno/bzowrRgstNo多种字段别名并把登记号slice(0, 6)取出前缀。注意名称缺失时代理直接抛错要求提供wkplNm——这与文档中「사업장명이 필수」的约束一致。CLI 使用示例技能文档给出的标准调用方式是通过 k-skill CLI 执行捆绑脚本npx -y nomadamas/k-skill0 exec national-pension-workplace scripts/national_pension_workplace.py -- \ --name 삼성전자(주) --b-no 124-81-00998命令拆解npx -y nomadamas/k-skill0 exec national-pension-workplace scripts/national_pension_workplace.py通过 CLI 以技能内相对路径解析并执行捆绑的 Python helper不要假设仓库相对路径或已安装技能路径这是 k-skill CLI 的资产访问约定见 national-pension-workplace.generic.md--之后的所有参数原样传给 helper--name传企业名称--b-no传带连字符的登记号。helper 内部main()构造查询后调用代理成功时向 stdout 打印带 2 空格缩进的 JSONensure_asciiFalse保留韩文返回码 0发生ValueError参数问题或ApiError代理/上游错误时把{error: ...}JSON 输出到 stderr返回码 1方便脚本化处理。如需指定 self-host 代理可追加--proxy-base-url https://your-proxy.example.com或预先导出KSKILL_PROXY_BASE_URL环境变量。源码级调用链代理端如何编排三次上游调用从 national-pension.js 的fetchNationalPensionWorkplace()可以看出一次「查询 → 明细 → 月度序列」的完整链路涉及三个 data.go.kr V2 操作getBassInfoSearchV2基础搜索以wkplNm、bzowrRgstNo6 位前缀、pageNo: 1、numOfRows: 100请求候选列表防御性前缀再过滤若传了前缀对返回条目按bzowrRgstNo前 6 位再过滤一次「trust upstream but verify」按月去重同一事业场所会按资料生成年月重复出现代理以「名称 道路名详细地址」为键分组每个组只保留dataCrtYm最新的条目再按年月倒序排列候选选定去重后若只剩 1 条或精确同名wkplNm wkplNm.trim()恰为 1 条则选定该条为selected_candidate否则为nullgetDetailInfoSearchV2明细查询用选定候选的seqdataCrtYm拉取参保人数、当月告知金额、取得/丧失人数getPdAcctoSttusInfoSearchV2期间现状查询用seq拉取月度参保状态序列并按年月升序排列。最终响应结构包含query、candidate_count、candidates、raw_row_count、selected_candidate、detail、monthly_status、disclosure_note等字段。该代码顶部注释也印证了设计意图「upstream 将事业者登记号掩码为前 6 位身份只能靠名称 6 位前缀确认多个候选匹配时原样返回列表不断言是哪家企业。」代理对 data.go.kr 网关的鉴权/配额错误码也做了归类returnReasonCode落在集合{20, 21, 30, 31, 32, 33}时判定为auth-error鉴权错误否则为普通errorresultCode非00/0时同样判定为业务错误。这些判断直接影响下面的失败模式。失败模式与排查技能文档列出了四种典型失败情形现象含义处置400 bad_request未提供事业场所名称补上--name参数重新查询503 upstream_not_configured代理服务器环境未配置DATA_GO_KR_API_KEY联系代理运营方配置密钥helper 会转成用户友好的「k-skill-proxy에 필요한 API 키가 설정되어 있지 않습니다」提示502 upstream_forbidden代理密钥未对服务 3046071 申请 활용신청或网关返回 401/403/鉴权错误码在公共数据门户完成该服务的利用申请或检查密钥有效性候选多个 →selected_candidate为null名称 6 位前缀匹配到多家事业场所用户应从candidates列表中人工指定具体企业Python helper 对错误的处理也值得注意national_pension_workplace.pyHTTP 503 且响应体error upstream_not_configured时给出密钥未配置提示响应体含message字段时透传该消息其余情况给出 HTTP 状态码若代理服务器本身不可达URLError则提示「설정된 k-skill-proxy 서버가 응답하지 않습니다」并附底层原因。隐私边界与合规运营标准技能文档对隐私边界有明确的自我约束国民年金数据只公开事业者登记号前 6 位因此技能仅列出「6 位一致 名称相似」的候选不断言事业场所同一性公开范围以法人、达到一定劳动者规模的场所为主小型/个体事业场所可能不公开。同时文档给出三条「法律安全运营基准」법적 안전 운영 기준只查询公团官方公开的事业场所信息参保人数与告知金额是国民年金公团通过公共数据门户公开的场所级信息不得查询或推测个别劳动者的个人信息明确查询目的限定于交易对手尽职调查、入职审查、市场调研等正当核实目的的个别查询对特定场所/行业进行大规模、定期收集时须先确认目的与法律依据依据不明确则不得进行结果保存最小化查询结果仅作当时参考不做长期存储与再分发。如何获取完整说明技能完整说明以 CLI 指令优先始终最新并适配当前运行时npx -y nomadamas/k-skill0 instruct national-pension-workplace查看捆绑文件清单npx -y nomadamas/k-skill0 files national-pension-workplace如需在本地直接阅读原始说明与源码本仓库提供了三份互为镜像的资产packages/k-skill-cli/skills/national-pension-workplace/CLI 打包版含 Python helper 与 skill.json、national-pension-workplace/仓库顶层版含 SKILL.md 与 instruction.md以及代理端实现 national-pension.js 与对应测试 server.test.js。官方数据面Official surfaces公共数据门户data.go.kr 数据 3046071 的开放 API 页面국민연금공단_국민연금 가입 사업장 내역upstream 接口https://apis.data.go.kr/B552015/NpsBplcInfoInqireServiceV2请求参数为 camelCase如wkplNm、bzowrRgstNo、seq、dataCrtYm代理路由GET /v1/national-pension/workplace由 k-skill-proxy 持有DATA_GO_KR_API_KEY并在服务端调用 upstream密钥不出服务器。小结national-pension-workplace 是一个「代理持有密钥、用户零密钥、只读事实」的企业规模核查技能。它把公共数据门户的三步操作基础搜索 → 明细 → 月度序列封装为单一代理路由用「前 6 位 名称」的保守匹配策略规避身份误判并用去重与防御性过滤保证数据整洁。理解它的输入约束、响应结构与失败模式你就可以把它安全地嵌入交易对手尽调、雇主评估等合规查询流程同时守住「不查个人、不批量、不长期留存」的底线。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 k-skill 实战：使用 national-pension-workplace 技能查询韩国国民年金（국민연금）参保事业场所信息
k-skill 实战使用 national-pension-workplace 技能查询韩国国民年金국민연금参保事业场所信息【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill导读national-pension-workplace 是 k-skill 仓库中面向韩国商业场景的查询类技能它通过k-skill-proxy代理调用公共数据门户공공데이터포털的「国民年金公团_国民年金参保事业场所信息服务」data.go.kr 3046071V2 接口用来查询某家企业的国民年金参保人数、当月告知金额以及月度参保趋势从而间接判断公司员工规模及其增减变化。读完本文你将掌握该技能的完整用法、命令行参数、凭证配置方式、响应结构与失败排查方法并能理解其源码层面「只报事实、不做解读、不妄断同一性」的设计边界。技能定位与核心能力能查什么该技能围绕一个核心入口GET /v1/national-pension/workplace通过 instruction.md 定义的调用链可以提供三类查询结果参保事业场所候选列表用「事业场所名称상호 事业者登记号前 6 位」匹配出的事业场所列表同一资料生成年月dataCrtYm的重复数据按「每个事业场所保留最新月份」去重整理单一事业场所明细当候选唯一确定时返回参保人数jnngpCnt、当月告知金额crrmmNtcAmt、新增取得/丧失人员数月度参保现状时间序列按月份展示参保人数与告知金额的变动轨迹。一个关键前提事业者登记号只公开前 6 位国民年金数据中事业者登记号사업자등록번호只公开前 6 位后位被掩码无法做全号精确匹配。因此事业场所名称--name是必填参数候选结果由「名称 前 6 位前缀」共同决定当候选有多个时技能不擅自判定哪一个是要查的企业而是把列表原样返回由用户或下游流程自行确认。设计原则只报事实不做解读技能文档明确了两条设计原则见 instruction.md不生成任何解读性标签不输出分数、等级、「危险/风险」之类的判断只保留 upstream公共数据门户上游接口返回的事实候选不唯一时不断言同一性多个候选匹配时绝不说「这就是你查的那家公司」。这套原则在代理层源码中得到了一致的落实。national-pension.js 的响应中带有disclosure_note字段明确说明「事业者登记号只公开前 6 位无法全号匹配列出名称 6 位前缀匹配的候选多个匹配时由调用方自行确认身份」并且候选选取逻辑chosen只在去重后列表唯一、或精确同名唯一时才选定否则为null。使用场景技能文档列出的典型提问包括「○○ 公司员工规模大概多大用国民年金参保人数来看」「这个事业场所当月国民年金告知金额是多少」「最近人数是增加还是减少了按月看一下」。这类查询常用于交易对手尽职调查실사、入职前雇主评估、市场调研等正当核实场景。skill.json 中的profiles标注为proxy与lookup说明它属于「经代理查询」型的 lookup 技能不涉及任何写入或提交动作。运行前提与环境要求前置条件可访问互联网本机装有python3具备 helper 脚本 national_pension_workplace.py可访问 hosted 或 self-host 的k-skill-proxy的/v1/national-pension/workplace路由。凭证要求Credentials用户侧无需任何必填密钥——这是该技能的核心便利点因为 API Key 保存在代理运营端KSKILL_PROXY_BASE_URL仅在使用 self-host 代理时设置为空时默认使用 hosted 代理https://k-skill-proxy.nomadamas.orgDATA_GO_KR_API_KEY只放在代理运营服务器环境变量中并且需要在公共数据门户完成「国民年金公团_国民年金参保事业场所内역」的 활용신청服务利用申请。从 helper 源码 national_pension_workplace.py 可以看到代理地址解析逻辑resolve_proxy_base_url()会优先使用--proxy-base-url或环境变量若值被设为off、false、0、disable、disabled、none等则会抛出「KSKILL_PROXY_BASE_URL 已被禁用」错误若设为占位符replace-me或留空则回落至默认 hosted 地址。这种设计保证了 API 密钥永不落入用户侧。输入参数详解参数必填说明--name是事业场所名称상호。因为登记号只公开前 6 位名称是身份识别的主要依据--b-no否事业者登记号允许带连字符实际仅取其前 6 位作为前缀过滤条件Python helper 对--b-no的校验见 national_pension_workplace.py先用正则剔除所有非数字字符再要求恰好为 10 位数字\d{10}否则抛出「사업자등록번호는 숫자 10자리여야 합니다 (하이픈 허용)」错误校验通过后把完整 10 位数字传给代理。代理侧 national-pension.js 的normalizeNationalPensionQuery()则做了同样的归一化兼容wkplNm/name/b_nm与b_no/bno/bzowrRgstNo多种字段别名并把登记号slice(0, 6)取出前缀。注意名称缺失时代理直接抛错要求提供wkplNm——这与文档中「사업장명이 필수」的约束一致。CLI 使用示例技能文档给出的标准调用方式是通过 k-skill CLI 执行捆绑脚本npx -y nomadamas/k-skill0 exec national-pension-workplace scripts/national_pension_workplace.py -- \ --name 삼성전자(주) --b-no 124-81-00998命令拆解npx -y nomadamas/k-skill0 exec national-pension-workplace scripts/national_pension_workplace.py通过 CLI 以技能内相对路径解析并执行捆绑的 Python helper不要假设仓库相对路径或已安装技能路径这是 k-skill CLI 的资产访问约定见 national-pension-workplace.generic.md--之后的所有参数原样传给 helper--name传企业名称--b-no传带连字符的登记号。helper 内部main()构造查询后调用代理成功时向 stdout 打印带 2 空格缩进的 JSONensure_asciiFalse保留韩文返回码 0发生ValueError参数问题或ApiError代理/上游错误时把{error: ...}JSON 输出到 stderr返回码 1方便脚本化处理。如需指定 self-host 代理可追加--proxy-base-url https://your-proxy.example.com或预先导出KSKILL_PROXY_BASE_URL环境变量。源码级调用链代理端如何编排三次上游调用从 national-pension.js 的fetchNationalPensionWorkplace()可以看出一次「查询 → 明细 → 月度序列」的完整链路涉及三个 data.go.kr V2 操作getBassInfoSearchV2基础搜索以wkplNm、bzowrRgstNo6 位前缀、pageNo: 1、numOfRows: 100请求候选列表防御性前缀再过滤若传了前缀对返回条目按bzowrRgstNo前 6 位再过滤一次「trust upstream but verify」按月去重同一事业场所会按资料生成年月重复出现代理以「名称 道路名详细地址」为键分组每个组只保留dataCrtYm最新的条目再按年月倒序排列候选选定去重后若只剩 1 条或精确同名wkplNm wkplNm.trim()恰为 1 条则选定该条为selected_candidate否则为nullgetDetailInfoSearchV2明细查询用选定候选的seqdataCrtYm拉取参保人数、当月告知金额、取得/丧失人数getPdAcctoSttusInfoSearchV2期间现状查询用seq拉取月度参保状态序列并按年月升序排列。最终响应结构包含query、candidate_count、candidates、raw_row_count、selected_candidate、detail、monthly_status、disclosure_note等字段。该代码顶部注释也印证了设计意图「upstream 将事业者登记号掩码为前 6 位身份只能靠名称 6 位前缀确认多个候选匹配时原样返回列表不断言是哪家企业。」代理对 data.go.kr 网关的鉴权/配额错误码也做了归类returnReasonCode落在集合{20, 21, 30, 31, 32, 33}时判定为auth-error鉴权错误否则为普通errorresultCode非00/0时同样判定为业务错误。这些判断直接影响下面的失败模式。失败模式与排查技能文档列出了四种典型失败情形现象含义处置400 bad_request未提供事业场所名称补上--name参数重新查询503 upstream_not_configured代理服务器环境未配置DATA_GO_KR_API_KEY联系代理运营方配置密钥helper 会转成用户友好的「k-skill-proxy에 필요한 API 키가 설정되어 있지 않습니다」提示502 upstream_forbidden代理密钥未对服务 3046071 申请 활용신청或网关返回 401/403/鉴权错误码在公共数据门户完成该服务的利用申请或检查密钥有效性候选多个 →selected_candidate为null名称 6 位前缀匹配到多家事业场所用户应从candidates列表中人工指定具体企业Python helper 对错误的处理也值得注意national_pension_workplace.pyHTTP 503 且响应体error upstream_not_configured时给出密钥未配置提示响应体含message字段时透传该消息其余情况给出 HTTP 状态码若代理服务器本身不可达URLError则提示「설정된 k-skill-proxy 서버가 응답하지 않습니다」并附底层原因。隐私边界与合规运营标准技能文档对隐私边界有明确的自我约束国民年金数据只公开事业者登记号前 6 位因此技能仅列出「6 位一致 名称相似」的候选不断言事业场所同一性公开范围以法人、达到一定劳动者规模的场所为主小型/个体事业场所可能不公开。同时文档给出三条「法律安全运营基准」법적 안전 운영 기준只查询公团官方公开的事业场所信息参保人数与告知金额是国民年金公团通过公共数据门户公开的场所级信息不得查询或推测个别劳动者的个人信息明确查询目的限定于交易对手尽职调查、入职审查、市场调研等正当核实目的的个别查询对特定场所/行业进行大规模、定期收集时须先确认目的与法律依据依据不明确则不得进行结果保存最小化查询结果仅作当时参考不做长期存储与再分发。如何获取完整说明技能完整说明以 CLI 指令优先始终最新并适配当前运行时npx -y nomadamas/k-skill0 instruct national-pension-workplace查看捆绑文件清单npx -y nomadamas/k-skill0 files national-pension-workplace如需在本地直接阅读原始说明与源码本仓库提供了三份互为镜像的资产packages/k-skill-cli/skills/national-pension-workplace/CLI 打包版含 Python helper 与 skill.json、national-pension-workplace/仓库顶层版含 SKILL.md 与 instruction.md以及代理端实现 national-pension.js 与对应测试 server.test.js。官方数据面Official surfaces公共数据门户data.go.kr 数据 3046071 的开放 API 页面국민연금공단_국민연금 가입 사업장 내역upstream 接口https://apis.data.go.kr/B552015/NpsBplcInfoInqireServiceV2请求参数为 camelCase如wkplNm、bzowrRgstNo、seq、dataCrtYm代理路由GET /v1/national-pension/workplace由 k-skill-proxy 持有DATA_GO_KR_API_KEY并在服务端调用 upstream密钥不出服务器。小结national-pension-workplace 是一个「代理持有密钥、用户零密钥、只读事实」的企业规模核查技能。它把公共数据门户的三步操作基础搜索 → 明细 → 月度序列封装为单一代理路由用「前 6 位 名称」的保守匹配策略规避身份误判并用去重与防御性过滤保证数据整洁。理解它的输入约束、响应结构与失败模式你就可以把它安全地嵌入交易对手尽调、雇主评估等合规查询流程同时守住「不查个人、不批量、不长期留存」的底线。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考