Back to Details

fsc-corporate-info

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

금융위 기업기본정보(법인 개요) 조회

金融委员会企业基本信息（法人概要）查询

What this skill does

What this skill does

공공데이터포털의 금융위원회_기업기본정보 서비스(data.go.kr 15043184, 
getCorpOutline_V2
)를 
k-skill-proxy
경유로 호출해 법인 개요를 조회한다.
  • 법인명(
    corpNm
    ) 기준 후보 목록: 대표자·설립일·업종 등 upstream 필드 원문
  • 사업자번호 교차검증: 응답 item에 
    bzno
    가 있으면 입력 사업자번호와 정확 일치하는 후보를 분리한다 (
    bzno
    가 없으면 교차검증 불가 사실을 그대로 표기)
이 API의 검색 파라미터는 
crno
(법인등록번호 13자리)/
corpNm
(법인명)뿐이라 사업자번호 단독 조회가 불가하다. 법인명으로 조회한다.
通过
k-skill-proxy
调用公共数据门户的金融委员会_企业基本信息服务（data.go.kr 15043184，
getCorpOutline_V2
）来查询法人概要信息。
  • 基于法人名称(
    corpNm
    )的候选列表：代表者、成立日期、行业等上游字段原文
  • 营业执照号码交叉验证：若响应条目包含
    bzno
    ，则分离出与输入营业执照号码完全匹配的候选（若没有
    bzno
    则直接标注无法进行交叉验证）
该API的搜索参数仅为
crno
（13位法人登记号）/
corpNm
（法人名称），因此无法单独通过营业执照号码查询。需通过法人名称进行查询。

Design principles

Design principles

  • 점수·등급·해석 라벨을 만들지 않는다. upstream 사실 + 출처만 담는다.
  • crno
    (법인등록번호)는 사업자등록번호와 별개 번호임을 혼동하지 않는다.
  • 不创建分数、等级、解读标签。仅包含上游事实信息及来源。
  • 注意不要混淆
    crno
    （法人登记号）与营业执照号码，二者是独立的编号。

When to use

When to use

  • "이 법인 대표자·설립일·업종 개요 확인해줘"
  • "법인명으로 기업 기본정보 조회해줘"
  • "帮我确认这家法人的代表者、成立日期、行业概要"
  • "通过法人名称查询企业基本信息"

Prerequisites

Prerequisites

  • 인터넷 연결, 
    python3
  • scripts/fsc_corporate_info.py
    helper
  • hosted/self-host 
    k-skill-proxy
    의 
    /v1/fsc/corp-outline
    route 접근 가능
  • 互联网连接、
    python3
  • scripts/fsc_corporate_info.py
    辅助脚本
  • 可访问托管/自托管
    k-skill-proxy
    的
    /v1/fsc/corp-outline
    路由

Credential requirements

Credential requirements

  • 사용자 측 필수 시크릿 없음.
  • KSKILL_PROXY_BASE_URL
    — self-host 프록시를 쓸 때만 설정. 비우면 hosted 
    https://k-skill-proxy.nomadamas.org
    사용.
  • DATA_GO_KR_API_KEY
    는 프록시 운영 서버 환경에만 둔다. 공공데이터포털에서 
    금융위원회_기업기본정보
    활용신청이 되어 있어야 한다.
  • 用户无需提供必要密钥。
  • KSKILL_PROXY_BASE_URL
    — 仅在使用自托管代理时设置。留空则使用托管地址
    https://k-skill-proxy.nomadamas.org
    。
  • DATA_GO_KR_API_KEY
    仅需在代理运营服务器环境中配置。需在公共数据门户完成
    金融委员会_企业基本信息
    的使用申请。

Inputs

Inputs

  • --name
    : 법인명(
    corpNm
    ) — 필수
  • --b-no
    : 사업자등록번호. 응답에 
    bzno
    가 있을 때 교차검증에만 쓰인다.
  • --name
    : 法人名称(
    corpNm
    ) — 必填
  • --b-no
    : 营业执照号码。仅在响应包含
    bzno
    时用于交叉验证。

CLI examples

CLI examples

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

Failure modes

Failure modes

  • 400 bad_request
    : 법인명을 주지 않음.
  • 503 upstream_not_configured
    : 프록시 서버에 
    DATA_GO_KR_API_KEY
    없음.
  • 502 upstream_forbidden
    : 프록시 키가 15043184에 활용신청되지 않음.
  • 빈 결과: 법인명 불일치 — 표기를 바꿔 재시도.
  • 400 bad_request
    : 未提供法人名称。
  • 503 upstream_not_configured
    : 代理服务器未配置
    DATA_GO_KR_API_KEY
    。
  • 502 upstream_forbidden
    : 代理密钥未完成15043184服务的使用申请。
  • 空结果：法人名称不匹配 — 修改名称后重试。

Official surfaces

Official surfaces