Korea Ground-Truth / Tools / search_corporation

법인 검색 API — 회사명으로 DART 고유번호·종목코드 찾기

Korean Corporation Search API (DART corp_code by company name)

Cost: 1 credit/call (cache hit: 1). ≈ 10원/호출 · 출처: DART corpCode · 캐시 168시간

어떤 문제를 푸나

회사 이름만 알고 있을 때 금융감독원 DART에 등록된 정식 법인과 8자리 고유번호(corp_code), 상장 여부·종목코드를 찾습니다. 기업개황 조회의 첫 단계입니다.

• 회사명 → 정식 법인명 매핑
• 상장사 여부 판별
• 경쟁사/거래처 리스트 정규화

호출 방법

REST

curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/tools/search_corporation \
  -H "Authorization: Bearer kgt_live_..." \
  -H "content-type: application/json" \
  -d '{"name":"카카오","limit":2}'

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: "search_corporation 툴로 {"name":"카카오","limit":2} 조회해줘"

API 키 발급 (사람 불필요, 무료 50 credits)

curl -X POST https://kr-groundtruth-mcp.vercel.app/v1/accounts -H "content-type: application/json" -d '{"email":"you@example.com"}'

입력

응답 예시 (실제 응답, 2026-08-26)

{
  "ok": true,
  "data": {
    "source": "금융감독원 DART (opendart.fss.or.kr) corpCode 목록 (로컬 캐시)",
    "results": [
      {
        "corp_code": "00258801",
        "corp_name": "카카오",
        "stock_code": "035720",
        "listed": true,
        "modified_date": "20240329"
      },
      {
        "corp_code": "00918444",
        "corp_name": "카카오",
        "stock_code": null,
        "listed": false,
        "modified_date": "20170630"
      }
    ]
  },
  "meta": {
    "tool": "search_corporation",
    "cost": 1,
    "balance_remaining": 48,
    "cache_hit": false,
    "source": "DART corpCode",
    "fetched_at": "2026-08-26T14:00:00.000Z",
    "usage_event_id": "usg_…"
  }
}

모든 응답은 meta.cost, meta.balance_remaining를 포함합니다. 업스트림 오류 시 자동 환불되며, 잔액 부족 시 402 INSUFFICIENT_CREDITS와 함께 충전 URL이 반환됩니다.

함께 쓰는 툴

• 기업정보 조회 API — 대표자·법인등록번호·사업자번호·주소·설립일 (DART 기업개황) — Cost: 2 credits/call (cache hit: 1).

llms.txt · openapi.json · pricing.json