GitHub의 무료 cron 위에서 돌아가는 71,000스타 주식 분석기

대부분의 "AI 에이전트" 프로젝트는 사람이 실행 버튼을 눌러 줘야 하는 데모예요. 저장소를 클론하고, 의존성 마흔 개를 설치하고, 그러고 나서 알게 되죠. 지능은 진짜고 운영은 상상이라는 걸. 매일 아침 그걸 실행하는 일을 기억하는 사람이 되고 싶은 사람은 없어요.
ZhuLinsen/daily_stock_analysis는 반대쪽에 있는 프로젝트예요. 대략 71,600개의 스타를 모았고, 이번 달 GitHub 주간 트렌딩에서 꽤 의외인 항목 중 하나예요. 이건 잊히도록 설계됐어요. 포크하고, 시크릿 몇 개를 채우고, 워크플로를 켜 두면, 매 거래일 베이징 시간 18:00에 대시보드가 채팅 앱으로 알아서 도착해요. 당신이 기억했든 안 했든요.
A주와 홍콩, 미국, 일본, 한국, 대만 시장을 다루고, 관심 종목은 직접 지정해요. 시세와 뉴스를 가져와서 LLM에 둘을 함께 읽히고, 판단 대시보드를 WeCom, Feishu, Telegram, Discord, Slack 또는 이메일로 밀어 넣어요. MIT 라이선스, Python 3.10 이상, 뒤에는 arXiv에 올라간 논문도 있어요.
설정 과정 자체가 제품이에요
GitHub Actions 쪽 경로는 오 분쯤 걸리고 로컬 환경이 전혀 필요 없어요.
저장소를 포크해요. repository secrets를 추가해요. 필수는 `STOCK_LIST` 하나이고, 시장을 넘나드는 쉼표 구분 코드로 적어요. `600519,hk00700,AAPL,7203.T,005930.KS,2330.TW` 같은 식이에요. 알림 채널을 최소 하나 골라요. `WECHAT_WEBHOOK_URL`, `FEISHU_WEBHOOK_URL`, `TELEGRAM_BOT_TOKEN`과 `TELEGRAM_CHAT_ID`, `DISCORD_WEBHOOK_URL`, `SLACK_BOT_TOKEN`과 `SLACK_CHANNEL_ID`, 또는 `EMAIL_SENDER`와 `EMAIL_PASSWORD`예요. 원하면 뉴스 품질을 올릴 검색 키를 더할 수 있어요. SerpAPI를 권하고, Tavily, Bocha, Brave, MiniMax, 직접 띄운 SearXNG 인스턴스가 대안이에요.
그다음 Actions 탭으로 가서 워크플로를 켜겠냐는 안내에 동의하고, "每日股票分析"을 한 번 직접 돌려서 되는지 확인해요. 이후로는 평일 베이징 시간 18:00에 스스로 실행되고, A주와 홍콩, 미국 휴장일을 포함한 비거래일은 건너뛰어요. 강제 실행과 체크포인트 재개도 지원해요.
흐름을 직접 쥐고 싶은 사람에게는 로컬 경로가 있어요.
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
CLI 스위치는 꽤 갖춰져 있어요. `--debug`는 상세 로그, `--dry-run`은 밀어 넣지 않고 생성만, `--stocks`는 한 번만 관심 종목 덮어쓰기, `--market-review`는 종목별이 아니라 시장 단위 요약, `--schedule`은 오래 떠 있는 로컬 스케줄러, `--serve-only`는 분석 없이 웹 화면만 실행해요. 중간 지대를 원하면 Docker 이미지 `zhulinsen/daily_stock_analysis`도 있어요.
무료 데이터 소스가 모델보다 중요한 이유
이 프로젝트의 경제성이 재미있는 부분이에요.
기본 시세 데이터는 AkShare, Baostock, YFinance에서 오고 전부 무료예요. README는 분명히 적어 두었어요. 어떤 소스가 설정되지 않았다는 로그 줄은 실행에 영향을 주지 않는다고요. 유료 대안도 있어요. A주와 ETF는 TickPlus, 과거 데이터 안정성은 Tushare, 홍콩의 거래대금이나 PER 같은 항목은 Longbridge예요. 다만 돈을 쓰지 않고도 쓸 만한 대시보드를 내는 게 설계 목표예요.
연산은 GitHub Actions 분이고, 평일에 한 번 도는 공개 포크라면 사실상 무료예요. 비용이 나타나는 곳은 뉴스 검색뿐이고, 거기서도 여러 제공자의 무료 한도로 십여 개 티커짜리 관심 종목은 덮여요.
무료 데이터, 무료 연산, 무료 전달. 이 조합이 스타 수가 올라간 이유예요. 분석은 유료 터미널보다 낫지 않아요. 그래도 한 번 돌리는 한계 비용이 0이라, 계속 켜 두고 무슨 일이 생기는지 볼 수 있어요.
실제로 무엇을 내놓는가
대시보드는 종목별 블록이고, 가격 흐름과 뉴스 심리, 공시, 촉매에 대한 LLM의 해석에 시장 단위 요약이 붙어요. README는 성능이 떨어질 때의 규칙도 솔직하게 적어요. 소셜 심리와 일부 뉴스 소스는 API가 속도를 제한하면 대체되거나 빠져요. 시스템은 그 사실을 기록하고, 데이터가 다 모인 척하지 않아요.
그 솔직함은 마땅히 있어야 할 정도보다 드물어요. 대부분의 AI 대시보드는 입력이 도착했든 말든 자신감 있는 요약을 내놓아요. 이쪽은 빠진 소스를 보고해야 할 상태로 다뤄요.
어디서 틀리는가
커버리지는 종이 위에서는 넓고 실제로는 고르지 않아요. 어디가 그런지는 저장소 자체의 문서가 가장 좋은 안내예요.
시세 품질은 어느 피드가 응답하느냐에 달려 있어요. AkShare와 Baostock은 커뮤니티가 관리하고, 가끔 늦거나 schema를 바꿔요. YFinance는 미국 종목에 강하고 얇은 시장에는 약해요. 홍콩의 회전율, 거래량 비율, PER 같은 항목은 Longbridge 자격 증명이 있어야 완성돼요. 설정하지 않은 상태라면 그 시장의 대시보드에 눈에 보이는 구멍이 남는다는 뜻이에요.
LLM 단계는 뉴스 계층이 찾은 것을 그대로 물려받아요. 검색 키가 없으면 심리 항목은 가격 흐름과 공시로 퇴화하고, 소셜에서 시끄럽게 회자되는 종목이 조용하게 읽혀요. 빠진 소스는 조용히 메워지지 않고 보고된다고 README는 밝혀요. 판단으로는 맞지만, 같은 저장소의 두 사용자가 같은 날 같은 종목에 대해 꽤 다른 대시보드를 받을 수 있다는 뜻이기도 해요.
그리고 분석 자체는 공개 정보를 요약하는 언어 모델이에요. 밸류에이션 모델을 돌리는 것도 아니고, 컨센서스 추정치를 가진 것도 아니고, 어떤 가격 움직임이 과잉 반응이었는지 알려 줄 수도 없어요. 할 수 있는 일은 헤드라인 마흔 개와 공시 세 건, 일주일치 가격 흐름을 시장이 열리기 전에 정말 읽게 되는 한 장으로 압축하는 것이에요.
베껴 둘 만한 부분
종목 층을 걷어 내면 지금 공급이 부족한 제품 범주의 틀이 남아요. 정해진 시각에 돌고, 사적이고, 용도가 하나뿐인 에이전트가 물어보길 기다리지 않고 결과를 밀어 넣는 형태예요.
부품은 설명하기 민망할 만큼 단순해요. cron 하나. 우아하게 퇴화하는 무료 데이터 소스 몇 개. 구조화된 데이터를 사람이 실제로 읽는 글로 바꾸는 LLM 단계. 사용자가 이미 보고 있는 전달 채널. 서버를 유지할 필요 없는 설정 파일.
올해 나온 "AI 어시스턴트"는 거의 전부 반대예요. 무엇을 물어야 하는지 사용자가 알고 있어야 하는 채팅 창이에요. cron과 푸시라는 형태는 그걸 뒤집어요. 사용자에게는 모델을 심문하는 것보다 중요한 일이 있다고 가정하고, 정해진 시각에 구체적인 무언가를 들고 나타나는 방식으로 제자리를 얻어요.
반드시 말해 둬야 할 단서
이건 취미 수준의 분석 도구이고 투자 조언이 아니에요. 저장소도 그렇게 말해요. 어떤 종목의 공개 뉴스를 요약하는 언어 모델은 리서치 애널리스트가 아니고, 매일 저녁 도착하는 대시보드는 너무 규칙적이기 때문에 오히려 가짜 엄밀함을 만들 수 있어요.
무엇이 바뀌었는지 알려 주는 필터로 쓰세요. 무엇을 하라고 말하는 신탁으로 다루는 사람은 잘못 쓰는 거예요. 이번 달에 나온 대부분의 AI 제품도 같아요. 가치는 읽는 양이 줄어드는 데 있고, 결론에는 없어요.