사업자 실사 복합 조회 (biz-health-check)
What this skill does
사업자등록번호(+상호/지역)를 입력하면 무료 공공 데이터 6종을 한 번에 교차 조회해 실사 리포트 한 장을 만든다. 같은 레포의 단품 스킬 helper를 그대로 재사용한다(단일 진실원천).
| 섹션 | 데이터 | 단품 스킬 | 경로 |
|---|---|---|---|
| 국세청 상태 | 계속/휴업/폐업·과세유형 | nts-business-registration | proxy |
| 국민연금 | 가입자수·당월 고지금액·월별 | national-pension-workplace | proxy |
| 체납 명단 | 고액·상습체납자 명단공개 대조 | nts-tax-delinquency | 직접(무인증) |
| 금융위 | 대표자·설립일·업종 법인개요 | fsc-corporate-info | proxy |
| 부정당제재 | 조회시점 유효 제재 | g2b-sanctioned-supplier | proxy |
| 인허가 영업상태 | 동네 사업장(208업종) 영업/폐업·업력 | localdata-business-status | 직접(무인증) |
공시 유무는 기존 k-dart 스킬을 함께 쓰면 된다.
Design principles
- 점수·등급·"위험" 같은 해석 라벨을 산출하지 않는다. 각 항목의 사실 + 출처 + 조회시각만 병렬한다. 판단은 사용자 몫이다.
- 한 항목 조회가 실패해도 전체를 막지 않고 그 항목만 정직하게 강등한다(
unavailable+ 사유). - 단품 helper를 찾지 못하면(개별 설치 등) 해당 섹션만 건너뛰고 나머지를 진행한다.
When to use
- "이 사업자(거래처/의뢰인) 실제 문제 없는지 한 번에 확인해줘"
- "○○○-○○-○○○○○ 살아있는 회사야? 직원은 좀 있고, 체납·입찰 제재 이력은 없어?"
Prerequisites
- 인터넷 연결,
python3 - 같은 레포의 단품 스킬 6종(이 복합이 helper를 재사용)
- proxy 섹션을 켜려면 hosted/self-host
k-skill-proxy접근 가능
Credential requirements
- 사용자 측 필수 시크릿 없음.
- proxy 섹션(국세청 상태·국민연금·금융위·부정당)은 운영 서버의
DATA_GO_KR_API_KEY로 동작한다. 활용신청 항목은 각 단품 스킬 문서를 따른다. - 무인증 섹션(체납·인허가)은 키 없이 사용자 머신에서 직접 동작한다.
Inputs
b_no: 사업자등록번호 10자리(하이픈 허용) — 상태조회·부정당제재에 필요--name: 상호·법인명 — 국민연금·금융위·체납·인허가에 필요--region: 시군구 — 인허가(동네 사업장) 조회에 필요 (예:제주제주시)--industry: 인허가 업종(여러 번 지정 가능). 생략 시 음식점·카페·숙박
CLI examples
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 숙박업Output
sections: 6개 섹션 각각의data(단품 응답 원문) 또는status: unavailable+note- 입력에 따라 일부 섹션은 생략된다(예:
--name없으면 국민연금/금융위/체납 생략).
Failure modes
- 섹션별 강등은 리포트에 그대로 남는다(전체 실패가 아니다).
- proxy 섹션이
503/502면 운영 서버 키·활용신청 문제 — 각 단품 스킬 문서 참고.
Official surfaces
- 각 단품 스킬 문서(
docs/features/<skill>.md)의 공식 출처를 따른다.
