biz-health-check

Original：🇺🇸 English

Translated

1 scripts

사업자등록번호 하나로 "이 사업자, 실제 문제 없나"를 확인한다 — 국세청 사업자등록 상태·국민연금 가입 사업장·국세 체납 명단·금융위 법인개요·조달청 부정당제재·지방행정 인허가 영업상태를 무료 공공 데이터로 교차 조회해 사실만 병렬하는 실사 리포트(점수·등급·위험 판정 없음).

6installs

Sourcenomadamas/k-skill

Added on2026-07-20

NPX Install

npx skill4agent add nomadamas/k-skill biz-health-check

SKILL.md Content

View Translation Comparison →

사업자 실사 복합 조회 (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

bash

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
```
)의 공식 출처를 따른다.