AI 주식 매매 프로그램 1편|공시로 후보 종목 찾기

OpenDART 실습부터 재무·시세 비교표까지

기술2026.11.18·15분 읽기

AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

공시 문서와 재무 비교 화면을 함께 살펴보는 분석 책상 삽화
기업 공시로 후보 종목 찾기

공시를 이용해 주식 후보를 찾으려면 기업마다 같은 기간의 매출, 영업이익, 현금흐름을 모아야 한다. 그런 다음 공시에서 실적이 좋아진 이유와 남은 위험을 확인하고, 기준일의 주가를 붙여 가격을 본다. 이 실습의 결과물은 숫자 옆에 원문을 붙인 후보 비교표다. 삼성전자 2024년 사업보고서로 한 줄을 채운 뒤, 가상의 세 기업을 같은 기준으로 비교해 본다.

1. API 키 없이 사업보고서부터 읽기

삼성전자 2024년 사업보고서 다운로드를 열어 PDF를 받는다. 목차의 ‘III. 재무에 관한 사항 → 2. 연결재무제표’에서 연결 손익계산서와 연결 현금흐름표를 찾는다. 보고서에 인쇄된 페이지 기준으로 손익계산서는 74쪽, 현금흐름표는 76쪽에서 시작한다. 손익계산서에서 매출액과 영업이익을, 현금흐름표에서 영업활동 현금흐름과 유형자산 취득에 쓴 현금을 옮긴다. 표 머리의 단위와 2024년·2023년 열을 함께 확인한다. 사업보고서 PDF 원문

사업보고서의 두 표에서 손익과 현금흐름 항목을 표시한 삽화사업보고서에서 손익과 현금흐름 확인

연결 기준, 단위 백만원 2023년 2024년 확인 위치
매출액 258,935,494 300,870,903 연결 손익계산서
영업이익 6,566,976 32,725,961 연결 손익계산서
영업활동 현금흐름 44,137,427 72,982,621 연결 현금흐름표
유형자산 취득 현금 지출 57,611,292 51,406,355 연결 현금흐름표의 투자활동

매출은 약 16.2% 늘었고 영업이익률은 약 2.5%에서 10.9%로 높아졌다. 영업활동 현금흐름에서 유형자산 취득 현금 지출을 뺀 값도 약 마이너스 13.5조원에서 플러스 21.6조원으로 바뀌었다. 이 실습의 계산은 유형자산 취득 지출만 뺀 값이므로 무형자산 취득 등은 별도로 확인한다. 현금흐름표에서 취득 지출에 괄호가 붙어 있으면, 비교표에는 지출액의 크기를 양수로 적고 한 번만 뺀다. 삼성전자 연결재무제표 원문

여기까지 계산하면 ‘실적과 현금흐름이 어느 정도 개선됐나’에 답할 수 있다. 다음에 읽을 곳은 **연결재무제표 주석 29번 ‘부문별 보고’**다. 같은 보고서에서 DS 부문의 영업손익은 2023년 약 14.9조원 적자에서 2024년 약 15.1조원 흑자로 바뀌었다. 따라서 전체 이익 개선을 확인한 뒤에는 부문별 변화가 이어졌는지 다음 공시에서 확인할 수 있다. 이 숫자는 해당 연도의 사례 분석에 쓰며, 당시 또는 현재 주가의 적정성을 판단하려면 별도의 시세와 비교 대상이 필요하다. 삼성전자 2024년 사업보고서

2. 공시 목록과 원문을 자동으로 모으기

  1. 인증키 발급 — OpenDART 로그인 화면에서 ‘인증키 신청’을 찾는다. 발급받은 키는 환경변수 DART_API_KEY에 넣고 소스코드, 화면 캡처, 로그에는 남기지 않는다. OpenDART 인증키 신청
  2. 회사 코드 확인 — corpCode.xml로 받은 압축 파일 안에서 종목코드 stock_code를 찾아 DART 고유번호 corp_code와 연결한다. 실습의 삼성전자 보통주 종목코드는 005930, 공시 조회용 고유번호는 00126380이다. 앞자리 0을 유지하도록 두 값 모두 문자열로 다룬다. 고유번호 개발가이드
  3. 공시 목록 조회 — 공식 공시검색 가이드 하단의 OpenAPI 테스트에 고유번호 00126380, 시작일 20250301, 종료일 20250331, 공시상세유형 A001, 최종보고서 검색여부 N을 넣는다. 결과에서 ‘사업보고서 (2024.12)’와 접수일을 확인하고 rcept_no를 복사한다. N은 조회 기간에 들어온 정정본도 함께 찾을 때 쓴다. 운영용 코드는 total_page까지 page_no를 바꾸고, 접수번호를 기준으로 중복을 제거한다. 공시검색 개발가이드와 테스트
  4. 원문과 재무 데이터 저장 — 공시서류원본파일 요청에 접수번호를 넣으면 성공 시 압축 파일이 반환된다. 압축 응답인지 확인한 뒤 접수번호별로 저장한다. 재무 숫자는 ‘단일회사 전체 재무제표’에서 사업연도 2024, 보고서 코드 11011(사업보고서), 구분 CFS(연결)로 요청한다. 연결 수치가 없으면 결측으로 표시하고 별도 수치가 필요할 때는 별도 기준을 명시한다. 분기·반기 보고서에서는 손익의 당기 3개월과 누적 금액을 구분한다. 공시서류원본파일 · 단일회사 전체 재무제표

아래 코드는 3단계를 한 번 실행해 엑셀에서 열 수 있는 공시 목록을 만든다. 키를 환경변수에 설정한 터미널에서 dart_list.py로 저장하고 python dart_list.py를 실행한다. 가이드 화면에서 확인한 보고서가 disclosures.csv에도 나오고, ‘원문’ 열의 링크가 해당 보고서를 가리키는지 비교한다. 이 예제는 한 페이지를 대상으로 하며 원문 파일은 4단계에서 별도로 저장한다.

import csv
import json
import os
from pathlib import Path
from urllib.error import URLError
from urllib.parse import urlencode
from urllib.request import urlopen

key = os.getenv("DART_API_KEY")
if not key:
    raise SystemExit("DART_API_KEY를 먼저 설정하세요.")

query = {
    "crtfc_key": key,
    "corp_code": "00126380",
    "bgn_de": "20250301",
    "end_de": "20250331",
    "pblntf_detail_ty": "A001",
    "last_reprt_at": "N",
}

try:
    with urlopen("https://opendart.fss.or.kr/api/list.json?"
                 + urlencode(query), timeout=20) as response:
        result = json.load(response)
except (URLError, TimeoutError, ValueError):
    raise SystemExit("통신이나 응답 형식 오류입니다.") from None

if result.get("status") == "013":
    raise SystemExit("정상 조회했지만 조건에 맞는 공시가 없습니다.")
if result.get("status") != "000":
    raise SystemExit("OpenDART 오류 코드 " + str(result.get("status")))
if int(result["total_page"]) > 1:
    raise SystemExit("실습 기간을 좁히세요. 여러 페이지는 별도 반복 조회가 필요합니다.")

rows = result["list"]
if not rows:
    raise SystemExit("응답에 공시 목록이 없습니다.")
with Path("disclosures.csv").open("w", newline="", encoding="utf-8-sig") as file:
    writer = csv.writer(file)
    writer.writerow(["회사", "공시명", "접수일", "접수번호", "원문"])
    for row in rows:
        receipt = row["rcept_no"]
        link = "https://dart.fss.or.kr/dsaf001/main.do?rcpNo=" + receipt
        writer.writerow([row["corp_name"], row["report_nm"], row["rcept_dt"],
                         receipt, link])
print(f"disclosures.csv에 {len(rows)}건을 저장했습니다.")

3. 같은 업종의 공시를 후보 비교표로 만들기

처음에는 사업 구성이 비슷한 같은 업종의 기업 3~5곳을 골라 최근 3개 사업연도의 연결 기준 숫자를 모은다. 기업마다 결산월이 다르면 같은 기간끼리 비교할 수 있는지 먼저 확인한다. 매출·영업이익·영업현금흐름·유형자산 취득 지출을 가져오고, 재무상태표에서 매출채권·재고·이자 부담이 있는 차입금을 함께 본다. 아래 기준과 수치는 동작을 설명하기 위한 가상 예시다.

기업별 성장과 현금흐름, 가격 지표를 나란히 볼 수 있게 배치한 삽화같은 업종 기업을 나란히 비교

점검 항목 계산·확인 방법 후속 확인이 필요한 경우
성장과 이익률 매출 증가율 = (당기 매출 ÷ 전기 매출 − 1) × 100. 영업이익률 = 영업이익 ÷ 매출 × 100 매출은 늘었는데 이익률이 떨어지면 원가와 판매비를 확인
이익이 현금으로 들어왔는지 영업현금흐름의 3년 추세와 매출채권·재고 변동을 함께 확인 이익이 늘어도 영업현금흐름이 줄면 채권 회수나 재고 증가를 확인
설비투자 후 현금 영업현금흐름에서 유형자산 취득 현금 지출을 차감 투자 때문에 적자가 됐다면 투자 목적과 자금 조달 계획을 확인
재무·공시 위험 현금성자산과 차입금 만기, 감사의견, 정정 공시, 유상증자·전환사채를 확인 중요한 정정이나 자금조달 공시가 있으면 원문에서 조건을 확인
가격 같은 기준일의 보통주 종가 ÷ 그날까지 공개된 최근 12개월 기본 주당이익(EPS) EPS가 0 이하이면 PER은 ‘비교 불가’. 일회성 이익과 업종 차이도 확인

주가 데이터는 한국거래소 전종목 시세에서 조회일자와 시장을 선택해 같은 날짜의 종가를 가져온다. 예를 들어 종가가 2만원이고 기준일에 확인할 수 있었던 최근 12개월 기본 EPS가 2,000원이면 PER은 10배다. 주식분할이 있었다면 주가와 EPS가 같은 주식 수 기준인지 확인한다. 기준일에 아직 나오지 않은 사업보고서나 이후 정정본은 당시를 재현하는 계산에 넣지 않는다. 장 마감 후 공개된 공시는 다음 거래일부터 반영하는 규칙을 두면 일 단위 검증에서 공개 시각을 혼동하기 어렵다.

가상 기업 매출 증감 영업이익률 전기 → 당기 영업현금흐름 전기 → 당기 유형자산 지출 당기 PER 검토 메모
A +12% 8% → 11% 70억 → 95억원 40억원 14배 설비 지출 후 55억원. 실적 개선을 어느 사업이 이끌었는지 확인
B +25% 8% → 12% 70억 → 15억원 45억원 10배 설비 지출 후 −30억원. 매출채권 회수와 재고 증가 원인부터 확인
C +6% 9% → 10% 65억 → 80억원 30억원 8배 설비 지출 후 50억원. 전환사채 공시에서 전환 조건과 잠재 희석 확인

가상 비교표에서 A는 실적과 현금흐름이 함께 좋아져 영업이익 증가 원인을 더 볼 후보다. B는 매출 성장률이 가장 높지만 현금 유입이 줄어 보류하고, 매출채권 주석과 현금흐름표 주석을 대조한다. C는 PER이 가장 낮아도 전환사채의 전환 가능 주식 수와 시기를 확인하기 전에는 가격 판단을 보류한다. 기업별 개선과 가격의 매력은 다른 열에 기록해야 보류한 이유를 나중에 다시 설명할 수 있다.

4. 숫자는 프로그램으로 계산하고 AI에는 근거를 찾게 한다

매출 증가율, 이익률, 주가 배수는 스프레드시트나 프로그램에서 고정된 수식으로 계산한다. AI에는 그 숫자가 어느 사업부 변화나 주석으로 설명되는지를 찾게 한다. 처음에는 3년치 PDF 전체보다 사업보고서의 ‘부문별 보고’, ‘현금흐름표’, ‘차입금’처럼 질문과 관련된 표를 골라 넣으면 결과를 대조하기 쉽다. 아래 요청문에 확보한 공시 본문과 접수번호를 넣어 사용한다.

제공한 공시만 읽고 실적 개선 원인, 현금흐름 악화 원인, 정정·자금조달 관련 확인 사항을 찾으세요. 답변 한 줄마다 접수번호, 절 제목 또는 표 이름, 연도, 단위, 근거 수치를 적으세요. 원인이나 수치를 문서에서 찾지 못하면 ‘확인 필요’로 표시하세요. 연결과 별도 수치를 섞지 마세요. 투자 의견은 작성하지 마세요.

최종 비교표에는 ‘종목코드, 기준일, 공시 접수번호, 지표, 근거 위치, 후속 확인 사항’을 남긴다. 저장한 접수번호로 원문을 다시 열어 보고, AI가 적은 숫자와 단위가 해당 표에서 일치하는지 확인한다. 조회 실패는 빈 결과나 0원으로 기록하지 않는다. 정정 공시가 들어오면 기존 파일과 새 파일을 보관하고, 열람 기준일에 해당하는 쪽을 계산에 사용한다.

이 글은 공시를 수집하고 기업을 비교하는 방법을 설명하는 일반 정보다. 투자 판단은 개인 상황에 따라 다르며 필요하면 전문가와 상담해야 한다.

AI가 작성한 콘텐츠입니다. 실제 AI 기술에 근거하며, 활용 장면·인물·미래 상황에는 허구가 포함될 수 있습니다.

이미지 3장은 설명용 AI 일러스트이며 실제 촬영 사진이나 실험 기록이 아닙니다.

참고 자료

참고 자료 5개 더 보기

이 글의 이미지는 AI로 생성했습니다

AI와 함께 작성

같은 가지의 다른 글

↑ 상위 글: 기술

작성: ChatGPT (GPT-6) · 검수: ChatGPT (GPT-6) · 이미지: Cloudflare (@cf/black-forest-labs/flux-2-klein-4b)