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

Raw Permalink Blame History

인허가 영업상태 조회 (localdata-business-status)

localdata-business-status 스킬은 행정안전부 **지방행정 인허가데이터(LOCALDATA)**의 지역별 CSV를 file.localdata.go.kr에서 직접 받아 동네 사업장의 영업상태를 조회한다.

제공 기능

영업상태(영업/휴업/폐업)·상세영업상태·인허가일자(업력)·폐업일자·업태구분·도로명/지번 주소·데이터갱신시점
인허가 업종 208종 전체 지원 — 한글명("약국", "숙박업", "일반음식점")으로 지정 가능

인증/시크릿

없다. 무인증 공개 파일 서버이므로 프록시를 거치지 않고 사용자 머신에서 직접 호출한다. helper는 stdlib만 쓴다(추가 의존성 없음). 받은 파일은 1일 로컬 캐시한다.

입력/동일성 경계

전국 통파일이 업종당 수백 MB라 시군구 단위 지역 지정(--region)이 필요하다.
자료에 사업자등록번호가 수록되지 않아 상호(사업장명) 문자열 매칭만 가능하다. 동명 상호 가능성은 사용자가 판단한다.
자료는 매일 갱신되며 2일 전 기준으로 현행화된다.

예시

python3 localdata-business-status/scripts/localdata_business_status.py \
  --name "호텔샬롬" --region 제주제주시 --industry 숙박업

python3 localdata-business-status/scripts/localdata_business_status.py \
  --name "○○약국" --region 서울종로구 --industry 약국

입력

--name: 상호(사업장명) — 필수
--region: 시군구 — 필수 (예: 제주제주시, 서울종로구)
--industry: 업종 slug 또는 한글명(여러 번 지정 가능). 생략 시 일반음식점·휴게음식점·숙박업

실패 모드

unavailable + 안내: 상호/지역 미입력, 지역·업종 특정 실패(후보 나열), 다운로드 실패 — 수동 확인 URL 제공
0건: 매치 없음

공식 출처

인허가 영업상태: https://file.localdata.go.kr/file/download/<업종slug>/info?orgCode=<지자체코드> (무인증, Referer 필요, CP949 CSV)
본체: https://www.localdata.go.kr

2.1 KiB Raw Permalink Blame History