national-pension-workplace
국민연금공단 국민연금 가입 사업장 내역을 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업장명으로 가입자수·당월 고지금액·월별 취득/상실 추이를 확인해 그 회사의 직원 규모와 변화를 본다.
Security Assessment
About national-pension-workplace
This skill queries the National Pension Service's enrolled-workplace dataset (data.go.kr 3046071, V2) through the `k-skill-proxy` to gauge a Korean company's headcount and its month-over-month change. Searching by workplace name (with the first six digits of a business number as an optional prefix filter), it returns matching workplace candidates and, when a single workplace is pinned down, details such as the number of enrolled subscribers (`jnngpCnt`), the current-month notified pension amount (`crrmmNtcAmt`), and monthly new-acquisition/loss counts, plus a month-by-month time series. It solves the problem of estimating a firm's employee scale and staffing trend from an authoritative public source.
A privacy boundary shapes the design: the National Pension data exposes only the first six digits of a business number (the rest masked), so a workplace name is mandatory and the skill lists six-digit-plus-name candidates without asserting they are the same entity. Coverage skews toward corporations and workplaces above a certain employee threshold; small or sole-proprietor workplaces may be absent. The skill reports only upstream facts, avoiding invented scores or risk labels, and does not assert identity when several candidates match.
The published entry is a CLI stub deferring to `npx -y @nomadamas/k-skill@0 instruct national-pension-workplace` for live instructions and running `scripts/national_pension_workplace.py` with a required `--name`. It targets recruiters, investors, and business-research users sizing up companies. No user-side secret is required; the data.go.kr key lives only on the proxy, and hard rules forbid storing plaintext credentials or bypassing legal boundaries.
FAQ
What can I learn about a company?
Its enrolled pension subscriber count (a proxy for headcount), the current-month notified pension amount, new-hire/loss counts, and a monthly time series — when a single workplace can be pinned down from the name search.
Why do I have to provide a workplace name?
The dataset masks all but the first six digits of the business number, so a name is required. The six-digit prefix is used only as a filter, and multiple matching candidates are returned without asserting they are the same workplace.
Are all companies covered?
No. Coverage skews toward corporations and workplaces above a certain employee size; small or individual businesses may not be disclosed.
Do I need credentials?
No user-side secret. `DATA_GO_KR_API_KEY` lives only on the proxy server (which must be approved for dataset 3046071); optionally set `KSKILL_PROXY_BASE_URL` for a self-hosted proxy.
Install national-pension-workplace
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
nomadamas/k-skill