DART 재무 비교

금융감독원 DART Open API로 상장사 사업보고서 재무제표를 불러와, 최대 4개 기업의 재무비율·추이를 비교하는 웹앱입니다.

• 기업명/종목코드 검색 (전체 상장사), "백화점 빅3" 같은 빠른 비교 버튼
• 기업 개요 + 업종(KSIC) 표시, 같은 업종 상장사 추천, 🚩 이익의 질 경보 (영업흑자·순적자, 순이익↑·영업현금흐름↓, 재고·채권 급증, EPS 음수 등)
• 재무비율 34종 비교표 (성장성·수익성·활동성·안정성·현금흐름), 계산식 툴팁, 평균·기초·기말 잔액 기준 선택, 과거 5년 평균 대비 ▲▼
• 수익성 분해: 듀퐁 산점도, ROE 분해 트리 — ROE = ROIC + (ROIC − 세후순차입이자율) × 순재무부채/자기자본, 재무레버리지 시뮬레이터, 자기자본 증가 분해(ROE + 주주 순투자율), 초과이익·EVA (CAPM 입력)
• 손익 브리지: 영업이익 → 지배주주 순이익 폭포수 차트, 기타손익 제외 순이익(지속적 이익 근사), 기타포괄손익 구성(재평가·평가손익), 주가 입력 → PER·정상화 PER·PBR·PSR·EV/매출, 감사인 핵심감사사항 연결
• 재무제표: 금액 / 공통형(%) / 추세지수(첫해=100) 보기, 공통형 기업 비교
• 표마다 CSV 저장, 현재 탭 인쇄·PDF, 네이버 증권·애널리스트 리포트·DART 원문 바로가기, 감사인 교체·비적정 의견 경보
• 현금흐름: 기업 FCF 창출과 배분(이자·리스료·차입 상환·배당·자사주) 폭포수, 이자지급 분류(영업/재무) 차이 보정, 순이익 vs 영업현금흐름, 현금흐름표 전체 항목
• 안정성·효율성: 현금전환주기, 리스부채 포함/제외 차입부채비율, 이익·현금 기준 이자보상비율
• 지배구조·배당: 최대주주·소액주주 지분, 임원·사외이사·여성 등기임원, 배당, 감사인·감사의견·핵심감사사항, 직원 현황
• 연결/별도 전환, 기준 사업연도 선택, ?c=00126380,00164779&t=bridge 형태의 공유 링크

구조

index.html, style.css, js/        정적 프런트엔드 (빌드 없음, 바닐라 JS + Chart.js)
  js/ratios.js                    재무비율 (강의 3장)
  js/analysis.js                  손익 브리지·FCF·ROE 분해·듀퐁·경보 (강의 4~6장)
api/company.js                    기업 개황 프록시  → DART company.json
api/financials.js                 재무제표 프록시   → DART fnlttSinglAcntAll.json (사업보고서 2건 동시 호출로 6개년)
api/governance.js                 지배구조 프록시   → DART 정기보고서 주요정보 6종 (최대주주·소액주주·임원·배당·감사·직원)
vercel.json                       서버 함수를 서울(icn1) 리전에서 실행 → DART 응답 지연 감소
data/corps.json                   상장사 목록 + 업종코드 (GitHub Actions가 매월 갱신)
scripts/update_corps.py           corps.json 생성 스크립트 (파이썬 표준 라이브러리만 사용)

왜 서버 함수가 필요한가? DART API는 브라우저에서 직접 호출할 수 없고(CORS), API 키가 노출되면 안 됩니다. 그래서 Vercel 서버리스 함수가 키를 숨긴 채 대신 호출하고, 응답을 CDN에 하루 캐시해 DART 호출 수(일 20,000회 한도)를 아낍니다.

배포 (로컬 설치 없이)

1. DART Open API에서 인증키 발급
2. 이 폴더를 GitHub 저장소로 올리기
3. 저장소 Settings → Secrets and variables → Actions 에 DART_API_KEY 추가
4. Actions → Update corp list → Run workflow 실행 (전체 상장사 + 업종코드 수집, 첫 실행 15분 내외)
5. Vercel에서 저장소 Import → Environment Variables에 DART_API_KEY 추가 → Deploy

이후 main에 push할 때마다 자동 재배포됩니다.

로컬 실행 (선택)

Node.js 18+ 만 있으면 됩니다 (패키지 설치 없음). .env 파일에 DART_API_KEY=... 를 넣고:

node dev-server.js

→ http://localhost:3000 . .env는 .gitignore에 있어 GitHub에 올라가지 않습니다.

계산식

지표	식
ROE	지배주주 순이익 ÷ 평균 지배주주 자본 (별도는 순이익 ÷ 평균 자본)
ROA	순이익 ÷ 평균 총자산
부채비율	부채총계 ÷ 자본총계
유동비율	유동자산 ÷ 유동부채
총자산회전율	매출액 ÷ 평균 총자산
FCF	영업활동현금흐름 − 유형자산 취득

평균은 전년도 값이 있을 때만 쓰고, 없으면 기말값을 씁니다.

한계

• 계정 매칭은 IFRS 태그 우선, 없으면 계정명으로 찾습니다. 일부 기업은 계정명이 달라 빈칸이 나올 수 있습니다.
• 금융업(은행·보험·증권)은 손익 구조가 달라 매출 기반 비율이 비어 있습니다.
• 주가 데이터가 없어 PER·PBR 같은 밸류에이션 지표는 제외했습니다.