Codium Lab
All products
ProductsAutomationJul 3, 2026

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 로 보고합니다.

기술 스택

영역사용 기술
BackendPython 3.11+ · FastAPI · Uvicorn · SQLAlchemy 2(async) · Pydantic 2
수집/분석pykrx · pandas · httpx · croniter · tenacity · structlog
FrontendNext.js 16 · React 19 · Tailwind v4 · react-markdown · lucide-react
DBSQLite (WAL) — 컨테이너·워커가 파일 공유
인프라Docker Compose(api + web) + 호스트 LaunchAgent 워커

아키텍처

기술적으로 주목할 점

  • 컨테이너 ↔ 호스트 분리 — 격리된 api·web 컨테이너와 Claude 자격증명이 필요한 호스트 워커를 명확히 나누고, HTTP 폴링(claim → heartbeat → report) 으로 LLM 장기 작업을 안전하게 오케스트레이션.
  • 작업 추적 — 모든 작업이 progress_log(실시간) + result_json(완료) 로 기록되어 웹 UI 가 1초 폴링으로 진행 상황 표시.
  • 커스텀 스킬 모듈화 — 분석 로직을 프롬프트 + SKILL.md 로 분리, 타임아웃 시 프로세스 그룹째 kill.
All products