주식 다트 공시 + 휴대폰 텔레그램으로 자동 수신 시스템 구축 첫 걸음, 다트 API, 토큰, 구글 코랩 활용

-
목차

 

- 의도 : 내가 설정한 종목 중 다트에 새로운 공시가 뜨면 나의 텔레그램으로 즉시 알림을 받기 위함이다.

- 경로 : 다트 공시 -> 구글 코랩 -> 텔레그램 전송

- 컴퓨터를 24시간 가동할 수 없어 구글 코랩을 사용할 예정인데 코랩도 브라우저를 닫거나 일정 시간이 지나면 끊길 수 있다. 그래서 깃허브를 이용할 예정인데 이 부분은 글이 너무 길어지니 다음 글에 테스트해보는 과정을 남길 예정이다.

 

아래 글은 다트에서 'API 인증키', 텔레그램 API 토큰, 텔레그램 고유번호(chat ID)를 알아야 구글 코랩에서 코드를 입력해 다트의 공시 링크를 텔레그램으로 전송할 수 있다. 아래는 그 과정을 담은 것이다.

 

1. Open DART 'API 인증키' 발급받기 (무료)

위 버튼을 클릭하면 다트의 인증키 신청 페이지로 연결된다.

(1) 다트 사이트에 접속한다.

(2) 왼쪽 상단 '인증키 신청/관리' 메뉴를 클릭한다.

(3) 왼쪽 아래 '인증키 신청' 버튼 클릭을 클릭한다.

(4) 동의 체크 / 사용자 구분 : 개인 / 이메일, 비번을 입력한다.

(5) API사용환경 : 모두 / API사용용도 : 개인 투자 분석 및 파이썬 공부용 / 확인 URL : 나의 블로그 주소 기입 http://www.seethe330st.com ➡ 등록 버튼을 클릭한다.

(6) 기재한 이메일을 확인해 금융감독원에서 보낸 이메일을 열어 '인증링크' 클릭한다.

(7) 다트 사이트에서 상단 '인증키 신청/관리' 클릭, 페이지에서 '상태-승인'으로 되어 있는지 확인 ➡ 왼쪽 '오픈API 이용현황' 메뉴 클릭 ➡ API Key를 확인하면 된다.

 

2. 텔레그램을 통한 알림 설정 (무료)

(1) 텔레그램 앱 상단 돋보기 아이콘 누르기

(2) '@BotFather' 입력 후 검색되는 파란색 체크 표시가 되어 있는 공식계정의 '@BotFather'를 선택한다.

(3) 하단 'Start Bot' 버튼을 누른다.

(4) 채팅창에 '/newbot' 를 입력한다.

 

한글 이름 정하기

(5) Alright, a new bot. How are we going to call it? Please choose a name for your bot. -> 이런 문장이 뜨면 봇 이름을 정해서 입력한다. (한글로 해도 된다.)

 

영어 이름 정하기

(6) Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot. => 이런 문장이 뜨면 영어 아이디 만들어 입력한다. 타인과 중복되면 사용하지 못한다.

 

텔레그램 API 토큰 부여받아 따로 저장해두기

Done! Congratulations on your new bot. ~ For a description of the Bot API, see this page: https://core.telegram.org/bots/api

위 문장으로 시작해 끝을 맺는 문장이 나온다면 성공한 것이다.

문장을 자세히 들여다 보면 중간쯤에 'Use this token to access the HTTP API:'라는 문장 아래 숫자+영문 조합이 보인다. 이게 바로 텔레그램 'API 토큰'이다. 이 부분을 잘 복사해 저장해둔다.

 

나의 고유번호(chat ID) 확인, 저장하기

(7) 텔레그램 상단 돋보기 아이콘이 있는 검색창에 '@userinfobot'을 입력한다.

(8) 첫 번째로 뜨는 'User Info • Get ID • IDbot'을 누른다. (아이디:@userinfobot). 많은 게 뜨니 좀 당황스러울 수 있다.

(9) 하단 'Start Bot' 이나 '시작' 버튼을 누른다.

(10) id 뒤에 숫자가 보인다. 이 숫자들을 복사해 저장해 둔다.

 

🚨 텔레그램 채팅방 열어두기

채팅방을 미리 열어두지 않으면 구글 코랩에서 텔레그램으로 자료가 전송되지 않을 수 있으니 정보를 받을 텔레그램의 채팅방을 열어두자. 필자는 이 과정을 하지 않아 오류가 계속 났다.

(11) 위 (6)번에서 만들어둔 영어 이름으로 검색해서 채팅방을 열어 우측 하단 '시작' 버튼을 누른 후 아무 말이나 입력해놓자. 이렇게 하면 채팅방이 만들어진 것이다.

 

3. 구글 코랩으로 텔레그램 알림 테스트

이 과정은 꼭 필요한 것은 아닌데 깃허브를 이용하기 전 내 휴대폰의 텔레그램으로 내가 원하는 정보가 도착하는지 한번 확인해보기 위함이 크다.

(1) 위 버튼을 클릭해 구글 코랩 사이트로 이동해 로그인한다.

(2) 왼쪽 상단 '파일' 메뉴 -> 'Drive의 새 노트북' 을 클릭하면 새로운 창이 나타난다.

(3) '코딩을 시작하거나 AI로 코드를 생성하세요' 라는 박스 안에 아래와 같은 코드를 복사해 붙여넣기 한다.

!pip install opendartreader

 

(4) 붙여넣은 칸 왼쪽에 삼각형이 있는 동그라미가 있다. 그걸 클릭하자. 여러 문장이 뜬 후 맨 하단에 'successfully installed opendartreader'이라는 문장이 보이면 성공이다.

(5) 위쪽에 '+코드' 메뉴를 클릭하자. 그러면 새 코드를 붙여넣을 칸이 아래 하나 더 생성된다.

(6) 이제 아래의 [코드 박스] 내용을 복사해서 구글 코랩에 붙여넣으세요. 수정할 부분은 YOUR_...라고 된 3곳입니다.

* 밑줄 친 주황색 부분을 클릭하면 해당 설명으로 자동 이동합니다.

✅ DART 인증키 입력: [여기]를 클릭해 (7)번에서 확인한 키를 넣으세요.

✅ 텔레그램 토큰 입력: [여기]를 클릭해 발급받은 토큰을 넣으세요.

✅ 텔레그램 CHAT ID 입력: [여기]를 클릭해 (10)번에서 확인한 숫자를 넣으세요.

import OpenDartReader
import requests

# ==========================================
# 1. 개인 정보 설정 (이 부분을 본인의 정보로 수정하세요!)
# ==========================================
DART_API_KEY = 'YOUR_DART_API_KEY'
TELEGRAM_TOKEN = 'YOUR_TELEGRAM_TOKEN'
CHAT_ID = 'YOUR_CHAT_ID'

def test_dart_telegram():
    print("1. 📡 다트(DART) 서버 정밀 연결 중...")
    dart = OpenDartReader(DART_API_KEY)

    try:
        # ---------------------------------------------------------
        # [중요] 데이터 부하를 줄이기 위해 특정 종목(삼성전자) 1건만 조회합니다.
        # 테스트 단계에서는 서버에 무리를 주지 않는 것이 핵심입니다.
        # ---------------------------------------------------------
        target_stock = '삼성전자'
        print(f"2. 🔍 샘플 데이터({target_stock}) 추출 중...")
        
        # 2026년 1월 1일 이후의 공시 목록을 가져옵니다.
        df = dart.list(target_stock, start='20260101')

        if df is not None and len(df) > 0:
            # 가장 최신 공시 1건을 선택
            latest_report = df.iloc[0]
            rcept_no = latest_report['rcept_no']

            # 텔레그램으로 전송할 메시지 포맷
            message = (
                f"🚨 [초경량 연결 테스트 성공]\n"
                f"📦 종목: {latest_report['corp_name']}\n"
                f"📝 내용: {latest_report['report_nm']}\n"
                f"🔗 링크: https://dart.fss.or.kr/dsaf001/main.do?rcpNo={rcept_no}"
            )

            print("3. 📬 통신망 이상 무! 텔레그램 무전 송신 중...")
            url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
            requests.get(url, params={'chat_id': CHAT_ID, 'text': message})
            print(f"✅ [작전 완료] 텔레그램으로 성공 무전이 발송되었습니다.")
            
        else:
            print("🌑 공시 데이터를 찾을 수 없습니다. 종목명이나 날짜를 확인하세요.")
            
    except Exception as e:
        print(f"🚨 [비상] 통신 에러 발생: {e}")

# 테스트 실행
test_dart_telegram()

 

(7) 코랩에 위 코드를 붙여넣기가 끝났다면 왼쪽 상단에 동그라미 버튼을 클릭한다.

성공이라면 코랩에는 아래와 같은 문구가 나타난다.

1. 📡 다트(DART) 서버 정밀 연결 중...
2. 🔍 샘플 데이터(삼성전자) 추출 중...
3. 📤 통신망 이상 무! 텔레그램 송신 중...
✅ [작전 완료] 텔레그램 무전이 송신되었습니다.

 

성공이라면 텔레그램 대화방에는 아래와 같은 문구가 도착한다.

🚨 [초경량 연결 테스트 성공]
📦 종목: 삼성전자
📝 내용: 주식등의대량보유상황보고서(일반)
🔗 링크: https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260504000421

 

* 위 코드는 삼성전자의 공시 1건을 텔레그램의 대화장에 링크를 보내주는 코드이다.

** 지금은 링크로 보내지지만 제미나이를 이용해 공시의 요약기능을 추가해도 될 것 같다. 이와 관련된 것은 실험을 해보고 글을 따로 올릴 예정이다.

여기까지 텔레그램에 수신이 가능한지 구글 코랩으로 테스트를 잘 마쳤다.

 

함께 보면 좋은 자동화와 관련된 글

수집한 데이터를 지능적으로 요약하고 저장하는 방법이 궁금하다면?

파이썬으로 Gemini AI와 Notion API 연결하기

 #다트공시알림 #텔레그램봇만들기 #DART_API인증키 #파이썬주식알림 #구글코랩파이썬 #실시간공시알림 #주식공시자동화 #BotFather사용법 #OpenDartReader #주식투자꿀팁

댓글

댓글 쓰기

이 블로그의 인기 게시물

학점은행제 아동학 학사 학위 신청 방법, 보육교사 2급 자격증 취득 순서 정리

-
목차   아동학 학위가 먼저, 그다음 보육교사 2급 발급의 순서 보육교사 2급 자격증을 받는 게 쉬운 일은 아니었다. 그중 실습이 너무너무 힘들었고, 그 후에는 학점은행제에서 해야 할 일들을 스스로 알아봐서 실행해야 하는데 나의 경우 보육교사 2급 후에 장애영유아 자격증과 다른 학위를 도전하기도 하고, 사회복지사 2급의 몇몇 과목을 미리 들어놓은 것도 있어 순서를 잘 정하는 게 쉽지 않았다.   참고로 사회복지사 2급의 몇몇 과목을 들은 이유는 보육교사 2급과 사회복지사 2급이 겹치는 4과목 이 있다. 이 4과목을 단과로 조금 비싸게 들어놓았는데 일정이 좀 비어 사회복지사 5과목을 더 들으니 9과목이 되었다. 문제는 사회복지사 2급 전에 다른 학점은행제를 통해 다른 자격증을 먼저 따야 하고, 장애영유아는 어느 전공에 집어넣어야 하는지 많이 헷갈렸다.   큰 틀은 이미 잡혀 있지만 세세하게 알아보고 있는 상태이다. 만약 잘못되는 상황이 발생하면 그동안 들은 과목이 사라질 수 있어 돈과 시간이 너무 아까운 상태가 될까 좀 주저하게 되는 상황에 처해있다.   보육교사 2급은 학위가 필수 이다. 학위를 받고 보육교사 2급 자격증을 받게 된다. 그리고 장애영유아 자격증까지 받으려면 학위를 받고, 보육교사 2급 자격증을 받은 뒤 장애영유아 자격증을 받는 과정 을 거치게 된다. 나의 진행 상황은 학점은행제에서 아동학 학사에 충족되는 모든 과목을 다 들어놓은 상태이고 이번 달에 학위 신청을 해야 하는 단계이다. 나의 경우 이전 학사학위가 있어 아동학 학위를 마치는 데 총 3학기의 시간이 소요 되었다. 한 학기와 일 년에 수강할 수 있는 과목 개수가 정해져 있어서 이건 어쩔 수 없는 부분이다. 빨리 하고 싶다고 해도 빨리 끝낼 수 없다.   학점은행제의 나의 아동학 학적부 (이전 학사 보유자 기준) ...
자세한 내용 보기

블로그 작성 시간을 줄이자. 크롬 다크리더 사용 글자색이 회색으로 보이는 방법 해결

-
목차   다크리더 적용으로 블로그의 일부 글자색이 옅은 회색으로 보인다면? 나의 환경 : 맥북 부트캠프 윈도우 11 정품인증 안함, 크롬 DARK READER 확장 프로그램 설치 윈도우 정품 인증을 안 한 관계로 다크 모드 적용이 어려워 검정 바탕화면에 크롬 Dark Reader 확장 프로그램을 설치해 다크모드를 사용 중이다. 블로거의 테마는 일반모드의 테마를 적용시켜 사용 중이었다. 그러니까 흰색 바탕에 검정 글씨가 기본인 테마에 구글 다크리더 확장프로그램을 적용시켜 사용 중이었는데 이렇게 사용할 경우 블로그 작성의 문제는 블로그에 글을 쓰면 색이 꼬여버린다는 것이다. 현재는 구글 블로거를 사용 중인데 구글 블로거나 티스토리나 같은 현상이 발생했다. 이런 문제로 일반모드의 다른 웹에서 확인하면서 수정 과정을 거치게 되는데 매번 이렇게 하니 소모되는 시간이 너무 아까웠다. 다크모드에서 보이는 하얀색 글씨 중 일부가 일반 모드에서는 옅은 회색 글씨의 글들로 바뀌어 보이거나, 포인트를 준 글씨 색상이 다르게 나타나는 현상을 일일이 수정해줘야 했다. 블로그에 들이는 시간을 어떻게든 줄여나가야 하는데 이런 걸로 시간을 잡아먹게 할 수는 없고, 눈부심이 지독히도 싫어 다크모드는 꼭 써야 하는 게 나의 입장이므로 어떻게든 이 문제를 해결해야 할 방법을 찾아야 했다. 그래서 시도를 해본 게 블로거에서 다크모드가 적용된 테마로 변경하고, 크롬에서 적용한 Dark Reader는 특정 웹페이지에서는 다크모드 적용을 제외시키는 설정을 하는 것이다.   1. 블로거 테마 변경 일단 현재 사용 중인 구글 블로거의 일반 모드의 테마를 다크모드가 기본인 테마를 찾아 적용했다. 티스토리도 이런 방법으로 변경해도 될 것 같은데 요즘 티스토리를 누가 하나 싶기도 하다. Contempo 테마 의 DARK 로 선택해 변경   2. 크롬의 Dark Reader 확장 프로그램에서 '이 사이트에서 끄기' 설정 (...
자세한 내용 보기

유튜브 '나중에 볼 동영상' 10분만에 삭제, 스크립트 붙여넣기 오류 해결 방법

-
목차   유튜브 '나중에 볼 동영상'은 영상이 한꺼번에 삭제가 안 된다. 여기저기 흩어져 있는 산만한 것들 중 하나가 유튜브 영상 저장이다. '나중에 볼 영상' 에 3,000개가 넘는 영상이 저장되었다. 이런 상황이다 보니 꼭 봐야 할 영상을 급하게 저장을 해도 저 끝까지 스크롤을 내려야 최근 내가 마지막 저장한 영상을 볼 수 있다. 이렇게라도 보면 다행인데 잊어버리고 안 보는 게 99%이며 심지어 뭘 보려고 했었는지 기억조차 없다. 이렇게 쌓인 게 3,000개가 넘는 영상인데 휴대폰이나 데스크탑의 웹페이지, 아이패드에서 모두 한꺼번에 삭제할 수 있는 방법을 찾아봤지만 도대체 어디에도 보이지 않았다. 아니, 유튜브에서 '나중에 볼 동영상' 에 있는 영상들을 한꺼번에 삭제할 수 없다는 게 말이 되나?   크롬의 YT Watch Later Assist 확장프로그램? 실패! 요즘 제미나이에게 물어보면 거의 뭐든지 해결이 되는 터라 개발자도구와 크롬 확장프로그램을 설치해서 삭제하는 두 가지의 방법을 추천받아서 크롬의 'YT Watch Later Assist' 를 설치해서 시도해 보았으나 나중에 볼 동영상 폴더의 영상들이 삭제가 전혀 되지 않았다. 결국 무쓸모인 확장프로그램은 지워버렸다.   스크립트로 나중에 볼 동영상들 삭제하기 그래서 결국은 검색을 했다. 검색의 시대는 끝난 줄 알았는데 제미나이도 실수가 많고, 완벽하진 않다. 단박에 마음에 드는 글을 찾긴 했는데 코드가 첨부되어 있다. 코드는 제미나이를 이용해 버튼 몇 번 만들어본 게 전부라 이걸 내 컴퓨터에 적용해도 되는지 의문이었다. 그래서 제미나이에게 물어봤더니 안전하다는 결론을 얻었다. 해당 스크립트의 원본의 출처는 레드의 노트 님 글에 보면 스크립트를 복사해 붙여넣기를 잘 하면 된다. 나의 경우 아래 순서로 진행을 했다. 레드의 노트님의 코드를 적용했고 진행 방식은 좀 다르다. 내가 이 글을 쓰...
자세한 내용 보기