본문으로 건너뛰기

# DART 공시 PDF 자동 다운로드 만들기 — 비전공자 도전기

# 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*
2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

류웅수_이안_IAN 프로필 이미지

코딩을 잘 모르는 상태에서 Claude와 함께 **상장사 공시 자료(사업보고서·분기보고서)를 PDF로 자동으로 받는…. 이건 실제로 굴려보면 꽤 번거로운 지점인데, 이렇게 풀어낸 과정이 궁금하네요.

마이네임코드 프로필 이미지

초딩학생처럼 클로드선생님이 하라는대 했습니다.

이런것을 메타학습태도라고 하나 봅니다.

초등학생처럼 부끄러움 없이. 두려워하지 말고 묻기

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기