제품 목록
Products업무 자동화2026년 7월 3일
Alpha Flow
Mac mini 한 대로 한국 주식 데이터를 수집하고 Claude 가 매일 장 마감 분석 리포트를 쓰는 1인 운영 투자 인사이트 시스템
FastAPINext.js 16SQLitepykrxClaude CLIDocker
#한국주식#AI리포트자동화#self-hosted#핀테크
Mac mini 한 대로 한국 주식 데이터를 자동 수집하고, Claude 가 매일 장 마감 분석 리포트를 써 줍니다. 1인 운영형 투자 인사이트 시스템입니다.
무엇을 하나요
- 데이터 수집 — KRX 시세를 자동 수집(pykrx)합니다.
- AI 분석 리포트 — 로컬 Claude Code 가 상승/하락 상위 종목, 거래량 급증, 섹터 로테이션, 지표 신호를 담은 마크다운 리포트를 일별 생성합니다.
- 웹 대시보드 — 스케줄 ON/OFF, 즉시 실행 트리거, 리포트 열람, 실시간 진행 로그를 라이트/다크 UI 로 제공합니다.
- cron 스케줄러 내장 — FastAPI 백그라운드 태스크가 30초 주기 트리거 생성, 10초 주기 수집 실행, 60초 주기 watchdog 으로 방치 작업을 감시합니다.
- 호스트 워커 분리 — LaunchAgent 워커가 5초 폴링으로 트리거를 claim → Claude CLI 실행 → stdout 을 heartbeat 로 릴레이 → 구조화 result 로 보고합니다.
기술 스택
| 영역 | 사용 기술 |
|---|---|
| Backend | Python 3.11+ · FastAPI · Uvicorn · SQLAlchemy 2(async) · Pydantic 2 |
| 수집/분석 | pykrx · pandas · httpx · croniter · tenacity · structlog |
| Frontend | Next.js 16 · React 19 · Tailwind v4 · react-markdown · lucide-react |
| DB | SQLite (WAL) — 컨테이너·워커가 파일 공유 |
| 인프라 | Docker Compose(api + web) + 호스트 LaunchAgent 워커 |
아키텍처
기술적으로 주목할 점
- 컨테이너 ↔ 호스트 분리 — 격리된 api·web 컨테이너와 Claude 자격증명이 필요한 호스트 워커를 명확히 나누고, HTTP 폴링(claim → heartbeat → report) 으로 LLM 장기 작업을 안전하게 오케스트레이션.
- 작업 추적 — 모든 작업이 progress_log(실시간) + result_json(완료) 로 기록되어 웹 UI 가 1초 폴링으로 진행 상황 표시.
- 커스텀 스킬 모듈화 — 분석 로직을 프롬프트 + SKILL.md 로 분리, 타임아웃 시 프로세스 그룹째 kill.