종목분석 에이전트 — 시스템 아키텍처

산출물 현황

135

종목/ETF 리포트

96

브리핑 리포트

75

애널리스트 항목

5

리서치 Deep Dive

23

에이전트

26

섹터 KB

16

대시보드 위젯

2

배포 채널

1. 오케스트레이터 (Lead 에이전트)

stock-analyst-lead

개별 종목/ETF 분석 총괄. 5종 분석 에이전트 병렬 호출 + scorecard 통합. ETF 감지 시 etf-lead 위임.

briefing-lead

브리핑 7종 총괄 (모닝/이브닝/주간/크립토/모델포트/글로벌인텔/풀). 16단계 워크플로.

etf-lead

ETF 전용. data-collector, etf-analyst, report-generator 3단계 파이프라인.

2. 데이터 수집 계층

data-collector

종목 개별 데이터. 주가, 공시, DART, 재무제표, 뉴스, 컨센서스.

market-data-collector

시장 전체 스냅샷. 지수, 환율, 원자재, 채권, 크립토, 경제 캘린더, 13F.

kb-updater

섹터별 KB 갱신. 산업 트렌드, 매크로, 규제 변화 웹검색 수집.

research-curator

10섹터 학술/씽크탱크/컨퍼런스/규제 1차 자료. L1주간/L2월간/L3분기.

analyst-scraper

IB/증권사 리포트 자동 수집. PDF 처리 + 웹 스크랩 + YouTube.

빌드 타임 데이터 페치 (Vercel prebuild)

fetch_fear_greed.mjs (CNN/Crypto F&G) fetch_fred.mjs (FRED 15개 시리즈) fetch_openinsider.mjs (인사이더 클러스터)

3. 분석 에이전트 계층

종목분석 5종 (stock-analyst-lead가 병렬 호출)

company-overview

기업개요, 경쟁력(Moat), 사업구조, 지배구조 분석.

financial-analyst

재무분석, 실적추이, 밸류에이션, DCF, 목표주가 산출.

business-analyst

산업 트렌드, 경쟁구도, TAM/SAM, Porter's Five Forces.

momentum-analyst

모멘텀, 수급, 외국인/기관 흐름, 컨센서스, 이벤트 촉매.

risk-analyst

리스크 식별/정량화. 재무/사업/규제/매크로/ESG/꼬리 리스크.

↓

scorecard-strategist

5종 통합 -> 10항목 가중 스코어카드 + ATR 손절/목표가 + 투자전략. KB 피드백 루프.

브리핑 분석 2종 (briefing-lead가 호출)

global-macro-analyst

매크로 4축 교차 (지정학/정치/기술/에너지). 시나리오 플래닝.

correlation-monitor

6쌍 상관계수 30D/90D + Z-score Alert. 경제 서프라이즈 Beat/Miss.

유틸리티

etf-analyst

ETF 전용. Holdings, 보수율, 추적오차, NAV, 섹터 배분.

reanalysis-tracker

재분석 변화 추적. 신규 vs 직전 스코어카드 BLIND 비교.

wiki-linter

KB 건강 점검. 만료/실패/모순/미수집/고아 파일 탐지 + 자동 수정.

4. Knowledge Base (2계층)

knowledge-base/ (CURRENT)

market/ (7파일)

daily_snapshot, correlation_matrix, surprise_index, guru_positions, economic_calendar, fear_greed.json

portfolio/ (4파일)

model_portfolios, user_portfolio, insider_signals.json, rebalancing_history

macro/ (8파일)

fred_snapshot.json, us_monetary_policy, geopolitics, global_risk_factors, korea_economy 등

industry/ (26섹터)

semiconductor, energy, defense, bio_pharma, ai, auto, capex, smr 등

research/ (10섹터)

반도체, 에너지, 바이오, 핀테크, 방산, 기술플랫폼, 소비재, 산업재, 자동차, 매크로

knowledge-db/ (ARCHIVE)

market/ (시계열)

2026_daily_prices.md (일별 가격 이력)

performance/ (추적)

시나리오 추적, 적중률 이력

30+ .jsonl (이벤트 로그)

semiconductor_2026, energy_2026, defense_2026, macro_2026, crypto_2026 등 섹터별 시계열 축적

5. HTML 리포트 생성

report-generator (종목분석)

report_template.py + chart_templates.py 호출
차트 6종: radar, bar, line, heatmap, price_range, donut
출력: reports/*.html (135건)

briefing-report-generator (브리핑)

reference/briefing_css.html CSS 복사 (즉흥 생성 금지)
11종 template (morning/evening/weekly/crypto 등)
출력: reports/briefing/*.html (96건)

6. 빌드 파이프라인

test (34 unit) -> F&G / FRED / Insider 페치 -> manifest 빌드 -> KB / Research KPI / DailyPick / Search 빌드 -> sync_portfolio + health_check -> astro build (144 pages)

7. 웹 대시보드 (Astro + Supabase)

페이지 라우트

경로	내용
/	메인 대시보드 (위젯 16종 + DailyPick)
/stocks	전체 종목 카드 목록
/stocks/[ticker]	개별 종목 상세 (리포트 임베드)
/briefing/[type]	브리핑 타입별 목록 (morning/evening/weekly 등 9종)
/analyst	애널리스트 리포트 목록 + 스코어보드
/portfolio	사용자 포트폴리오 (Supabase 연동)
/research	리서치 KB 현황 + KPI
/compare	두 종목 비교 분석
/timemachine	과거 분석 시점 회고
/all	전체 리포트 통합 목록

위젯 16종

DailyPick

매일 추천 1건 + ATR 실시간 + 매수 모달

FearGreedGauge

CNN + Crypto F&G 게이지

MarketSnapshot

주요 지수/환율/채권 현황

MarketHeatmap

TradingView 히트맵 임베드

MacroIndicators

FRED 매크로 15종 시리즈

EconomicCalendar

이번 주 경제 일정

PerformanceDonut

분석 적중률 도넛 차트

HoldingsDonut

보유 자산 배분 시각화

TopHoldings

보유 종목 상위 목록

RecentReports

최근 종목분석 리포트

RecentAnalyst

최근 애널리스트 항목

StatCard

통계 카드 (종목/브리핑/적중률)

TypeCounts

리포트 유형별 건수

RecommendCloud

8. 데이터 소스 현황

소스	데이터	수집 주체	주기
yfinance	주가, 지수, 환율, 원자재, 크립토	data-collector, market-data-collector	브리핑/분석 시
DART API	공시, 재무제표	data-collector	종목분석 시
FRED API	매크로 15개 시리즈 (FFR, 10Y, CPI, 실업률 등)	fetch_fred.mjs	매 빌드
CNN / Alternative.me	Fear & Greed Index (주식 + 크립토)	fetch_fear_greed.mjs	매 빌드
openinsider.com	인사이더 클러스터 매수 (Form 4)	fetch_openinsider.mjs	매 빌드
Dataroma / SEC EDGAR	13F 거물 8인 포지션	market-data-collector	분기별
IB / 증권사	애널리스트 리포트 (PDF + 웹)	analyst-scraper	수동/스케줄
학술 / 씽크탱크	10섹터 1차 자료 (L1/L2/L3)	research-curator	주간/월간
웹검색 종합	뉴스, 산업 트렌드, 규제 변화	kb-updater, data-collector	수시
Supabase	포트폴리오, trade_log, 인증	sync_portfolio, DailyPick	매 빌드 + 실시간

9. 배포 및 자동화

배포 2채널

채널	역할	URL	갱신 방법
Vercel (본서버)	Astro + Supabase 풀 대시보드	stock-analyst-jungwon1.vercel.app	vercel --prod --yes
Cloudflare (미러)	정적 HTML 우회 호스팅	stock-analyst.pages.dev	bash scripts/deploy_cloudflare.sh

자동화

작업	방식	주기	상태
DailyPick 갱신	launchd (daily_pick_update.sh)	매일 KST 00:05	정상
모닝 브리핑	Claude Code 스케줄	매일 KST 07~10시	정상
이브닝 브리핑	Claude Code 스케줄	매일 KST 18~22시	정상
애널리스트 스크랩	Claude Code 스케줄	비정기	정상
재분석 자동 실행	수동 /재분석실행	비정기	수동

10. 전체 데이터 흐름

종목분석 파이프라인

사용자 /종목분석 -> stock-analyst-lead -> kb-updater (섹터 KB) -> data-collector (종목 데이터)

-> -> 5종 분석 에이전트 (병렬) -> scorecard-strategist -> report-generator (HTML)

-> -> git commit + push -> vercel + cloudflare deploy

브리핑 파이프라인

사용자 /이브닝브리핑 -> briefing-lead -> market-data-collector -> global-macro-analyst

-> -> correlation-monitor -> briefing-lead (분석 작성) -> briefing-report-generator (HTML)