insikk / dart-fss

한국 금융감독원에서 운영하는 다트(Dart) 시스템 크롤링을 위한 라이브러리

Dart-Fss

한국 금융감독원에서 운영하는 Dart 시스템 크롤링을 위한 라이브러리

• Documentation: https://dart-fss.readthedocs.io
• Source code: https://github.com/josw123/dart-fss

Features

• KIND를 이용한 기업정보 검색
• DART의 오픈 API를 이용한 전자공시 조회
• DART의 전자공시 정보를 이용한 재무제표 추출

Installation

pip install dart-fss

Plugins

• Dart-Fss-Classifier: 재무제표 추출 성능 향상

Dependencies

• NumPy
• pandas
• requests
• lxml
• beautifulsoup4
• arelle
• isodate
• tqdm
• fake-useragent
• html5lib
• openpyxl
• halo

Usage

Dart API Key 설정

• DART API 신청
• API Key 확인
• 환경 변수 DART_API_KEY 설정 또는 패키지 사용전 아래와 같이 설정

import dart_fss as dart

api_key='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 
dart.dart_set_api_key(api_key=api_key)

오류 코드

• DartAPIError: DART API 에서 오류 메시지를 전송 받았을때 발생하는 오류
• NotFoundConsolidated: 연결재무제표가 없을때 발생하는 오류(해당사항이 없는 경우)

주의사항

• Dart-Fss 라이브러리는 오픈 API의 응답 방식 중 JSON 방식을 사용 중
• 현재 DART 오픈 API의 응답 방식이 JSON인 경우 오류 발생시 오류 메시지를 보내지 않음 (응답방식이 xml인 경우 올바르게 작동함)

XML 결과

<?xml version="1.0" encoding="utf-8"?>
<result>
    <err_code>010</err_code>
    <err_msg>미등록 인증키</err_msg>
    <page_no>1</page_no>
    <page_set>10</page_set>
    <total_count>0</total_count>
    <total_page>0</total_page>
</result>

JSON 결과

{"err_code":"000","err_msg":"정상","page_no":1,"page_set":10,"total_count":0,"total_page":0,"list":[]}