Korea Ground-Truth / Tools / lookup_corporation
기업정보 조회 API — 대표자·법인등록번호·사업자번호·주소·설립일 (DART 기업개황)
Korean Company Profile API (CEO, corporate registration no., address — DART)
Cost: 2 credits/call (cache hit: 1). ≈ 20원/호출 · 출처: DART (opendart.fss.or.kr) · 캐시 168시간
어떤 문제를 푸나
법인의 공식 프로필(정식 법인명, 대표자, 법인등록번호, 사업자등록번호, 본점 주소, 업종코드, 설립일, 상장시장)이 필요합니다. 금융감독원 DART 원본을 그대로 정규화합니다.
- B2B 온보딩 시 법인 정보 자동 채움
- 계약서 당사자 정보 검증
- 투자·리서치용 기업 프로필 수집
호출 방법
REST
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/lookup_corporation \
-H "Authorization: Bearer kgt_live_..." \
-H "content-type: application/json" \
-d '{"corp_code":"00126380"}'MCP (Claude Code / Cursor / any MCP client)
claude mcp add --transport http kgt https://kr-groundtruth-mcp.vercel.app/api/mcp --header "Authorization: Bearer kgt_live_..."
# then ask: "lookup_corporation 툴로 {"corp_code":"00126380"} 조회해줘"API 키 발급 (사람 불필요, 무료 50 credits)
curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'입력
| field | type | required | description |
|---|---|---|---|
corp_code | string | yes | DART 고유번호 8자리 |
응답 예시 (실제 응답, 2026-08-26)
{
"ok": true,
"data": {
"fax": "031-200-7538",
"phone": "02-2255-0114",
"ir_url": null,
"market": "KOSPI",
"source": "금융감독원 DART (opendart.fss.or.kr)",
"address": "경기도 수원시 영통구 삼성로 129 (매탄동)",
"ceo_name": "전영현, 노태문",
"homepage": "www.samsung.com/sec",
"corp_code": "00126380",
"corp_name": "삼성전자(주)",
"market_raw": "Y",
"stock_code": "005930",
"stock_name": "삼성전자",
"corp_name_en": "SAMSUNG ELECTRONICS CO,.LTD",
"industry_code": "264",
"established_date": "19690113",
"fiscal_year_end_month": "12",
"business_registration_number": "1248100998",
"corporate_registration_number": "1301110006246"
},
"meta": {
"tool": "lookup_corporation",
"cost": 2,
"balance_remaining": 48,
"cache_hit": false,
"source": "DART (opendart.fss.or.kr)",
"fetched_at": "2026-08-26T14:00:00.000Z",
"usage_event_id": "usg_…"
}
}모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.
함께 쓰는 툴
- 법인 검색 API — 회사명으로 DART 고유번호·종목코드 찾기 — Cost: 1 credit/call (cache hit: 1).
- 사업자등록번호 조회 API — 계속사업자/휴업/폐업 상태 확인, 진위확인 — Cost: 2 credits/call (cache hit: 1).