// 비교
코드에프 vs headless — 한국의 두 금융 데이터 API
코드에프와 headless는 둘 다 한국 금융기관 데이터를 코드로 다룹니다. 결이 어디서 갈리는지, 어떤 케이스에 무엇이 맞는지 사실 기반으로 정리합니다.
코드에프(CODEF)를 검토하다가 다른 선택지를 찾아 왔다면, 먼저 짚을 게 있습니다. 둘 다 한국 금융기관 데이터를 코드로 받는 계층입니다. Plaid 같은 글로벌 어그리게이터가 한국을 안 다루는 것과는 경우가 다릅니다 — 여기선 "한국을 다루느냐"가 아니라 "어떻게 다루느냐"에서 갈립니다.
두 접근이 강한 자리가 서로 다릅니다. 사실대로 가르겠습니다. 커버리지나 가격처럼 자주 바뀌는 수치는 각 제품 공식 문서에서 확인하시길 권합니다 — 이 글은 검증 가능한 구조 차이에 집중합니다.
30초 요약
- 코드에프가 맞을 때: 이미 코드에프로 구축된 시스템이 있거나, 레퍼런스가 많은 성숙한 한국 금융 API 생태계를 우선할 때
- headless가 맞을 때: AI 에이전트(MCP·Claude·Cursor)에서 자연어로 바로 쓰고 싶을 때, 기관과 무관한 단일 표준 형식과 5분 도입을 우선할 때
- 둘 다 안 맞으면: 자체 RPA — 단, 운영비부터 계산하시길 권합니다
결이 어디서 갈리나
두 제품 다 한국 은행·홈택스를 1차로 다룹니다. 차이는 그 위 설계에 있습니다.
headless는 기관마다 다른 인증·응답을 표준 데이터 형식 하나로 통일하고, 그 형식을 ContractRecord 같은 고정 셰이프로 노출합니다. 어느 기관에서 받아도 응답 모양이 같아서, 받는 쪽 코드가 기관 수와 무관하게 한 벌입니다. 이 설계의 내부 이야기는 새 은행 추가가 INSERT 한 줄인 이유에서 다룹니다.
또 하나는 진입 경로입니다. headless는 AI 에이전트 우선으로 설계해서, MCP와 Claude·Cursor·Gemini 통합을 1차로 제공합니다. 코드를 거의 안 쓰고 자연어 한 줄로 거래내역을 받는 흐름이 기본 동선입니다.
비교 표
자주 바뀌는 수치(지원 기관 수·정확한 가격)는 단정하지 않고 "공식 문서 확인"으로 둡니다. 날조보다 정직이 낫습니다.
| 항목 | 코드에프 | headless | 비고 |
|---|---|---|---|
| 한국 은행·카드 | 지원 | 지원 | 정확한 기관 목록은 각 공식 문서 |
| 홈택스(세금계산서·현금영수증) | 지원 | 지원 | 범위는 공식 문서 확인 |
| 응답 데이터 형식 | 제품 형식 | 기관 무관 단일 표준 형식 | headless는 고정 셰이프 |
| 인증 방식 추상화 | 한국 방식 지원 | 공동인증서·ID/PW 등 추상화 | |
| AI 에이전트 통합 | 공식 문서 확인 | MCP·Claude·Cursor·Gemini 1차 | headless의 기본 동선 |
| 자격증명 보관 | 제품 모델 | 봉투 암호화(AES-256) + 워크스페이스 분리 | |
| 첫 호출까지 | 공식 문서 확인 | 가입 → 키 발급 → 약 5분 | |
| 가격 모델 | 공식 가격표 | 데이터 수집 요청 단위 | 둘 다 공개 가격표 기준 비교 권장 |
자세히
코드에프가 강한 지점
한국 금융 API 시장에서 먼저 자리 잡아 도입 사례와 레퍼런스가 쌓여 있습니다. 이미 코드에프 기반으로 동작하는 시스템이 있다면, 검증된 경로를 유지하는 편이 합리적일 때가 많습니다. 성숙도와 생태계는 그 자체로 값입니다.
headless가 강한 지점
- 기관과 무관한 단일 표준 형식 — 받는 쪽 코드가 한 벌로 끝납니다
- AI 에이전트 first — MCP·Claude·Cursor·Gemini에서 자연어로 바로
- 자격증명 봉투 암호화(AES-256) + 워크스페이스 분리
- 가입에서 첫 호출까지 약 5분
어떤 형태로 쓰게 되나
같은 API라도 받은 데이터가 최종적으로 어디로 가느냐에 따라 동선이 갈립니다. 받은 데이터를 내 서비스의 사용자나 고객에게 다시 공급한다면 플랫폼 통합, 회사 내부 어드민·ERP·정산 DB에 적재한다면 내부 시스템 적재, 내 화면이나 로컬 파일에서 끝난다면 로컬 대시보드 쪽입니다. headless의 단일 표준 형식은 이 세 형태 어디에 두든 받는 쪽 매핑이 한 벌이라는 점에서 결이 같습니다.
같이 보는 그림
글로벌까지 필요한 팀은 Plaid와의 갈림도 같이 봅니다. 그 비교는 Plaid가 한국에 없을 때에 정리돼 있습니다. 한국 안에서의 선택은 "성숙한 생태계냐, AI 에이전트 우선의 단일 형식이냐"로 좁혀집니다.
자주 묻는 질문
Q. 코드에프에서 headless로 옮길 수 있나? 데이터 형식이 다르므로 받는 쪽 매핑은 다시 짭니다. headless는 기관 무관 단일 형식이라, 옮기고 나면 기관이 늘어도 그 매핑을 다시 건드리지 않습니다.
Q. 둘을 같이 쓰는 회사가 있나? 가능합니다. 기존 코드에프 경로를 유지하면서, 새 자동화 중 AI 에이전트 동선이 필요한 쪽만 headless로 분리하는 식입니다.
Q. 지원 기관·가격은 어디서 확인하나? 둘 다 자주 바뀌므로, 각 제품 공식 문서와 공개 가격표를 기준으로 같은 사용량으로 환산해 비교하시길 권합니다. 이 글은 그 수치를 단정하지 않습니다.
Q. 보안 모델 차이는? headless는 자격증명을 봉투 암호화(AES-256)로 저장하고 수집 시점에만 메모리에서 복호화하며, 복호화 키를 워크스페이스 단위로 분리합니다.
다음
한국 데이터를 코드로 받기로 했다면, 다음은 5분짜리 첫 호출입니다. Claude Code에서 5분 만에 거래내역 받아오기부터 보시거나, 받은 데이터를 내 서비스에 통합하는 그림이 궁금하면 플랫폼 통합으로 데이터 흘려보내기를 봅니다. 계약 형식이 궁금하면 API 레퍼런스에 정리돼 있습니다.