# DART 공시 PDF 자동 다운로드 만들기 — 비전공자 도전기
마이네임코드
2026.05.29
# DART 공시 PDF 자동 다운로드 만들기 — 비전공자 도전기
> 코딩을 잘 모르는 상태에서 Claude와 함께 **상장사 공시 자료(사업보고서·분기보고서)를 PDF로 자동으로 받는 도구**를 만든 과정의 기록.
---
## 🎯 시작: 내가 원했던 것
DART(전자공시시스템, dart.fss.or.kr)에는 상장사들의 사업보고서·분기보고서 같은 공시 자료가 다 올라와 있다. 이걸 **회사별로, 기간별로, 자동으로 PDF로 받고 싶었다.**
원래는 사이트에서 하나씩 클릭해서 다운로드해야 하는데, 회사 하나당 20~30개씩 받으려면 너무 번거롭다.
---
## 🪨 첫 번째 벽: "PDF가 아니라 ZIP만 받아짐"
처음에 기본 스크립트(`dart_download.py`)가 있었는데, 이건 DART **공식 API(Open API)**를 써서 받는 거였다. 그런데 문제가 있었다.
> **DART 공식 API는 PDF를 안 준다.** 원본 XML/HTML 파일을 압축한 ZIP만 준다.
내가 원한 건 PDF인데… 어떻게 해야 할까?
### 💡 해결: DART **웹사이트**의 PDF 다운로드 기능을 이용
공식 API는 PDF를 안 주지만, **DART 웹사이트(dart.fss.or.kr)에는 PDF 다운로드 버튼**이 있다. 그걸 프로그램이 대신 눌러주게 만들면 된다.
실제 흐름:
1. 공시 뷰어 페이지에서 **PDF용 문서번호(dcm_no)** 찾기
2. PDF 다운로드 URL로 요청 → PDF 파일 받기
스크립트에 이 기능을 추가했다 (`download_pdf` 함수).
---
## 🔑 API 키 발급 (회원가입)
공시 **목록 조회**에는 여전히 공식 API가 필요해서 키를 발급받아야 했다.
### 발급 과정
1. **opendart.fss.or.kr** 접속 → "인증키 신청" 버튼
2. 회원가입 (이메일, 비밀번호, 이름, 사용 용도)
- **사용 용도**: "개인 투자 분석용"으로 적음
- **사용 URL**: `http://localhost` (=내 컴퓨터에서만 쓴다는 뜻)
3. **이메일 인증 링크** 클릭
4. 로그인 후 **"오픈API 이용현황"** 메뉴에서 **40자리 API 키** 확인
(처음엔 "마이페이지"에서 안 보여서 헤맸음 → 별도 메뉴에 있었음)
---
## 🧪 첫 실행: 삼성전자 다운로드
### 1단계: 목록 먼저 확인 (다운 안 받고)
```powershell
python dart_download.py --company "삼성전자" --begin 20210101 --end 20260528 --type A --list-only --api-key [내키]
```
→ 정기공시 **22건** 확인. 사업보고서 6개, 반기보고서 5개, 분기보고서 11개.
### 2단계: 선별해서 받기
전부 받기엔 너무 많아서 골랐다:
- **사업보고서**: 전체 6년치 (꼭 필요)
- **반기보고서**: 2025년치 1건
- **분기보고서**: 2025·2026년치 3건
- **합계: 10건**
→ 임시 스크립트(`_run_download.py`)로 10건 PDF 다운로드 ✅
---
## 📚 두 번째 회사: LG전자 — 새로운 발견
같은 방식으로 LG전자도 받았는데, 새로운 게 있었다.
### 💡 정정본의 존재
LG전자 사업보고서 중에 이런 게 있었다:
```
20210316000661 사업보고서 (2020.12)
20210316001210 [첨부정정]사업보고서 (2020.12) ← 같은 연도, 정정본
```
→ **원본에 오류가 있어 나중에 수정해서 다시 올린 게 정정본.** 더 정확한 자료니까 정정본을 받아야 한다.
LG전자도 정정본 우선해서 10건 다운로드 완료 ✅
---
## 🛠️ 결정적 발전: 재사용 가능한 도구로
여기까지는 매번 임시 스크립트를 새로 만들어서 받았다. **다른 회사 받을 때마다 코드 수정해야 함** → 비효율적.
그래서 **회사명만 바꿔서 한 줄로 실행되는 도구**를 만들었다: `download_company.py`
### 자동으로 해주는 것
- 회사명만 입력하면 정기공시 목록 자동 조회
- **사업보고서 전체** + **최근(작년 이후) 분기/반기보고서**만 자동 선택
- **정정본이 있으면 자동으로 우선** 선택
- PDF로 자동 다운로드
### 사용법 (한 줄)
```powershell
python download_company.py "현대차"
python download_company.py "SK하이닉스"
python download_company.py "NAVER"
```
옵션:
- `--list-only` → 다운 안 받고 목록만 미리보기 (꼭 받기 전에 확인!)
- `--since 2024` → 2024년 이후 분기/반기까지 받기 (기본은 작년)
---
## ⚙️ API 키 영구 등록
매번 `--api-key b31c2af...` 적기 귀찮음 → 환경변수에 영구 등록:
```powershell
[Environment]::SetEnvironmentVariable("DART_API_KEY", "[내키]", "User")
```
이제 PowerShell 새로 열면 키 옵션 없이 그냥 `python download_company.py "회사명"`만 입력하면 됨.
---
## 📦 최종 결과물
### 받은 자료
| 회사 | 건수 | 폴더 |
|---|---|---|
| 삼성전자 | 10건 (약 18 MB) | `dart_downloads\삼성전자\` |
| LG전자 | 10건 (약 30 MB) | `dart_downloads\LG전자\` |
### 만든 도구
| 파일 | 용도 |
|---|---|
| `dart_download.py` | 기본 다운로드 엔진 (PDF/ZIP 둘 다 지원) |
| `download_company.py` | **한 줄 명령용 회사별 자동 다운로더** ⭐ |
### 명령어 한 줄 요약
```powershell
cd "C:\Users\energ\Documents\test down 260528"
python download_company.py "회사명"
```
---
## 🎓 배운 점 (비전공자 시각)
1. **PowerShell은 "지금 있는 폴더"에서 명령을 찾는다** — 그래서 `cd`로 폴더 이동을 먼저 해야 함.
2. **공식 API와 웹사이트는 다른 것** — 한쪽에 없는 기능이 다른 쪽엔 있을 수 있다.
3. **목록 먼저 확인하기** — `--list-only` 같은 옵션으로 "받을 거 미리 보기"를 습관화하면 실수가 줄어든다.
4. **정정본은 더 정확한 자료** — 회사가 자료를 수정해서 다시 올린 거니까 정정본을 우선해야 한다.
5. **환경변수 = 매번 안 적어도 되는 비밀번호 같은 것** — 한 번만 등록하면 계속 자동으로 쓰임.
6. **컴퓨터 껐다 켜도 파일은 안 사라진다** — 단지 명령어 입력 기록(↑ 화살표)이 초기화될 뿐.
---
## 🚀 다음에 더 해볼 만한 것
- 더블클릭으로 실행되는 `.bat` 파일 만들기 (PowerShell도 안 열고 싶을 때)
- 여러 회사를 한꺼번에 받기 (회사 목록 파일로 일괄 처리)
- 받은 PDF에서 자동으로 재무제표 추출하기
- 동종업계 비교 분석 자동화
---
*이 문서는 Claude Code와 함께 작업한 실제 대화를 정리한 것입니다.*
*작업 환경: Windows 11, PowerShell, Python 3.x, VSCode*
*작성일: 2026-05-29*




초딩학생처럼 클로드선생님이 하라는대 했습니다.
이런것을 메타학습태도라고 하나 봅니다.
초등학생처럼 부끄러움 없이. 두려워하지 말고 묻기