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.9 KiB

Raw Permalink Blame History

name

description

license

metadata

g2b-sanctioned-supplier

조달청 나라장터 부정당제재업체정보를 공공데이터포털 API(k-skill-proxy 경유)로 조회한다. 사업자등록번호 정확 일치로 조회시점 현재 유효한 입찰참가자격 제한(부정당제재)의 기간·제재기관·근거법률을 확인한다.

MIT

category	locale	phase
business	ko-KR	v1

나라장터 부정당제재업체정보 조회

What this skill does

공공데이터포털의 조달청 나라장터 사용자정보 서비스(data.go.kr 15129466, getUnptRsttCorpInfo02)를 k-skill-proxy 경유로 호출해, 사업자등록번호 정확 일치(inqryDiv=1)로 조회시점 현재 유효한 부정당제재를 조회한다.

반환: 제재 시작/종료일자, 제재기관명, 계약법구분, 제재근거법률 등 upstream 필드 원문

Coverage boundary

upstream 명세상 다음은 제공되지 않는다 — 과거 이력 조회가 아니다.

조회시점에 제재만료·해제된 건
나라장터 미등록업체·개인에 대한 제재

만료 이력까지 보려면 나라장터(https://www.g2b.go.kr)에서 수동 확인이 필요하다.

Design principles

점수·등급·해석 라벨을 만들지 않는다. upstream 사실 + 출처 + 적용범위 한계만 담는다.

When to use

"이 회사 입찰 제재(부정당제재) 이력 있어?"
"거래/계약 전에 부정당업자 제재 여부 확인해줘"

Prerequisites

인터넷 연결, python3
scripts/g2b_sanctioned_supplier.py helper
hosted/self-host k-skill-proxy의 /v1/g2b/sanctioned-supplier route 접근 가능

Credential requirements

사용자 측 필수 시크릿 없음.
KSKILL_PROXY_BASE_URL — self-host 프록시를 쓸 때만 설정. 비우면 hosted https://k-skill-proxy.nomadamas.org 사용.
DATA_GO_KR_API_KEY 는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서 조달청_나라장터 사용자정보 서비스(부정당제재업체정보조회 포함) 활용신청이 되어 있어야 한다.

Inputs

--bizno: 사업자등록번호 10자리(하이픈 허용) — 필수

CLI examples

python3 g2b-sanctioned-supplier/scripts/g2b_sanctioned_supplier.py --bizno 124-81-00998

Failure modes

400 bad_request: 사업자번호가 10자리가 아님.
503 upstream_not_configured: 프록시 서버에 DATA_GO_KR_API_KEY 없음.
502 upstream_forbidden: 프록시 키가 15129466에 활용신청되지 않음.
total_count = 0: 조회시점 현재 유효한 제재 없음 (만료·미등록업체는 미제공임에 유의).

Official surfaces

공공데이터포털: https://www.data.go.kr/data/15129466/openapi.do
upstream: https://apis.data.go.kr/1230000/ao/UsrInfoService02/getUnptRsttCorpInfo02
수동 대조: 나라장터 https://www.g2b.go.kr
프록시 route: GET /v1/g2b/sanctioned-supplier

2.9 KiB Raw Permalink Blame History