관심 종목,매일 저녁AI가 정리해준다면
중급자용© AIKOREACLUBZhuLinsen/daily_stock_analysis
관심 종목, 매일 저녁 AI가 정리해 준다면
관심 종목 목록을 넣어 두면 평일마다 정해진 시각에 AI가 시세, 차트 지표, 뉴스를 모아 읽고 점수와 위험 요인을 담은 '결정 대시보드'를 텔레그램이나 메일로 보내 주는 무료 공개 도구예요. 한국 주식도 종목 코드 뒤에 .KS, .KQ 를 붙이면 분석해요
퇴근길 지하철에서 관심 종목 다섯 개를 하나씩 눌러 봐요. 시세 앱을 열고, 뉴스를 찾고, 공시를 확인하고, 차트 지표까지 보면 종목 하나에 몇 분씩 걸려요. 매일 하자니 지치고, 건너뛰면 놓친 소식이 생기죠.daily_stock_analysis는 이 순회를 AI에게 맡기는 도구예요. 종목 목록과 API 키만 넣어 두면 평일 저녁마다 GitHub Actions가 알아서 돌고, 종목별 점수와 위험 경보, 호재를 한 장으로 묶어 휴대폰으로 보내요. 올해 1월에 공개된 뒤 깃허브에서 빠르게 별을 모은 저장소예요. 먼저 짚어 둘게요. 이 도구의 보고서는 투자 조언이 아니에요. 만든 사람도 학습과 연구용이라고 밝혀요.
매일 저녁 손으로 하던 순회, 한 장으로
결정 대시보드평일 19:00 · 텔레그램
README가 꼽은 보고서 칸이에요. 흩어진 곳을 돌던 일을 AI가 대신 읽고 한 장으로 묶어요. 다만 이 한 장도 AI의 의견이라, 판단은 직접 해요.
README의 기능 표와 보고서 칸을 보여 주려고 저희가 그린 예시예요. 종목 이름과 코드는 지어낸 것이고, 실제 결과는 연결한 모델과 데이터 출처에 따라 달라져요.
한눈에
무엇인가요
무엇을 해 주나요. 관심 종목마다 시세와 일봉, 기술 지표, 뉴스, 공시, 기본 지표를 모아 AI 모델에게 읽히고, 핵심 결론, 점수, 추세, 매수·매도 가격대, 위험 경보, 호재, 점검표가 담긴 보고서를 만들어요. 여러 종목을 묶은 요약은 '결정 대시보드'라는 이름으로 알림 채널에 보내요.어디서 돌아가나요. 저장소를 내 계정으로 복사(Fork)해 GitHub Actions에서 돌리면 서버 없이 정해진 시각에 자동으로 실행돼요. 내 컴퓨터나 도커에서 돌리면 웹 화면도 쓸 수 있어요.한국 주식은요. 삼성전자 같은 코스피 종목은 005930.KS, 코스닥 종목은 035720.KQ 처럼 야후 파이낸스 표기로 넣어요. 한국 종목은 야후 파이낸스 데이터만 쓰고, 기본 지표와 업종 정보는 다 채워진다고 약속하지 않아요. 보고서는 REPORT_LANGUAGE 를 ko 로 두면 한국어로 나와요.
함께 쓰는 도구 · GitHub Actions · 제미나이 · 클로드 · OpenAI 호환 모델 · 올라마(내 컴퓨터 모델)
이런 분께
- 관심 종목 여러 개를 매일 챙기는데 앱과 뉴스를 일일이 돌아보기 번거로운 분
- AI 모델이 종목 정보를 어떤 순서로 읽고 정리하는지 공부해 보고 싶은 분
- 서버 없이 GitHub Actions로 매일 자동 보고서를 받아 보는 방법을 배우려는 분
어떻게 작동하나요
하루 한 번, 이렇게 돌아요.
1. 정해진 시각에 GitHub Actions가 깨어나요(평일, 기본은 UTC 10:00)
2. 그날이 휴장일이면 건너뛰어요. 강제로 돌리는 스위치도 있어요
3. 종목마다 시세, 지표, 뉴스를 모아 AI 모델에 넘겨요
4. 모델이 종목별 보고서를 쓰고, 전체 요약을 결정 대시보드로 묶어요
5. 정해 둔 알림 채널로 보내요키는 Secrets에만 넣어요. 모델 키, 알림 채널 주소, 종목 목록(STOCK_LIST)을 저장소 설정의 Secrets에 넣는 방식이라 코드 파일을 고칠 필요가 없어요. 모델 키는 하나 이상, 알림 채널도 하나 이상 필요해요.뉴스 검색을 붙이면 좋아져요. README는 뉴스 검색 서비스를 하나 이상 연결하라고 권해요. 뉴스가 위험 경보와 호재 칸의 질을 크게 좌우한다고 해요.한국에서 쓸 때. 실행 시각을 바꾸려면 .github/workflows/00-daily-analysis.yml 의 cron 값을 UTC 기준으로 고쳐요. 한국 종목 자동 완성은 자주 찾는 종목 30개 안팎만 들어 있고, 없는 종목은 코드를 직접 넣으면 돼요. 한국 시장 복기에는 오른 종목 수나 업종 순위가 나오지 않아요.보고서에 나오는 점수와 가격대는 AI가 모은 자료로 쓴 의견이고, 사고팔지는 내가 정해요.
할 수 있는 일
바로 쓸 수 있나요
필요한 것깃허브 계정, AI 모델 API 키 하나 이상, 알림 받을 채널(텔레그램 봇, 메일 등). 내 컴퓨터에서 돌리려면 파이썬 3.10 이상
비용저장소는 무료(MIT). AI 모델 요금과 일부 뉴스 검색 서비스 요금은 따로예요. 기본 시세 데이터는 무료 공개 출처를 써요
시작하기
- 저장소를 내 계정으로 복사
깃허브 저장소 오른쪽 위의 Fork 버튼을 눌러요.
- Secrets 넣기
내 저장소의 Settings → Secrets and variables → Actions → New repository secret 에서 넣어요. 모델 키(예: GEMINI_API_KEY, ANTHROPIC_API_KEY 중 하나 이상), 알림 채널(예: TELEGRAM_BOT_TOKEN 과 TELEGRAM_CHAT_ID), 종목 목록 STOCK_LIST 가 필요해요. 한국어 보고서를 받으려면 REPORT_LANGUAGE 에 ko 를 넣어요.
STOCK_LIST=005930.KS,035720.KQ,AAPL - Actions 켜기
Actions 탭에서 I understand my workflows, go ahead and enable them 을 눌러요.
- 한 번 손으로 돌려 보기
Actions 탭 왼쪽 목록에서 '매일 주식 분석' 워크플로(이름이 중국어로 적혀 있어요)를 고르고 Run workflow 를 눌러요. 그다음부터는 평일마다 자동으로 돌아요.
- 내 컴퓨터에서 돌리고 싶다면
README의 두 번째 방법이에요. .env 에 같은 값을 넣고 실행해요. 웹 화면은 python main.py --webui 로 열고 http://127.0.0.1:8000 에 접속해요.
git clone https://github.com/ZhuLinsen/daily_stock_analysis.git && cd daily_stock_analysis pip install -r requirements.txt cp .env.example .env python main.py
python main.py --stocks 005930.KS,035720.KQ --dry-run
README의 자주 쓰는 명령(--stocks, --dry-run)에 한국 종목 코드를 넣은 예예요. --dry-run 이 무엇을 건너뛰는지는 README에 따로 적혀 있지 않아요. 먼저 --debug 로 로그를 보며 돌려 보는 것도 방법이에요.목록을 넣으면 저녁마다 이런 메시지가 와요
README의 설정 방법, 실행 순서, 결정 대시보드 모양을 우리말로 옮겨 저희가 그린 예시예요. 종목, 점수, 소식은 모두 지어낸 것이고 실제 사고팔 근거가 아니에요. 실제 결과는 연결한 모델과 뉴스 검색, 데이터 출처에 따라 달라져요.
비슷한 도구
daily_stock_analysis는 여러 종목을 매일 넓게 훑어 알림으로 보내는 데, TradingAgents는 종목 하나를 여러 역할이 깊게 토론하는 데 무게가 있어요(각 README 기준).
주의할 점
- 투자 조언이 아니에요. README 면책 문구 그대로, 이 도구는 학습과 연구용이고 어떤 투자 권유도 아니며, 만든 사람은 사용으로 생긴 손실을 책임지지 않아요. 보고서의 매수·매도 가격대와 점수는 AI가 쓴 의견이고 수익을 보장하지 않아요. 사고파는 판단과 책임은 본인에게 있어요.
- 한국 주식은 일부 기능만 돼요. 시세와 일봉은 야후 파이낸스로만 받고, 기본 지표·업종·시장 전체 통계는 약속하지 않아요. 보유 종목 화면의 원화 환율·평균 단가·평가액도 일부만 맞고, 가격 알림 화면의 시장 선택에는 한국이 없다고 문서(market-support.md)가 밝혀요.
- 중국어가 기본이에요. README와 워크플로 이름이 중국어로 먼저 쓰였고(영어 README 있음), 웹 화면 글자는 중국어와 영어만 골라요. 뉴스는 같은 조건이면 중국어 기사를 먼저 보여 주도록 정렬돼요. 보고서만 한국어(ko)로 받을 수 있어요.
- API 키는 Secrets에만 넣고 저장소 파일에 적지 마세요. 복사한 저장소는 공개 상태일 수 있어요. README가 '추천'으로 표시한 모델·검색 서비스 일부는 이 프로젝트의 후원사이고 추천 코드가 붙은 링크예요.
- 기본 시세 출처는 무료라 접속 제한이나 바뀐 규격 때문에 멈출 수 있다고 README가 적어요. 매일 꾸준히 돌리려면 토큰을 받는 데이터 출처를 붙이라고 권해요.
더 보기
ZhuLinsen이 2026-01-10에 공개한 파이썬 프로젝트예요. 같은 사람이 만든 종목 고르기 참고 프로젝트 AlphaSift, 전략 검증용 AlphaEvo가 따로 있어요.
낯선 말
- GitHub Actions · 깃허브가 저장소 안의 작업을 정해진 시각이나 버튼 하나로 대신 돌려 주는 기능이에요
- Fork · 남의 깃허브 저장소를 내 계정으로 통째로 복사하는 일이에요
- Secrets · API 키 같은 비밀값을 저장소 코드에 드러내지 않고 넣어 두는 깃허브 설정 칸이에요
- cron · 몇 시 몇 분, 무슨 요일에 실행할지 적는 시간표 표기예요. GitHub Actions는 UTC 기준이에요
- .KS / .KQ · 야후 파이낸스에서 코스피 종목(.KS)과 코스닥 종목(.KQ)을 나타내는 꼬리표예요
- 백테스트 · 지난 판단을 그 뒤 실제 가격과 맞춰 보며 맞았는지 되짚는 일이에요
댓글
AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.

