mirror of
https://github.com/NomaDamas/k-skill.git
synced 2026-06-24 02:04:11 +00:00
440cd697a7
사업자등록번호로 "이 사업자 실제 문제 없나"를 무료 공공 데이터로 교차 조회하는 스킬군을 기여한다. 점수·등급·"위험" 라벨 없이 사실+출처+조회시각만 병렬한다. 단품 스킬: - 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>
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 인허가 영업상태 조회 (localdata-business-status)
|
|
|
|
`localdata-business-status` 스킬은 행정안전부 **지방행정 인허가데이터(LOCALDATA)**의 지역별 CSV를 `file.localdata.go.kr`에서 직접 받아 동네 사업장의 영업상태를 조회한다.
|
|
|
|
## 제공 기능
|
|
|
|
- 영업상태(영업/휴업/폐업)·상세영업상태·인허가일자(업력)·폐업일자·업태구분·도로명/지번 주소·데이터갱신시점
|
|
- 인허가 업종 **208종 전체** 지원 — 한글명("약국", "숙박업", "일반음식점")으로 지정 가능
|
|
|
|
## 인증/시크릿
|
|
|
|
없다. 무인증 공개 파일 서버이므로 프록시를 거치지 않고 사용자 머신에서 직접 호출한다. helper는 stdlib만 쓴다(추가 의존성 없음). 받은 파일은 1일 로컬 캐시한다.
|
|
|
|
## 입력/동일성 경계
|
|
|
|
- 전국 통파일이 업종당 수백 MB라 시군구 단위 지역 지정(`--region`)이 필요하다.
|
|
- 자료에 **사업자등록번호가 수록되지 않아** 상호(사업장명) 문자열 매칭만 가능하다. 동명 상호 가능성은 사용자가 판단한다.
|
|
- 자료는 매일 갱신되며 2일 전 기준으로 현행화된다.
|
|
|
|
## 예시
|
|
|
|
```bash
|
|
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>
|