mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00

John 440cd697a7 feat: 사업자 실사 스킬군 — 단품 5종 + 복합 1종, proxy route 3개 추가 (#316 )

사업자등록번호로 "이 사업자 실제 문제 없나"를 무료 공공 데이터로 교차 조회하는
스킬군을 기여한다. 점수·등급·"위험" 라벨 없이 사실+출처+조회시각만 병렬한다.

단품 스킬:
- national-pension-workplace  국민연금 가입 사업장 (proxy, 3046071)
- nts-tax-delinquency         국세 체납 명단공개 (무인증 직접)
- fsc-corporate-info          금융위 기업기본정보 (proxy, 15043184)
- g2b-sanctioned-supplier     조달청 부정당제재 (proxy, 15129466)
- localdata-business-status   지방행정 인허가 영업상태 208업종 (무인증 직접)

복합 스킬:
- biz-health-check  위 5종 + 기존 nts-business-registration을 한 번에 호출

proxy(packages/k-skill-proxy):
- keyed route 3개 추가 — 키는 서버의 DATA_GO_KR_API_KEY로만 주입(사용자 시크릿 없음)
- 연금 route는 basic+detail+monthly 3콜 오케스트레이션 + 월별중복 dedup
- server.test.js에 route 테스트 10건 추가 (정상/503 미설정/400/403 forbidden)

무인증 스킬은 stdlib(urllib)만 사용해 의존성 없이 직접 호출한다.
문서: docs/features ×6, README 표·링크, docs/sources.md 갱신, plugin.json 재생성.

활용신청(프록시 운영 서버 등록 필요): 3046071·15043184·15129466
(15081808 국세청 상태조회는 nts-business-registration용으로 이미 등록, 키 공유).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-12 16:46:30 +09:00

1.7 KiB

Raw Permalink Blame History

국민연금 가입 사업장 조회 (national-pension-workplace)

national-pension-workplace 스킬은 공공데이터포털의 국민연금공단_국민연금 가입 사업장 내역 서비스(3046071, V2)를 k-skill-proxy 경유로 호출한다.

제공 기능

가입 사업장 후보: 사업장명 + 사업자번호 앞 6자리로 매칭, 자료생성년월별 중복은 사업장당 최신 월로 정리
단일 사업장 특정 시 상세: 가입자수(jnngpCnt), 당월 고지금액(crrmmNtcAmt), 신규취득/상실 인원
월별 가입 현황 시계열

인증/시크릿

사용자 로컬 시크릿은 필요 없다. upstream DATA_GO_KR_API_KEY는 프록시 서버에만 둔다(3046071 활용신청 필요). self-host 프록시는 KSKILL_PROXY_BASE_URL로 지정한다.

공개 범위

사업자번호는 앞 6자리만 공개(뒷자리 마스킹)되어 사업장명이 필수다. 후보가 여럿이면 동일성을 단정하지 않고 목록을 그대로 돌려준다.
법인·근로자 일정 규모 이상 사업장 위주로 공개되며, 소규모/개인 사업장은 미공개일 수 있다.

예시

python3 national-pension-workplace/scripts/national_pension_workplace.py \
  --name "삼성전자(주)" --b-no 124-81-00998

실패 모드

400 bad_request: 사업장명 미입력
503 upstream_not_configured: 프록시에 DATA_GO_KR_API_KEY 없음
502 upstream_forbidden: 프록시 키가 3046071에 미신청
selected_candidate: null: 후보 다수 — 사용자가 특정

공식 출처

공공데이터포털: https://www.data.go.kr/data/3046071/openapi.do
upstream: https://apis.data.go.kr/B552015/NpsBplcInfoInqireServiceV2
프록시 route: GET /v1/national-pension/workplace

1.7 KiB Raw Permalink Blame History