🤖 StockAI: OpenAI, Claude, DeepSeek 및 로컬 LLM을 지원하는 AI 기반 StockAI 뉴스 분석기를 만들었습니다

StockAI란 무엇인가요?

StockAI는 Tauri 2, React 19, Bun, 그리고 Playwright로 구축된 크로스 플랫폼 데스크톱 애플리케이션입니다. 실시간 주식 뉴스(미국 주식 + 중국 A주)를 스크래핑하고, 사용자가 선택한 LLM(대규모 언어 모델)을 통해 기사를 분석하며, 인터랙티브한 K-line(캔들스틱) 차트와 함께 깔끔한 감성 분석(Sentiment Analysis) 대시보드를 제공합니다.

구독료도 없고 데이터 유출도 없는, 100% 로컬에서 실행되는 개인용 AI 금융 분석가라고 생각하시면 됩니다. 오직 통찰력(Insights)만 제공합니다.

🌟 주요 기능

1. 플러그인 방식의 AI 제공업체 — 드롭다운으로 전환

StockAI는 기본적으로 5가지 AI 제공업체를 지원합니다:

• OpenAI (GPT-4o 및 관련 모델)
• Anthropic (Claude 3.5 Sonnet)
• DeepSeek (DeepSeek V4 Pro)
• GLM (GLM-5.1)
• Ollama (Llama 3, Mistral, Qwen 등 모든 로컬 모델)

각 제공업체는 자체적인 API 키, 베이스 URL(Base URL), 모델 선택 정보를 저장합니다. 단일 드롭다운을 통해 이들 사이를 전환할 수 있습니다. 그리고 중요한 점은: 분석이 명시적으로 트리거된다는 것입니다. 즉, 주식을 변경한다고 해서 토큰이 조용히 소모되지 않습니다.

2. 실시간 뉴스 스크래핑

뉴스는 Google News RSS를 통해 가져옵니다 (대부분의 주식에 대해 무거운 Chromium 부팅이 필요하지 않습니다). RSS로 충분하지 않은 경우, 더 깊은 스크래핑을 위해 Playwright가 폴백(Fallback)으로 작동합니다.

지원 대상:

• 미국 주식 (NYSE, NASDAQ)
• 중국 A주: 상하이(SH), 선전(SZ), 베이징(BJ) 증권거래소

3. 인터랙티브 K-Line 차트 (Lightweight Charts 기반)

중앙 패널에는 다음과 같은 기능을 갖춘 풀 피처(Full-featured) 캔들스틱 차트가 포함되어 있습니다:

• MA / BOLL 오버레이
• 9가지 시간 범위: 1D / 5D / 1M / 3M / 6M / YTD / 1Y / 5Y / All
• 보조 차트 지표: MACD, RSI, KDJ, OBV, VWAP
• 로그 스케일(Logarithmic scale), 배당 조정 가격
• 거래 시간 동안 마지막 캔들에 실시간 가격 병합

4. 3열 대시보드 레이아웃

다크 테마 UI는 세 개의 열로 나뉩니다:

• 왼쪽 (Left): 빠른 추가 입력 기능이 포함된 관심 종목 (Watchlist) 사이드바 (세션 간 유지됨)
• 중앙 (Center): 주식 상세 패널 — 실시간 가격 카드, K-선 차트 (K-line chart), 뉴스 피드
• 오른쪽 (Right): AI 분석 패널 — 감성 비율 바 (Sentiment ratio bar), 기업 프로필, 색상으로 구분된 강세/약세 (Bullish/Bearish) 요인 카드

5. 로컬 우선 개인정보 보호 (Local-First Privacy)

모든 API 키, 관심 종목, 설정은 사용자의 로컬 기기에 저장됩니다. 그 어떤 데이터도 StockAI 서버로 전송되지 않습니다 (StockAI 서버는 존재하지 않습니다).

6. 딥 모드 (Deep Mode)

"딥 모드 (Deep Mode)"를 활성화하면 스크레이퍼 (Scraper)가 헤드라인뿐만 아니라 **기사 전문 (Full article content)**을 추출하여, LLM이 더 풍부한 감성 분석 (Sentiment analysis)을 수행할 수 있도록 훨씬 더 많은 문맥 (Context)을 제공합니다.

🏗️ 아키텍처 (Architecture)

StockAI는 엄격한 단방향 의존성 흐름을 가진 **클린 아키텍처 (Clean Architecture)**를 따릅니다:

UI (React + TypeScript + Vite)
    ↓
Core Orchestration (Tauri / Rust)
...

Bun 사이드카 (Sidecar)는 독립 실행형 바이너리로 컴파일되어 Tauri의 사이드카 메커니즘에 의해 관리됩니다. 이를 통해 프론트엔드의 속도를 유지하면서 무거운 스크레이핑 (Scraping) 및 AI 작업을 격리합니다.

🚀 시작하기

다운로드 (권장)

macOS, Windows, Linux용 사전 빌드된 바이너리는 Releases 페이지에서 확인할 수 있습니다.

macOS 사용자: "손상된 앱" 메시지가 나타난다면 이는 단순한 Gatekeeper 문제입니다. 다음을 실행하세요:

xattr -cr /Applications/StockAI.app

Windows 사용자: SmartScreen 대화 상자에서 "추가 정보 → 실행"을 클릭하세요.

소스에서 빌드하기

# 필수 요구 사항: Bun + Rust

# 1. 의존성 설치
...

🛠️ 기술 스택 (Tech Stack)

계층 (Layer)	기술 (Technology)
데스크톱 셸 (Desktop Shell)	Tauri 2.0 (Rust)
...

💡 제작 동기

AI와 시장 모두에 관심이 있는 사람으로서, 분산된 워크플로우(Workflow)에 답답함을 느꼈습니다. 뉴스 사이트를 열고, 기사를 몇 개 읽고, 감성을 파악하려 애쓰고, 다른 탭에서 차트를 확인해야 했습니다. StockAI는 이 모든 것을 하나의 깔끔한 데스크톱 앱에 담았습니다.

또한 저는 특정 업체에 종속되지 않는 (vendor lock-in 없는) 무언가를 원했습니다. 만약 OpenAI의 가격이 인상된다면, 아무런 마찰 없이 로컬 Ollama 모델로 전환할 수 있어야 하기 때문입니다.

🤝 기여하기 (Contributing)

이 프로젝트는 MIT 라이선스 (MIT License) 하에 완전히 오픈 소스로 운영됩니다. 기여(Contributions), 이슈(Issues), 그리고 스타(Stars)는 언제나 환영합니다!

👉 GitHub: https://github.com/hyhmrright/StockAI

새로운 AI 제공업체를 추가하거나, 스크래핑 (scraping) 범위를 개선하거나, 더 많은 차트 지표 (chart indicators)를 추가하거나, 혹은 단순히 오타를 수정하는 것 등 무엇이든 좋습니다. Pull Request (PR)는 언제나 환영합니다. 코드베이스가 깔끔하고 잘 구조화되어 있어 쉽게 참여하실 수 있습니다.

다음 단계는 무엇인가요? (What's Next?)

로드맵에 대한 몇 가지 아이디어입니다:

• 가격 알림 (Price alert) 알림 (이미 진행 중!)
• 배치 정량 스캐닝 (batch quant scanning) 기능이 포함된 주식 스크리너 (Stock screener)
• 더 많은 거래소 지원 (유럽, 일본)
• 포트폴리오 추적 (Portfolio tracking) 통합

StockAI가 유용하다고 느끼신다면 GitHub에 ⭐를 남겨주세요. 프로젝트가 성장하는 데 큰 도움이 됩니다. 또한, 이를 활용해 무언가를 만드셨거나 피드백이 있다면 아래 댓글로 알려주세요!

즐거운 트레이딩 되시길 바랍니다 📈

💬 여러분께 드리는 짧은 질문: StockAI와 함께 어떤 AI 제공업체를 사용하고 싶으신가요 — OpenAI, Claude, DeepSeek, 아니면 로컬 Ollama 모델인가요? 그리고 어떤 주식 시장에 가장 관심이 있으신가요 (미국, 중국, 혹은 다른 곳)? 댓글로 남겨주세요 — 여러분의 답변이 다음 기능을 결정할 수도 있습니다!