DisclosureDiff

OpenDART/DART 최초 공시와 정정공시를 연결해 핵심 변경사항을 비교하는 MVP입니다. 현재 범위는 유상증자 결정 정정공시 비교입니다.

Setup

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

.env에 DART API 키를 둡니다.

DART_API=your_api_key

Search Filings

.venv/bin/python scripts/search_filings.py \
  --begin-date 20240401 \
  --end-date 20240630 \
  --keyword 유상증자 \
  --correction-only \
  --pretty

corp_code 없이 검색할 때 OpenDART는 기간을 3개월로 제한합니다. 스크립트는 긴 기간을 90일 단위로 나누며, 기본적으로 각 구간 1페이지만 조회합니다. 더 보려면 --max-pages를 늘립니다.

Collect Recent 2-Month Filing Candidates

.venv/bin/python scripts/collect_correction_dataset.py \
  --max-items 100 \
  --max-pages 5

생성 파일:

• data/opendart_dataset/rights_offering_corrections_recent_2m.json
• data/opendart_dataset/rights_offering_corrections_recent_2m.csv
• data/opendart_dataset/rights_offering_corrections_recent_2m_summary.md

기본 수집 기간은 실행일 기준 최근 60일입니다. 특정 기간을 고정하려면 --begin-date YYYYMMDD --end-date YYYYMMDD를 함께 지정합니다.

Compare Receipt Numbers

.venv/bin/python scripts/analyze_receipts.py \
  --company 한온시스템 \
  --original-receipt-no 20240503000795 \
  --correction-receipt-no 20240930000649 \
  --pretty

출력은 변경 필드, 전후 값, 변화량, 변화율, 날짜 차이, 재검토 필요 여부, 원문 근거 위치를 포함합니다.

Compare Extracted JSON

.venv/bin/python scripts/disclosure_diff.py \
  data/sample_original.json \
  data/sample_correction.json \
  --pretty

Test

.venv/bin/python -m pytest -q