바이브코딩으로 ETF 분배금 대시보드 만든 후기 — 크롤링 vs 증권사 API, 뭐가 더 나을까?
2026.08.05

요즘 배당(분배금) 나오는 ETF에 관심 있는 분들 많으실 텐데요. 저는 제가 투자하는 ETF들의 분배금 예정일, 예상 금액, 실제 지급 내역을 한눈에 보고 싶어서 Stocklab에 분배금 대시보드를 만들어봤습니다.
이번 글에서는 완성된 화면보다는 "이걸 어떤 식으로 AI한테 시켜서 만들었는지", 그리고 데이터를 가져오는 두 가지 방법(운용사 홈페이지 크롤링 vs 한국투자증권 API)을 각각 써보니 장단점이 뭐였는지 공유해보려고 합니다.
왜 두 가지 방법을 같이 쓰게 됐나
처음엔 "그냥 증권사 API 하나로 다 되겠지" 싶었는데, 실제로 써보니 각자 구멍이 있더라고요. 그래서 결국 두 방식을 병행해서, 서로 부족한 부분을 채우는 구조로 정착했습니다.
운용사 홈페이지 크롤링 — TIGER, KODEX, SOL, ACE, RISE 같은 ETF 운용사들이 자기 홈페이지에 분배금 예정 공지를 올려두는데, 이걸 긁어오는 방식
한국투자증권(KIS) Open API — 증권사가 공식적으로 제공하는 배당/분배금 조회 API를 호출하는 방식
방법 1: 운용사 홈페이지 크롤링

각 운용사 홈페이지에는 "이번 달 분배금은 얼마이고 언제 지급됩니다" 같은 공지가 올라옵니다. AI에게 "이 페이지 구조를 분석해서, 분배금 관련 표를 자동으로 읽어오는 스크립트를 만들어줘"라고 시켜서, 운용사별로 각각 하나씩 자동 수집기를 만들었습니다.

[그림. ACE의 공지 내용]

[그림. Kodex의 공지내용]
운용사마다 페이지 생김새가 다 달라서, 5개 운용사(TIGER/KODEX/SOL/ACE/RISE)에 대해 각각 별도로 수집기를 하나씩 만들고, 마지막에 이걸 한 데이터로 합쳐주는 스크립트까지 추가로 만들어서 전체를 자동화했습니다. 이렇게 모인 데이터는 평일(월~금) 오후 4시 10분에 자동으로 한 번씩 실행되도록 스케줄을 걸어뒀습니다. 장 마감 직후 운용사들이 그날의 분배금 공지를 올리는 타이밍에 맞춘 시간입니다.
장점
속도가 빠릅니다. 운용사가 발표하자마자 다음 실행 때 바로 반영됩니다. "이번 달 분배금 확정됐대요" 소식을 거의 실시간으로 따라갈 수 있어요.
예정 정보까지 잡힙니다. 아직 확정 전인 "예정" 단계 공지도 미리 볼 수 있어서, 다음 달 대략적인 흐름을 앞서 파악하기 좋습니다.
단점
홈페이지가 바뀌면 바로 고장 납니다. 운용사가 홈페이지 디자인을 개편하면 그 즉시 수집기가 멈춥니다. 실제로 자주는 아니어도 가끔 손봐야 하는 상황이 생겼어요.
운용사 수만큼 따로 관리해야 합니다. 5개 운용사 각각 페이지 구조가 다르니, 유지보수 포인트도 5개로 늘어납니다.
(더 많은 운용사가 있지만 운용 종목이 적어 배제함)
공식 API가 아니라서 불안정합니다. 홈페이지 접속이 느려지거나 막히면 수집이 실패할 수 있어요.
모든 내용을 크롤링 하기 어렵습니다. 일부 공지내용은 이미지로 되어 있어요. 이를 파싱하려면 AI분석이 필요합니다.(일부 내용이 그래서 예정일, 분배락일 등이 취합 안됨)
방법 2: 한국투자증권(KIS) Open API
한국투자증권은 개발자용으로 API를 공식 제공하는데, 그중에 종목별 배당/분배금 이력을 조회하는 기능이 있습니다. AI에게 "KIS API 문서 보고 배당 조회 API 붙여줘"라고 시켜서 연동했고, 이 API로 종목코드와 기간을 넣으면 확정된 분배금 내역(주당 얼마, 언제 지급됐는지)을 받아올 수 있습니다.

여기에 더해서 "매수기준일"(이 날짜까지 갖고 있어야 분배금을 받는 날) 계산도 자동화했는데, 단순히 주말만 빼는 게 아니라 한국 증권시장 휴장일(공휴일 등)까지 반영해서 정확한 영업일 기준으로 계산하도록 만들었습니다.
이 API도 자동으로 도는데, 하루 09:50 / 16:00 / 19:00 이렇게 세 번 실행되도록 걸어뒀습니다. 다만 매달 1~22일까지는 저녁 19시 한 번만 실제로 데이터를 수집하고 나머지 두 번(09:50, 16:00)은 건너뛰도록 만들었어요. 어차피 월 중순까지는 분배금이 확정되는 경우가 드물어서, API 호출 횟수를 아끼려고 이렇게 설계했습니다. 23일부터는 확정 소식이 몰리는 시기라 세 번 다 수집하도록 되어 있습니다.
장점
공식 데이터라 신뢰도가 높습니다. 증권사가 직접 제공하는 확정 데이터라서, 나중에 실제 지급액과 어긋날 걱정이 적습니다.
한 번의 연동으로 모든 종목을 커버합니다. 운용사별로 따로 관리할 필요 없이, 종목코드만 바꿔가며 동일한 방식으로 ETF든 일반 주식이든 다 조회할 수 있어요.
구조가 안정적입니다. 홈페이지 디자인 변경 같은 외부 요인에 영향을 안 받아서, 한 번 만들어두면 잘 안 깨집니다.
단점
확정 전 정보는 안 나옵니다. "확정된" 데이터 위주라, 아직 발표 전인 예정 정보는 크롤링보다 늦게 잡히는 경우가 있습니다.
호출 횟수 제한이 있습니다. API를 너무 빠르게 여러 번 호출하면 막히기 때문에, 종목이 많으면 시간 간격을 두고 나눠서 호출하도록 신경 써야 했습니다.
API 키 발급, 토큰 관리 등 초기 세팅이 좀 더 손이 갑니다. 크롤링보다는 처음 붙일 때 준비할 게 많아요.
결국 어떻게 조합했나
정리하면 이렇게 역할을 나눴습니다.
빠른 소식이 필요할 때 (예정 정보, 발표 직후 반영) → 운용사 크롤링
정확하고 믿을 수 있는 확정 데이터가 필요할 때 → KIS API
그리고 실제 제 잔고에 있는 종목들의 "예상 분배금"을 계산할 때는, 지금 보유하고 있는 수량에 KIS API로 확정된 분배금 단가를 곱하는 방식을 쓰고 있습니다. 계좌마다 데이터를 가져오는 방식이 달라서(어떤 계좌는 실제 입금 내역을 바로 볼 수 있고, 어떤 계좌는 그게 안 돼서 과거 보유 수량을 역추적해서 추정치를 계산하는 식으로) 이 부분은 꽤 복잡하게 얽혀 있는데, 이건 나중에 기회 되면 따로 풀어보겠습니다.

정리
구분 | 운용사 크롤링 | KIS 공식 API |
|---|---|---|
속도 | 빠름 (발표 직후 반영) | 상대적으로 느림 |
정확도/신뢰도 | 홈페이지 구조에 의존, 불안정할 수 있음 | 높음 (공식 확정 데이터) |
예정 정보 | 가능 | 어려움 |
유지보수 | 운용사 수만큼 손이 감 (홈페이지 개편 시 고장) | 상대적으로 안정적 |
초기 세팅 | 비교적 간단 | API 키 발급 등 준비 필요 |
실행 주기 | 평일 오후 4시 10분, 하루 1회 | 하루 3회(09:50/16:00/19:00), 월 중순까진 저녁 1회로 절약 |
바이브코딩으로 하나씩 만들다 보니, "이 데이터는 어디서 가져오는 게 제일 정확할까"를 계속 고민하게 되더라고요. 완벽한 정답 하나보다는, 각 방식의 장단점을 이해하고 상황에 맞게 섞어 쓰 게 결국 제일 현실적인 답이었던 것 같습니다.

![투자자동화 3] 나만의 투자의사결정 개인 비서 앱 초안 완성 (Investment Compass) 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F83b1310e15fa3f71e7bb6607.jpg&w=3840&q=75)

![투자자동화2] 내 주식 투자를 도와줄 비서 앱 제작 (~ing) 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fdb1bd223653aab852c2ce23a.jpg&w=3840&q=75)
크롤링과 KIS API를 하나로 통일하려 하지 않고 '예정은 크롤링, 확정은 API'로 역할을 갈라두신 결론이 정말 좋은 것 같습니다. 저도 외부 웹 원문을 긁는 파이프라인을 짜다가 직접 fetch부터 우회 경로, 외부 추출 서비스, RSS 요약까지 다단 폴백으로 가게 됐습니다.
그때 제일 값을 한 건 값마다 '이건 어느 경로로 얻은 것인지'를 필드로 박아둔 것이었습니다. 예를 들어, 크롤링과 KIS API가 같은 종목에 다른 단가를 줄 때 어느 쪽을 우선할지 규칙으로 정할 수 있고, 'API에는 있는데 크롤링에는 없는 종목'이 저절로 드러나서 수집기가 조용히 멈춘 것도 알게 되거든요.
고도화하시는 과정에서 막히는 부분은 같이 고민해보면 좋을 것 같습니다!