Open DART를 이용한 기업공시 수집 (1) 환경 설정

개요

이번 포스팅 시리즈에서는 전자공시 시스템 (DART)에 등록되는 기업공시를 API를 이용하여 수집하는 방법을 소개하고, 모든 기업의 재무제표, 배당정보, 기업정보 등을 수집하겠습니다. 이번 포스팅 (1) 환경 설정에서는 관련 패키지인 OpenDartReader 설치와 인증키를 발급받는 방법에 대해서 알아보겠습니다.

 

이번 포스팅부터는 책에서 사용하는 논조와 맞추기 위해서, 가능하면 존댓말을 사용하겠습니다. 

 

API 인증키 발급

Open DART를 사용하려면 API 인증키를 발급받아야 합니다. 먼저, Open DART 홈페이지 (https://opendart.fss.or.kr/)에 접속합니다.

그러면 아래 그림과 같은 화면이 나오는데, 여기서 박스로 표시한 인증키 신청 버튼을 누릅니다.

 

인증키 신청을 누르면 아래와 같은 화면이 나옵니다.

1번 항목에서는 이용약관에 동의해주고, 2번에서는 인증키를 신청할 때 사용할 ID와 패스워드를 입력해줍니다.

그리고 3번에서는 API를 사용하는 환경과 용도에 대해 답해줍니다.

여기서 사용환경으로는 웹을, 사용용도로는 기업정보 데이터 수집이라고 답해줍니다 (사실 어떻게 해도 상관없습니다).

 

그리고나서 4번 버튼을 클릭해주면, 인증 메일이 발송되었다는 팝업이 다음과 같이 뜹니다.

 

이제 인증키를 신청했던 이메일에 로그인을 하여, 인증메일을 열어보겠습니다.

이 메일에서 "인증링크" 하이퍼링크를 클릭하면 인증이 완료됩니다.

이제 다시 Open DART 홈페이지에 접속해서 인증키를 신청할 때 사용했던 이메일과 비밀번호로 로그인한 뒤, 인증키 신청/관리 – 오픈 API 이용현황을 클릭하면 아래 그림과 같이 API Key가 발급되었음을 확인할 수 있습니다.

인증키는 40자리 문자열로, 사용자의 개인정보입니다.

 

 

OpenDartReader 설치 및 확인

OPEN DART를 조금 더 쉽게 사용할 수 있는 파이썬 패키지인 OpenDartReader를 설치해줍니다.

아나콘다프롬프트를 켜고 아래 명령어를 입력해주면 손쉽게 설치할 수 있습니다.

 

$ pip install opendartreader

그러면 아래와 같이 설치가 진행됩니다.

 

이제 설치가 잘 되었는지, 또 API 인증키는 잘 발급되었는지 아래 파이썬 코드를 이용하여 확인합니다.

import OpenDartReader
# API KEY 지정 
my_api = "abb1b205aa3390eb4f4028aaa4a75a9cd97d1c36"

# OpenDartReader 객체 생성하기
dart = OpenDartReader(my_api)

이 코드에서 OpenDartReader 모듈을 불러오고, 자신의 api 인증키를 my_api라는 변수에 저장합니다.

참고로 제 실제 api 인증키가 아니므로 그대로 따라치시면 오류가 나니, 반드시 자신의 인증키를 사용하시기 바랍니다.

그리고나서 OpenDartReader 함수를 이용하여 dart라는 객체를 만들어줍니다.

이 과정에서 인증키가 잘못입력되었다면, 아래와 같은 오류메시지가 뜹니다.

 

{"status":"010","message":"등록되지 않은 인증키입니다."}

 

OpenDartReader 객체의 주요 메서드

이전 코드에서 dart라는 객체를 만들었는데, 이 객체의 메서드를 통해서 다양한 데이터를 가져올 수 있습니다.

이 포스팅 시리즈에서는 list, document, company, report, finstate라는 메서드를 다룰 예정입니다.

 

각 메서드에 대한 설명은 아래와 같습니다.

list	공시를 검색하는데 사용하며, 기간과 보고서의 종류를 지정할 수 있음
document	보고서를 여는데 사용
company	기업의 개황정보를 가져옴
report	사업보고서의 주요 내용을 조회함
finstate	상장기업의 재무 데이터를 가져옴

추후 포스팅에서는 각 메서드에 대해 설명하겠지만, 완전하게 설명하지는 않고 데이터를 수집하는데 충분한 정도의 설명만 곁들일 예정입니다.

패키지에 대한 자세한 설명은 이 링크를 참고하시기 바랍니다.

 

---

데이터 분석 서비스가 필요한 분은 아래 링크로! 

https://kmong.com/gig/374194 

데이터사이언스 박사의 데이터 분석 서비스 드립니다. | 150000원부터 시작 가능한 총 평점 5점의 I