mirrors/k-skill
2
0
Fork 0
mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
k-skill/docs/features/fsc-corporate-info.md
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

1.6 KiB
Raw Permalink Blame History

금융위 기업기본정보 조회 (fsc-corporate-info)

fsc-corporate-info 스킬은 공공데이터포털의 금융위원회_기업기본정보 서비스(15043184, getCorpOutline_V2)를 k-skill-proxy 경유로 호출한다.

제공 기능

  • 법인명(corpNm) 기준 후보: 대표자·설립일·업종 등 upstream 필드 원문
  • 사업자번호 교차검증: 응답에 bzno가 있으면 입력 번호와 정확 일치하는 후보를 분리(없으면 교차검증 불가 표기)

인증/시크릿

사용자 로컬 시크릿은 필요 없다. upstream DATA_GO_KR_API_KEY는 프록시 서버에만 둔다(15043184 활용신청 필요). self-host 프록시는 KSKILL_PROXY_BASE_URL로 지정한다.

입력 제한

검색 파라미터가 crno(법인등록번호 13자리)/corpNm(법인명)뿐이라 사업자번호 단독 조회가 불가하다. 법인명으로 조회한다. crno는 사업자등록번호와 별개 번호다.

예시

python3 fsc-corporate-info/scripts/fsc_corporate_info.py --name "삼성전자" --b-no 124-81-00998

실패 모드

  • 400 bad_request: 법인명 미입력
  • 503 upstream_not_configured: 프록시에 DATA_GO_KR_API_KEY 없음
  • 502 upstream_forbidden: 프록시 키가 15043184에 미신청
  • 빈 결과: 법인명 불일치 — 표기를 바꿔 재시도

공식 출처