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

2.2 KiB

Raw Permalink Blame History

사업자 실사 종합 (biz-health-check)

biz-health-check 스킬은 사업자등록번호(+상호/지역) 하나로 무료 공공 데이터 6종을 한 번에 교차 조회해 실사 리포트 한 장을 만든다. 같은 레포의 단품 스킬 helper를 그대로 재사용한다(단일 진실원천).

묶는 단품 스킬

섹션	단품 스킬	경로
국세청 사업자등록 상태	`nts-business-registration`	proxy
국민연금 가입 사업장	`national-pension-workplace`	proxy
국세 체납 명단공개	`nts-tax-delinquency`	직접(무인증)
금융위 기업기본정보	`fsc-corporate-info`	proxy
조달청 부정당제재	`g2b-sanctioned-supplier`	proxy
지방행정 인허가 영업상태	`localdata-business-status`	직접(무인증)

설계 원칙

점수·등급·"위험" 같은 해석 라벨을 산출하지 않는다. 각 항목의 사실 + 출처 + 조회시각만 병렬한다.
한 항목 조회가 실패해도 전체를 막지 않고 그 항목만 unavailable + 사유로 강등한다.
단품 helper를 찾지 못하면 해당 섹션만 건너뛰고 나머지를 진행한다.

인증/시크릿

사용자 측 필수 시크릿 없음.
proxy 섹션(국세청 상태·국민연금·금융위·부정당)은 운영 서버의 DATA_GO_KR_API_KEY로 동작한다.
무인증 섹션(체납·인허가)은 키 없이 사용자 머신에서 직접 동작한다.

예시

python3 biz-health-check/scripts/biz_health_check.py 124-81-00998 --name "삼성전자"

python3 biz-health-check/scripts/biz_health_check.py --name "호텔샬롬" --region 제주제주시 --industry 숙박업

입력

b_no: 사업자등록번호 10자리(하이픈 허용) — 상태조회·부정당제재에 필요
--name: 상호·법인명 — 국민연금·금융위·체납·인허가에 필요
--region: 시군구 — 인허가(동네 사업장) 조회에 필요
--industry: 인허가 업종(여러 번 지정 가능)

공식 출처

각 단품 스킬 문서의 공식 출처를 따른다. 통합 목록은 sources의 "사업자 실사" 항목 참조.

2.2 KiB Raw Permalink Blame History