daily_stock_analysis: LLM이 매일 관심 종목 보고서를 써서 메신저로 보내 주는 도구

daily_stock_analysis는 관심 종목의 시세와 뉴스를 모아 LLM이 매일 분석 보고서를 쓰고, 텔레그램·슬랙·이메일 같은 곳으로 보내 주는 파이썬 기반 주식 분석 시스템이에요. 중국 A주에서 시작했지만 지금은 홍콩, 미국, 일본, 한국, 대만 주식과 ETF까지 다룬다고 밝히고 있어서, 국내 투자자도 써 볼 만한 범위가 됐어요.

무엇을 해 주나요

정해진 시간에 보고서를 만들어 보내요. 환경 변수 STOCK_LIST에 종목을 적어 두면, 시세 데이터 서비스에서 가격을 받고 뉴스 검색 서비스에서 관련 기사를 찾은 뒤, LLM에게 넘겨 종합 점수, 추세, 매수·매도 참고 가격, 위험 요인, 할 일 목록이 담긴 “결정 보고서”를 만들게 해요. 완성된 보고서는 설정한 알림 채널로 전송돼요.

실행 방법을 고를 수 있어요. GitHub Actions에 올려 두면 기본값으로 평일 베이징 시간 18시(한국 시간 19시)에 돌고, 휴장일은 건너뛰어요. Docker, 내 컴퓨터의 예약 작업, FastAPI 서버 방식도 있어요.

웹 화면과 대화 기능이 있어요. 웹 작업 화면에서 수동 분석, 진행 상황, 지난 보고서, 백테스트, 보유 종목 관리를 할 수 있어요. 저장소 설명에 따르면 15가지 내장 전략을 바탕으로 여러 턴 대화하며 전략을 묻는 에이전트 기능도 웹, 메신저 봇, API로 쓸 수 있어요. 종목은 이미지, CSV·엑셀, 클립보드로 한꺼번에 넣을 수 있어요.

연결할 수 있는 서비스가 많아요. LLM은 Gemini, Claude, OpenAI 호환 API(DeepSeek, Qwen 포함), 로컬 Ollama 등을 쓰고, 시세는 AkShare, Baostock, YFinance처럼 키 없이 쓰는 무료 소스와 Tushare, Longbridge 같은 선택 소스를 섞어 써요. 뉴스는 SerpAPI, Tavily, Brave, 직접 운영하는 SearXNG 등에서 찾고, 알림은 위챗 업무용, 페이슈, 텔레그램, 디스코드, 슬랙, 이메일로 보내요.

설치와 사용

README 배지 기준으로 Python 3.10 이상이 필요해요. 로컬 실행 순서는 아래와 같아요.

git clone https://github.com/ZhuLinsen/daily_stock_analysis.git
cd daily_stock_analysis
pip install -r requirements.txt
cp .env.example .env
# .env에 LLM 키, 알림 채널, STOCK_LIST를 적은 뒤
python main.py

최소한 LLM 키 하나(또는 Ollama), 알림 채널 하나, 종목 목록이 있어야 해요. 자주 쓰는 옵션은 다음과 같아요.

python main.py --dry-run           # 알림 없이 시험 실행
python main.py --stocks <종목코드>   # 특정 종목만 분석
python main.py --market-review      # 시장 전체 복기
python main.py --webui              # 웹 화면 (http://127.0.0.1:8000)

누구에게 쓸모 있나요

관심 종목 뉴스를 매일 직접 찾아 읽기 번거로운 개인 투자자에게 맞아요. 퇴근 무렵 메신저로 요약을 받아 보는 흐름을 GitHub Actions로 서버 없이 만들 수 있다는 점이 많은 별을 받은 이유로 보여요. 여러 데이터 소스를 하나로 묶고, 한 소스가 실패하면 다른 소스로 넘어가는 구조를 공부하려는 개발자에게도 참고가 돼요.

쓰기 전에 알아 둘 점

  • 학습·연구용이고 투자 조언이 아니며, 손실에 대해 저자가 책임지지 않는다고 README가 밝혀요. 보고서에 나오는 매수·매도 가격은 LLM이 만든 참고값일 뿐이에요.
  • “무료”라는 말은 GitHub Actions로 일정 실행하는 비용에 대한 이야기예요. 클라우드 LLM과 SerpAPI 같은 검색 서비스는 각자 요금이 들 수 있고, 가격은 README에 나와 있지 않아요.
  • 종목 코드, 뉴스 내용, 보고서가 LLM 업체와 검색·알림 서비스로 전송돼요. 보유 종목을 외부에 보내고 싶지 않다면 Ollama와 직접 운영하는 SearXNG 조합을 고려해 보세요. GitHub Actions로 돌리면 API 키를 저장소 Secrets에 넣어야 해요.
  • 무료 데이터 소스는 상위 서비스의 호출 제한, 주소 변경, 네트워크 문제로 언제든 멈출 수 있다고 README가 경고해요. 소셜 여론 분석은 미국 주식만 되고, 여러 에이전트를 엮는 기능은 아직 실험 단계예요. 시장별 데이터 한계는 별도 문서에 있어서 한국 주식이 어느 정도까지 지원되는지는 이번에 확인하지 못했어요.
  • 변경이 빨라요. 10월 15일, 11월 9일, 11월 16일에 릴리스가 나왔고, 11월 9일 판에서는 실험적이던 Codex 백엔드가 빠졌어요. 기본 모델 이름도 바뀌었으니 업데이트 때 변경 기록을 읽는 게 좋아요. 일부 모델 채널은 후원사 표시와 함께 기본 목록에 들어가 있어요.

저장소 상태

  • 별 73.2k, 포크 57.8k (확인 시점 기준). 포크가 유난히 많은 것은 GitHub Actions로 쓰려면 저장소를 포크해야 하는 구조 때문으로 보여요.
  • 열린 이슈 24개, 열린 PR 17개
  • 언어: Python (GitHub 트렌딩 페이지 표시 기준)
  • 라이선스: MIT
  • 마지막 커밋: 2026년 11월 17일 (RSI 계산을 한 곳으로 통일, 포트폴리오 입력값 검증 등)
  • 최신 릴리스: v3.35.0 (11월 16일, 페이지에 연도는 없지만 같은 날 변경 기록 정리 커밋과 맞아요). 대만 시장 복기, 대만·통합 시장 선택, Windows 종료 멈춤 수정 등이 들어갔어요.
  • 최상위 폴더: src, data_provider, strategies, bot, api, apps, docker, main.py, webui.py 등이 있어 README가 말하는 구성과 맞아요.

확인 범위

2026년 11월 18일에 GitHub 웹 페이지로 확인(API 미사용)했어요. 읽은 페이지는 저장소 첫 화면과 README, 릴리스 목록, 최근 커밋 목록, 열린 이슈 목록이에요. 시장별 지원 문서, 전체 설정 가이드, Docker·데스크톱 안내 문서는 읽지 않았어요. 언어는 트렌딩 페이지 표시로 확인했어요. 코드 분석, 설치와 실행은 하지 않았어요.

출처

Similar Posts