다트 공시, 깃허브 액션으로 실시간 자동 알림 받기 (텔레그램 봇 설정 및 연동 편) - EP02

-
목차


깃허브의 사용 목적은 24시간 가동하려는 용도로 다트와 텔레그램의 중간 역할을 하는 것이다. 지난 에피소드 01의 글에서는 원하는 종목의 다트 공시를 깃허브 내에서 수신이 가능한지 테스트를 하는 과정으로 글을 마쳤다. 이번 글은 '다트 공시, 깃허브 액션으로 내 휴대폰 텔레그램으로 실시간 자동 알림 받기 - EP01'의 연장선으로 다트의 공시를 깃허브를 거쳐 텔레그램으로 수신받을 수 있게 자동화시켜 놓는 과정을 담았다.

원활한 자동화 구축을 위해 1편의 기초 설정을 먼저 완료해 주세요.

🔗 다트 공시, 깃허브 액션으로 내 휴대폰 텔레그램으로 실시간 자동 알림 받기 - EP01


1. 준비사항

이번 과정에서는 텔레그램 봇 토큰과 Chat ID가 필요하다. 텔레그램 관련 준비사항은 다트 공시나 야후 파이낸스 지표 수치, 한경 리포트의 정보를 나의 휴대폰으로 수신하려면 필요하니 만들어야 한다.

이전 글에 텔레그램에서 봇 토큰과 Chat ID를 발급받는 과정을 남겨놓았으므로 해당 글을 참고해 만들면 된다.

📡 아직 텔레그램 봇 토큰과 Chat ID가 없으신가요?

다트와 깃허브로 보낸 정보를 수신하려면 텔레그램 전용 봇(Bot)과 chat ID가 필요합니다.
아래 버튼을 클릭해 이전 글의 과정을 참고해 준비하시기 바랍니다.

📲 텔레그램 봇 토큰, Chat ID 발급받는 방법

2. 깃허브 시크릿에 텔레그램 봇 토큰과 Chat ID 등록하기

지난 글 '다트 공시, 깃허브 액션으로 내 휴대폰 텔레그램으로 실시간 자동 알림 받기 - EP01'에서도 보안을 위해 다트 API 인증키를 보관해 코드에 직접적인 인증키가 들어가지 않게 하는 과정을 거쳤다. 이번에도 텔레그램 봇 토큰과 Chat ID를 보안을 위해 저장한다.

* 번거롭지만 텔레그램 봇 토큰과 Chat ID를 하나씩 따로 등록해놓아야 한다. 두 번의 등록 과정을 거친다.


깃허브 시크릿에 텔레그램 봇 토큰 등록 하기

(1) 상단의 에피소드 01에서 만든 저장소 이름을 클릭한다.

(2) 상단 우측 'Settings' 메뉴를 클릭한다.

(3) 왼쪽 메뉴에서 'Secrets and variables' ➡ 'Actions'을 클릭한다.

(4) 오른쪽에 있는 초록색 'New repository secret' 버튼을 클릭한다.

(5) 'Name *' ➡ TELEGRAM_BOT_TOKEN 이라고 입력한다.

(6) 'Secret *' 이라고 이름 지어진 칸에 봇 토큰을 붙여넣기 한다.

(7) 아래 초록색 'Add secret' 버튼을 클릭한다.

Repository secrets이라고 이름지어진 아래 칸에 보면 2개의 이름이 확인된다.

🔒DART_API_KEY 🔒TELEGRAM_BOT_TOKEN


깃허브 시크릿에 텔레그램 Chat ID 등록 하기

(8) 'Repository secrets' 옆에 초록색 'New repository secret' 버튼을 클릭한다.

(9) 'Name *' ➡ TELEGRAM_CHAT_ID 라고 입력한다.

(10) 'Secret *' 이라고 이름 지어진 칸에 텔레그램 Chat ID 숫자들을 붙여넣기 한다.

(11) 아래 초록색 'Add secret' 버튼을 클릭한다.

Repository secrets이라고 이름지어진 아래 칸에 보면 총 3개의 이름이 확인된다.

🔒DART_API_KEY 🔒TELEGRAM_BOT_TOKEN 🔒TELEGRAM_CHAT_ID


3. 텔레그램 수신 코드 넣기

깃허브 내에서 수신이 잘 되는지 확인했으니 이제 텔레그램으로 다트 공시 정보가 잘 수신되도록 코드를 변경해 업로드 해야 하는 과정이 남았다.

** 텔레그램에 봇 토큰과 Chat ID로 아무말이라도 남겨놓은 상태의 열어놓은 채팅방이 있어야 한다. 


깃허브 main.py 코드 수정

(12) 좌측 최상단 만들어둔 '저장소 이름'을 클릭해 해당 저장소로 이동한다.

(13) 목록 중 'main.py' 파일 이름을 클릭 한다.

(14) 우측 상단 연필 모양의 아이콘을 클릭한다.

(15) 기존에 있던 코드를 모두 삭제한다.

(16) 삭제 한 바로 그 공간에 아래 코드를 복사해 붙여넣기 한다.

import requests
import os

# 깃허브 Secrets에서 정보 가져오기
MY_DART_KEY = os.environ.get('DART_API_KEY')
TELEGRAM_TOKEN = os.environ.get('TELEGRAM_BOT_TOKEN')
TELEGRAM_ID = os.environ.get('TELEGRAM_CHAT_ID')

# 정찰 대상 설정 (예: 삼성전자)
STOCK_CODE = "005930"
STOCK_NAME = "삼성전자"

def send_telegram_message(message):
    """텔레그램으로 메시지 발송"""
    url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
    payload = {
        'chat_id': TELEGRAM_ID,
        'text': message,
        'parse_mode': 'HTML'
    }
    try:
        requests.post(url, data=payload)
        print("📢 [전송 완료] 텔레그램으로 보고를 마쳤습니다.")
    except Exception as e:
        print(f"🚨 [전송 실패] 텔레그램 발송 오류: {e}")

def check_disclosure():
    print(f"📡 [시스템 가동] {STOCK_NAME} 실시간 공시 정찰 시작.")
    url = f"https://opendart.fss.or.kr/api/list.json?crtfc_key={MY_DART_KEY}&corp_code={STOCK_CODE}&bgn_de=20240101&page_count=5"
    
    try:
        response = requests.get(url)
        data = response.json()
        
        if data['status'] == '000':
            report_list = data['list']
            latest = report_list[0]
            report_msg = (
                f"<b>[실시간 공시 보고]</b>\n\n"
                f"🏢 종목: {STOCK_NAME}\n"
                f"📄 공시명: {latest['report_nm']}\n"
                f"📅 접수일: {latest['rcept_dt']}\n"
                f"🔗 <a href='https://dart.fss.or.kr/dsaf001/main.do?rcpNo={latest['rcept_no']}'>공시 상세보기</a>"
            )
            send_telegram_message(report_msg)
        else:
            print(f"❌ 데이터 수신 실패: {data['message']}")
    except Exception as e:
        print(f"🚨 시스템 오류: {e}")

if __name__ == "__main__":
    check_disclosure()

 

저장

(17) 상단 우측의 초록색 'Commit changes...' 버튼을 클릭한다.

(18) 팝업창이 뜨면 하단 'Commit changes' 버튼을 클릭한다.


이 다음 상황이 텔레그램으로 다트 공시 내용이 수신되어야 하는데 실패해서 헤맸었다. 

* 여기서 헤맸는데 깃허브 시크릿에 저장해둔 탤래그램 봇 토큰과 Chat ID를 연결해 주는 작업을 거쳐야 했다. 이 글이 체혐한것을 기록하는 글이라 좀 미흡하긴 하다.


탤래그램 봇 토큰,  Chat ID를 연결

(19) 상단 메뉴 중 '< > Code' 메뉴를 클릭한다.

(20) .github/workflows 폴더 클릭 ➡ 'main.yml' 파일을 클릭한다.

(21) 우측 상단 연필 모양의 아이콘을 클릭한다. 수정하려는 것이다. 

(22) 기존 코드를 삭제하고 아래 코드를 복사, 붙여넣기해서 교체한다. (설명이 어려워서 그냥 통째로 넣게 했다.)

** 여기서 주의 할게 있는데 들여쓰기를 잘 해야 한다. 잘 못 되었다면 빨간 밑줄이 생길것이다. 빨간 밑줄이 생기지 않아야 한다. 

name: DART Disclosure Radar

on:
  schedule:
    - cron: '0 0-9 * * 1-5'
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.9'

      - name: Install dependencies
        run: |
          pip install -r requirements.txt

      - name: Run script
        env:
          DART_API_KEY: ${{ secrets.DART_API_KEY }}
          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
        run: |
          python main.py


(23) 우측 상단의 초록색 'Commit Changes' 버튼을 클릭한다.

(24) 팝업창이 뜨면 하단 'Commit changes' 버튼을 클릭한다.

(25) 상단 메뉴 중 'Actions'을 클릭한다.


수동실행으로 수신 여부 테스트

(26) 왼쪽 메뉴 중 'DART Disclosure Radar'를 클릭한다.

(27) 우측 버튼 'Run workflow'를 클릭  ➡ 아래 초록색 Run workflow 버튼 클릭한다.

(28) 텔레그램 대화창을 확인한다.


필자의 텔레그램 대화창에 아래와 같은 정보가 수신 되었다.

[실시간 공시 보고]

🏢 종목: 삼성전자

📄 공시명: 임원ㆍ주요주주특정증권등소유상황보고서

📅 접수일: 20260513

🔗 공시 상세보기 (https://dart.fss.or.kr/dsaf001/main.do?rcpNo=20260513000081)

이렇게 텔레그램으로 다트 공시 정보의 내용이 도착하다면 성공이다. 


파이썬으로 다트 공시 노션으로 자동 알림 받기

파이썬으로 자동 수집한 투자 데이터(DART 공시, 텔레그램 뉴스)를 
노션 페이지에 실시간으로 전송 및 자동 기록하기 위한 기초 단계

파이썬 기반 구글 제미나이 X 노션 API 연동, 자동화의 기초 환경 설정
#주식자동화 #다트 #DART #깃허브액션 #GitHubActions #파이썬 #Python #텔레그램봇 #실시간알림 #깃허브시크릿 #GitHubSecrets #재테크독학 #코딩공부

댓글

댓글 쓰기

이 블로그의 인기 게시물

학점은행제 아동학 학사 학위 신청 방법, 보육교사 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' 를 설치해서 시도해 보았으나 나중에 볼 동영상 폴더의 영상들이 삭제가 전혀 되지 않았다. 결국 무쓸모인 확장프로그램은 지워버렸다.   스크립트로 나중에 볼 동영상들 삭제하기 그래서 결국은 검색을 했다. 검색의 시대는 끝난 줄 알았는데 제미나이도 실수가 많고, 완벽하진 않다. 단박에 마음에 드는 글을 찾긴 했는데 코드가 첨부되어 있다. 코드는 제미나이를 이용해 버튼 몇 번 만들어본 게 전부라 이걸 내 컴퓨터에 적용해도 되는지 의문이었다. 그래서 제미나이에게 물어봤더니 안전하다는 결론을 얻었다. 해당 스크립트의 원본의 출처는 레드의 노트 님 글에 보면 스크립트를 복사해 붙여넣기를 잘 하면 된다. 나의 경우 아래 순서로 진행을 했다. 레드의 노트님의 코드를 적용했고 진행 방식은 좀 다르다. 내가 이 글을 쓰...
자세한 내용 보기