회사·기업집단 식별
resolve_entityResolve company names, stock codes, or group names into corp_code, stock code, and registration number. Returns candidates when ambiguous; optionally fetches affiliated group.
Instructions
회사명·종목코드·법인코드·법인등록번호·기업집단명을 받아 corp_code·stock_code·법인등록번호· 소속 기업집단으로 풀어줍니다.
동명 법인이 여럿이면 임의로 고르지 않고 status="ambiguous" 와 후보 목록을 돌려줍니다 (상호가 같아도 별개 법인일 수 있음) — 후보의 corp_code 로 다시 호출하세요
includeGroup=true 는 EGROUP_API_KEY 필요. 최초 1회는 전 기업집단을 순회해 포털 호출 ~103회를 소비합니다 (이후 1년간 캐시)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | 해석 대상. auto(기본)면 회사 → 기업집단 순으로 시도한다 | |
| query | Yes | 해석할 값. 회사명("삼성전자"), 종목코드("005930"), 법인코드 8자리("00126380"), 법인등록번호 13자리, 또는 기업집단명("삼성") | |
| yearMonth | No | 기업집단 기준 공개년월 YYYYMM (미지정 시 최신 지정연도를 추정) | |
| fetchJurirNo | No | 법인등록번호를 기업개황 API로 채울지 (기본 false, 호출 1회 소비). 기업집단포털과 대사하려면 필요하다 | |
| includeGroup | No | 회사를 찾은 뒤 소속 기업집단까지 조회할지 (기본 false). true 면 기업집단포털을 호출하며 EGROUP_API_KEY 가 필요하다 |