
1. DART API를 쓰기 전에 수집할 표의 기준부터 정합니다
DART API를 쓰면 여러 회사와 여러 해의 재무정보를 반복해서 받을 수 있습니다. 다만 데이터를 많이 모았다는 사실만으로 비교 가능한 분석표가 완성되지는 않습니다. 어떤 보고서의 어떤 기준을 가져왔는지 먼저 정해야 합니다. 이번 실습은 삼성전자와 SK하이닉스의 재무데이터를 표 붙여넣기, 엑셀 안의 클로드, 코드 수집이라는 세 경로로 정리하는 방법을 다룹니다.
가장 먼저 기업, 사업연도, 연결 또는 별도 기준, 필요한 계정을 적어 둡니다. 회사 이름이 같아도 연결재무제표와 별도재무제표는 범위가 다릅니다. 연간 보고서와 분기 보고서의 손익 금액도 같은 기간을 뜻하지 않습니다. 현재 필요한 것이 두 회사의 연간 비교라면 동일한 사업연도와 보고서 종류로 시작하고, 다른 기준의 자료는 별도로 구분해 두는 편이 확인하기 쉽습니다.
| 방법 | 맞는 작업 | 먼저 확인할 것 |
|---|---|---|
| DART 표 붙여넣기 | 한 표의 계정·연도를 빠르게 정리 | 단위, 괄호·음수, 빈칸 |
| Claude for Excel | 여러 시트의 데이터를 같은 표로 모으기 | 원본 시트·셀과 정리 위치 |
| Claude Code와 API | 기업·연도를 바꿔 반복 수집 | 연결 기준, 응답 상태, 출처 |
완성할 표에서는 계정과목을 행에, 연도를 열에 놓습니다. 여기에 숫자만 채우는 대신 회사, 보고서, 단위, 출처를 함께 남기세요. 예를 들어 같은 자본 항목을 두 곳에서 받았다면 어느 보고서의 당기 수치를 쓸지 정한 뒤 비교합니다. 표를 보기 좋게 만드는 작업과 원문을 맞추는 작업을 나눠 두면, 이후 비율 분석에서 잘못된 입력을 되짚기도 수월합니다.
이 단계에서는 성장률이나 투자 결론을 먼저 만들 필요가 없습니다. 입력 자료를 반복해서 재사용할 수 있게 정리하는 것이 먼저입니다. DART API로 수집을 시작하기 전에 삼성전자 연결재무제표 공식 자료에서 비교할 계정 한두 개를 골라 두면 뒤의 검산 기준으로 쓸 수 있습니다.
실습 더하기 · 기업·연도 요청 목록부터 만드세요
- 비교할 두 기업의 이름을 적고, DART API에 넣을 회사 고유번호를 확인합니다. 고유번호는 문자로 보관해 앞자리의 0이 사라지지 않게 합니다. 이름 검색으로 찾았다면 의도한 회사가 맞는지도 확인합니다.
- 필요한 사업연도를 목록으로 펼칩니다. ‘최근 10년’이라는 말만 DART API 수집 코드에 남기지 말고, 실제 조회할 시작 사업연도와 마지막 사업연도를 확인할 수 있게 요청합니다. 마지막 연도의 해당 보고서가 제출됐는지도 따로 확인합니다.
- 연간 비교가 목적이라면 보고서 종류를 같은 기준으로 맞춥니다. 한 회사는 사업보고서이고 다른 회사는 분기보고서인 상태에서 표의 열 이름만 같은 연도로 통일하지 않습니다.
- 같은 기업과 연도라도 연결과 별도 자료를 따로 요청했다면 두 요청을 구분합니다. 실행 전 중복된 조건 조합이 있는지 목록을 점검하고, 각각을 따로 받을 필요가 있는지 판단합니다.
2. 표 붙여넣기와 클로드 엑셀로 계정·연도를 정리합니다
기본 경로는 DART 화면의 표를 복사해 클로드 대화에 붙여 넣는 방법입니다. 복사한 표의 줄이나 간격이 깨져 보이더라도 곧바로 수기로 다시 입력하지 말고, 계정과 숫자를 구분하도록 요청해 보세요. 정리 과정에서 숫자 자체를 바꾸지 않게 하는 것이 핵심입니다. 원문의 표 머리글과 금액 단위도 함께 복사하면 연도와 단위가 빠지는 일을 줄일 수 있습니다.
아래 표를 계정과목이 행, 연도가 열인 표로 정리하라. 숫자와 단위는 바꾸지 말고, 빈칸이 있으면 표시하라.
답변이 나온 뒤에는 행 이름과 연도 열이 맞게 배치됐는지 봅니다. 빈칸이 구분을 위한 원래 빈칸인지, 복사 과정에서 빠진 숫자인지도 구분하세요. 괄호로 표시된 음수나 합계 행을 놓치지 않았는지 원문과 나란히 확인합니다. 빈칸을 자연스럽게 채우거나 같은 모양의 숫자로 바꾸는 것은 정리가 아니라 새로운 입력을 만드는 일이므로, 확인되지 않은 값은 그대로 남겨 둡니다.
여러 시트에 자료가 이미 있다면 엑셀 안의 클로드로 정리 범위를 좁힐 수 있습니다. Claude for Excel 공식 안내는 여러 시트 작업과 셀 단위 근거 확인 기능을 설명합니다. 어느 시트를 읽고 어느 시트에 결과를 넣을지 먼저 지정하고, 원본을 보존한 사본에서 진행하세요. 열 이름이나 계정명을 통일할 때도 원래 명칭을 함께 남겨야 나중에 원문을 찾기 쉽습니다.
실습 보완 요청은 다음처럼 구체적으로 할 수 있습니다.
이 워크북의 여러 시트에 흩어진 재무데이터를 한 시트로 모아 주세요. 원본 시트와 셀을 함께 표시하고, 단위와 연결·별도 기준이 다른 값은 섞지 말아 주세요.
이 요청은 여러 표를 한 곳에 모으는 작업을 위한 것입니다. 아직 다른 단위의 금액을 자동으로 합치거나, 이름이 비슷한 계정을 모두 같은 항목으로 바꾸도록 맡기지 마세요. 먼저 원본 셀과 결과 셀을 대조한 다음 필요한 환산이나 재분류를 별도 단계에서 합니다. 작업이 끝나면 원본 시트가 보존됐는지, 빈값이 0으로 바뀌지 않았는지, 정리한 값의 출처를 다시 찾아갈 수 있는지 확인합니다.
실습 더하기 · 붙여넣은 표를 원문과 나란히 검산하세요
- 먼저 표의 머리글을 읽습니다. 당기와 전기, 연도와 기말 표기가 어떤 열에 대응하는지 확인하고, 같은 연도라도 서로 다른 기준일의 값을 합치지 않았는지 봅니다. 원문의 표 이름도 함께 남깁니다.
- 다음에는 세부 계정과 합계 행을 구분합니다. 글자 모양이 비슷하다는 이유로 상위 항목과 하위 항목을 같은 행으로 묶었는지 확인합니다. 합계와 그 구성 항목을 동시에 더하는 수식이 만들어졌다면 원래 표의 구조로 돌아가 확인합니다.
- 빈칸, 대시, 괄호, 음수 표시를 확인합니다. 원문에서 값이 없던 칸과 복사하다 빠진 칸은 다르게 기록합니다. 숫자가 아닌 주석 표시나 계정 설명이 금액 칸에 붙어 들어갔는지도 봅니다.
- 마지막으로 정리한 숫자 일부를 원문에서 직접 찾아 대조합니다. 표가 여러 페이지에 걸쳐 있다면 이어지는 머리글과 단위 표시가 빠지지 않았는지 확인합니다. 다르면 그 셀을 표시하고 변경 이유를 함께 적습니다.
실습 더하기 · 여러 시트의 숫자를 모아도 출처는 남기세요
- 원본 워크북을 보존하고 작업할 사본을 엽니다. 클로드에 읽을 시트 이름과 새 결과를 넣을 시트 이름을 구분해 알려 주세요. 이미 결과 시트가 있다면 그 안의 어떤 범위를 바꾸는지 먼저 확인합니다.
- 기업·계정·연도별로 원본 시트 이름과 셀 주소를 대응시킵니다. 같은 숫자가 여러 표에 반복돼 있다면 어느 표를 기준으로 삼을지 정합니다. 원본에서 이미 환산된 값인지도 이 단계에서 확인합니다.
- 정리 시트의 각 열이 무엇을 뜻하는지 설명을 남깁니다. 원문 계정명과 분석용 이름을 다르게 썼다면 두 이름의 대응 관계를 보존하세요. 표시 이름을 바꾸는 작업과 서로 다른 계정을 하나로 합치는 작업을 구분합니다.
- 결과 셀 몇 개를 선택해 실제 원본 셀로 돌아갑니다. 숫자뿐 아니라 기업, 연도, 단위가 모두 맞는지 봅니다. 수식으로 연결한 경우에는 참조가 같은 워크북의 올바른 셀을 가리키는지도 확인합니다.
3. DART API와 Claude Code로 기업·연도별 수집을 반복합니다
대상 기업이나 연도가 늘어나면 DART API를 이용하는 코드 경로가 유용합니다. 원본 실습에서는 Claude Code에 삼성전자와 SK하이닉스의 최근 10년 연결재무제표 주요 계정을 받아 엑셀로 저장하도록 요청합니다. 코드는 한 번 만들고 끝내기보다, 다음 기업과 기간에도 같은 기준으로 실행할 수 있도록 수집 조건을 드러내는 형태로 정리합니다.
시작 전 Open DART에서 인증키를 준비하고 작업 폴더를 정합니다. 키는 프롬프트나 코드 본문에 붙여 넣지 않고 환경변수 DART_API_KEY에서 읽도록 합니다. Claude Code가 DART API 코드를 실행하기 전에 어떤 자료를 조회하며 어느 폴더에 어떤 파일을 저장하는지 확인하세요. 기존 분석 파일과 이름이 겹치면 새 결과를 구분할 수 있는 이름으로 저장하도록 지정합니다.
DART 오픈 API로 삼성전자와 SK하이닉스의 최근 10년 연결재무제표 주요 계정을 받아 엑셀 파일로 저장하는 파이썬 코드를 만들고 이 폴더에서 실행하라. 인증키는 코드에 직접 쓰지 말고 환경변수 DART_API_KEY에서 읽어라.
PDF 4쪽 열기금융감독원 단일회사 전체 재무제표 개발가이드에서 DART API의 요청 조건과 응답 항목을 확인할 수 있습니다. 회사 고유번호, 사업연도, 보고서 코드, 연결·별도 구분이 요청에 들어갑니다. 연간 사업보고서는 11011, 연결재무제표는 CFS로 구분됩니다. 회사 고유번호를 주식 종목코드와 혼동하지 않고, 필요한 보고서 기준을 코드에도 분명히 반영하는지 봅니다.
조회 결과가 비어 있을 때는 우선 DART API의 응답 상태와 메시지를 확인합니다. 자료 없음과 요청 제한은 같은 문제가 아닙니다. 누락된 연도를 임의로 채워 넣거나 조회되지 않은 계정을 0으로 바꾸면 안 됩니다. 요청한 회사·연도 목록과 실제 받은 목록을 나란히 놓고 어느 구간이 비었는지 기록한 다음, 해당 조건과 원문을 다시 확인합니다.
또한 DART API 응답의 금액을 보고서의 백만원 표시와 그대로 비교하지 마세요. 원래 금액과 통화·표시 단위를 남긴 뒤 같은 단위로 맞춰 대조합니다. 손익계산서의 기간 금액과 재무상태표의 시점 잔액도 따로 구분합니다. 엑셀에서는 원본 응답 시트와 보기 좋게 정리한 시트를 분리해 두면, 열 이름이나 금액 표시를 바꾼 뒤에도 실제 입력을 추적할 수 있습니다.
실습 더하기 · 자료 없음과 요청 제한을 다르게 처리하세요
000, 조회된 데이터 없음은 013, 요청 제한 초과는 020으로 구분합니다. 인증키나 접근 조건에 관한 오류도 별도 상태로 안내합니다. 숫자가 비어 있는 이유를 알아보기 전에 금액 0을 넣지 마세요.- 정상 응답을 받았으면 요청한 계정과 기간이 실제 목록에 있는지 확인합니다. 요청 처리가 정상이라는 상태와 원하는 계정이 전부 채워졌다는 상태를 같은 의미로 기록하지 않습니다.
- 자료 없음이 표시되면 기업 고유번호, 사업연도, 보고서 종류, 연결·별도 기준을 다시 확인합니다. 해당 보고서가 실제로 제출됐는지도 공시 원문에서 봅니다. 연결 자료가 없다는 이유로 별도 자료를 자동 대입하지 않습니다.
- DART API의 요청 제한이 표시되면 반복 실행을 멈추고 현재까지 받은 자료를 보존합니다. 제한 조건을 확인한 뒤 남은 요청을 어떻게 처리할지 정하세요. 인증키를 바꾸거나 여러 환경으로 나눠 제한을 피하는 방식으로 진행하지 않습니다.
- DART API 인증키나 접근 조건의 오류가 표시되면 상태와 메시지만 남깁니다. 점검을 위해 실제 인증키를 채팅 답변이나 공유 로그에 출력하지 않도록 합니다. 코드의 환경변수 이름과 실제 키의 값을 구분합니다.
실습 더하기 · 연결 기준과 금액 단위를 맞춰 대조하세요
- 기업과 사업연도를 먼저 확인합니다. DART API 응답에 전기 비교 금액이 함께 있으면 그 값이 어느 기간을 뜻하는지 구분하세요. 여러 사업연도의 응답을 합치면서 같은 기간의 금액이 중복으로 들어오지 않았는지도 봅니다.
- 보고서 종류와 연결·별도 기준을 확인합니다. 원문은 연결재무제표인데 API 요청이 별도로 돼 있다면 금액을 맞추기 전에 요청 조건을 바로잡습니다. 비교 기준을 바꿨으면 그 변경 이유와 다시 받은 자료를 남깁니다.
- 금액의 통화와 표시 단위를 확인합니다. DART API 응답 금액과 보고서의 단위 표시를 따로 남기고, 비교할 때만 같은 단위로 환산합니다. 원본 숫자를 환산한 숫자로 덮어쓰지 않도록 합니다.
- 계정의 범위와 공시 버전을 확인합니다. 이름이 비슷한 합계와 세부 항목을 비교하고 있지 않은지 봅니다. 정정된 자료라면 어느 공시를 기준으로 삼았는지 기록하고, 정정 전후 값을 임의로 혼합하지 않습니다.

4. 공시 원문과 수집 목록을 대조해 분석용 엑셀을 완성합니다
DART API로 만든 파일을 열었다면 열 개수나 색상보다 먼저 기업과 연도를 확인하세요. 두 회사가 각각 들어 있는지, 요청한 기간이 이어지는지, 연결·별도 기준이 섞이지 않았는지를 봅니다. 계정 이름이 다르다는 이유만으로 서로 다른 데이터를 같은 행에 합쳤다면 그 대응표도 확인해야 합니다. 단순히 빈칸이 없는 파일보다, 비어 있는 이유를 설명할 수 있는 파일이 다시 사용하기 좋습니다.
후속 검산 요청에는 수집 기준과 출처를 한꺼번에 남기도록 합니다.
기업별로 수집한 사업연도·보고서 종류·연결/별도 기준·계정명·원래 금액·통화 단위·공시 접수번호를 남겨 주세요. 원본 응답 시트와 정리 시트를 분리하고, 조회되지 않은 항목은 0으로 바꾸지 말고 상태와 이유를 적어 주세요. 사업보고서와 대조할 항목을 기업마다 두 개 골라 검산 목록을 만들어 주세요.
기업마다 매출액이나 자본총계처럼 원문에서 찾기 쉬운 항목을 골라 대조해 보세요. 숫자가 다르면 보고서 종류, 연결 여부, 금액 단위, 정정된 공시 여부를 차례로 확인합니다. 어느 입력이 잘못됐는지 찾기 전에 결과 숫자만 직접 덮어쓰면, 같은 DART API 코드로 다시 수집했을 때 차이가 반복될 수 있습니다. 변경한 조건과 다시 받은 결과를 함께 남기는 편이 낫습니다.
| 점검 | 엑셀에서 남길 기록 |
|---|---|
| 수집 범위 | 회사·사업연도·보고서 종류·연결/별도 기준 |
| 원문 추적 | 공시 접수번호·계정명·원래 금액·통화 단위 |
| 누락 처리 | 조회 상태·누락 항목·재확인한 조건 |
| 검산 결과 | 대조한 원문 항목·표시 단위·차이와 수정 내역 |
다음 분석에 넘길 때는 검산한 입력표와 원본 응답, DART API 수집 코드를 함께 보관합니다. 비율 시트는 이 입력표를 참조하도록 만들면 어떤 숫자에서 계산이 시작되는지 따라갈 수 있습니다. 사업연도나 기업을 바꿔 다시 실행할 때도 동일한 점검 목록을 쓰세요. 수집 자동화의 목적은 검산을 생략하는 것이 아니라, 반복해서 받는 과정을 줄이고 숫자의 근거를 확인하는 시간을 확보하는 데 있습니다.
이렇게 표 붙여넣기에서 시작해 엑셀 안의 정리와 API 수집으로 확장하면 현재 업무 규모에 맞는 경로를 선택할 수 있습니다. 한 번의 표 정리에는 기본 경로를, 여러 시트와 반복 수집에는 그에 맞는 도구를 사용하고, 마지막에는 같은 원문 기준으로 결과를 확인하세요.
실습 더하기 · 다음 사람이 다시 받을 수 있게 인계하세요
- 수집 조건 기록에는 기업, 기간, 보고서 종류와 연결 기준을 남깁니다. 실행 일시와 결과 파일 위치를 적고, 완료되지 않은 요청이 있으면 별도 목록을 연결합니다. 요청한 범위와 실제 받은 범위를 구분해 적습니다.
- 원본 응답과 정리 시트를 함께 보관합니다. 정리 시트에서 이름이나 단위를 바꿨다면 대응표와 환산 규칙을 남깁니다. 분석용 이름만 보고 원래 계정을 찾을 수 없는 상태로 인계하지 않습니다.
- DART API 수집 코드와 다시 실행하는 방법을 기록합니다. 필요한 환경변수의 이름은 적되 실제 인증키는 포함하지 않습니다. 코드를 받은 사람이 자기 환경에서 준비할 항목과 실행 결과가 저장될 위치를 구분해 안내합니다.
- 검산 내역에는 대조한 계정과 원문 위치, 찾은 차이, 수정한 조건을 남깁니다. 아직 확인하지 못한 항목은 남은 작업으로 적습니다. 결과 파일을 저장했다는 이유로 검산까지 끝났다고 표시하지 않습니다.

DART 재무데이터 수집 실습 가이드 · PDF 바로 보기
AI를 활용한 재무제표 분석 실전 올인원에서 공시의 숫자와 주석을 읽고 엑셀 입력값을 검산하는 방법을 익히세요.
재무제표 분석·기업가치평가 동시 수강도 살펴보실 수 있습니다.
팀 단위 기업교육을 검토한다면 기업 분석과 재무 모델링 교육을 확인하세요.
