Siglens

미국 주식 AI 기술적 분석 플랫폼

---

What Is Siglens?

Siglens는 복잡한 미국 주식 기술적 분석을 AI가 대신 처리해주는 분석 전용 서비스입니다.

이동평균, MACD, RSI, 볼린저 밴드, DMI, 캔들 패턴, 차트 패턴처럼 여러 지표를 동시에 해석해야 하는 작업을 자동화합니다. 사용자는 티커를 입력하면 차트, 인디케이터, AI 분석 리포트, 옵션 시장 해석, 뉴스/펀더멘털 요약을 한 화면에서 확인할 수 있습니다.

기존 방식    보조지표 수동 추가 -> 거래량 분석 -> 패턴 해석 -> 종합 판단
Siglens     티커 입력 -> 차트/지표 자동 렌더 -> AI 종합 분석 리포트

Siglens는 주문 기능을 제공하지 않습니다. 분석 정보만 제공하며, 투자 결정은 사용자 본인의 책임입니다.

Status

Siglens는 현재 siglens.io에서 정식 배포 중입니다.

Core Features

• 차트: Lightweight Charts v5 기반 캔들, 거래량, 보조지표 렌더링과 5분봉~일봉 멀티 타임프레임
• 인디케이터: RSI, MACD, 볼린저 밴드, ADX, DMI, Stochastic, StochRSI, CCI, VWAP, MA, EMA, Volume Profile, Ichimoku Cloud, ATR, Donchian/Keltner Channel, SuperTrend, OBV, CMF, MFI, Parabolic SAR, Williams %R, Squeeze Momentum, Smart Money Concepts 등
• 캔들/차트 패턴: 단일 캔들 15종, 멀티 캔들 30종, 헤드앤숄더, 쐐기, 이중천장/바닥, 삼각수렴, 플래그, 컵앤핸들 등 Skills 기반 감지
• AI 종합 분석: 기술적 분석, 펀더멘털, 뉴스, 공포탐욕, 옵션 시장을 통합한 한국어 리포트
• 옵션 분석: Max Pain, Put/Call Ratio, ATM IV, Implied Move, Strike별 Open Interest 분포 해석
• AI 모델 선택: Claude, Gemini, ChatGPT 모델을 페이지별로 선택
• BYOK: Anthropic, Google, OpenAI API Key를 사용자 계정에 암호화 저장해 자체 키로 호출
• 회원 기능: 비회원 기본 사용, 회원 가입 시 tier 기반 모델/한도/BYOK 기능 제공
• AI 챗봇: 분석 결과를 컨텍스트로 이어가는 자연어 후속 질문
• 시장 현황 대시보드: 11개 섹터 200+ 종목의 골든크로스, RSI 다이버전스, 볼린저 스퀴즈 스캔
• AI 백테스팅: 2024.04~2026.04 기간의 분석 결과 100건에 대한 실제 수익률 검증

Main Pages

경로	설명
/[symbol]	종목별 차트, 기술적 분석, AI 리포트
/[symbol]/fundamental	재무, 밸류에이션, 애널리스트 컨센서스 기반 펀더멘털 분석
/[symbol]/news	뉴스와 어닝 데이터 기반 분석
/[symbol]/fear-greed	종목별 공포탐욕 지수
/[symbol]/options	옵션 체인, OI 분포, Max Pain, IV 기반 분석
/[symbol]/overall	기술/펀더멘털/뉴스/옵션을 합친 종합 분석
/market	섹터별 시장 신호 대시보드
/backtesting	AI 분석 백테스팅 결과

Data Sources

데이터	출처	비고
시세 OHLCV	Financial Modeling Prep	5분봉~일봉 멀티 타임프레임, 최대 15분 지연
펀더멘털	FMP /stable API	PER, ROE, EPS, 컨센서스, 목표가
뉴스/어닝	FMP /stable API	뉴스 sentiment는 Gemini Flash-Lite로 자체 분석
옵션 체인	yahoo-finance2	스냅샷 기반 옵션 체인, OI, IV, Greeks

External Services

주요 외부 인프라 의존성은 다음과 같습니다.

서비스	용도
Vercel	Next.js 배포, Edge/Serverless 실행
Upstash	Redis 기반 분석 캐시, Job 상태, 이메일 토큰 저장
Neon	PostgreSQL 데이터베이스
Resend	이메일 인증과 비밀번호 재설정 메일 발송
Cloudflare	DNS, edge 보안, 캐시/트래픽 관리

Tech Stack

영역	기술
Framework	Next.js 16.2, App Router, Turbopack, React Compiler
UI	React 19.2, Tailwind CSS 4
Chart	Lightweight Charts v5, 자체 SVG 옵션 OI 차트
State	TanStack Query v5
AI	Anthropic Claude, Google Gemini, OpenAI ChatGPT
Auth	bcryptjs, Google OAuth, Kakao OAuth, 암호화 세션 쿠키
Database	Drizzle ORM, Neon PostgreSQL
Cache	Upstash Redis
Testing	Vitest, Testing Library, jsdom
Language	TypeScript 5
Package Manager	yarn 4.12.0
Runtime	Node.js 25.2.1
Deploy	Vercel, Cloudflare, Cloud Run worker

Quick Start

Prerequisites

Node.js 25.2.1
yarn 4.12.0

Installation

git clone https://github.com/y0ngha/siglens.git
cd siglens
yarn install

Environment

cp .env.example .env.local

필수 환경변수:

변수	발급처	용도
FMP_API_KEY	Financial Modeling Prep	시세, 종목, 펀더멘털, 뉴스 데이터
GEMINI_CHAT_API_KEY	Google AI Studio	Gemini 모델, 챗봇, 옵션 해석
ANTHROPIC_CHAT_API_KEY	Anthropic Console	Claude 모델
OPENAI_CHAT_API_KEY	OpenAI Platform	ChatGPT 모델
UPSTASH_REDIS_REST_URL / UPSTASH_REDIS_REST_TOKEN	Upstash	Redis 캐시와 Job 상태
DATABASE_URL	Neon	PostgreSQL
OAUTH_TOKEN_ENCRYPTION_KEY / LLM_API_KEY_ENCRYPTION_KEY	openssl rand -hex 32	DB 저장 토큰/API 키 암호화
CRON_SECRET	직접 생성	cron/action 보호용 bearer token

선택 환경변수:

변수	용도
GEMINI_CHAT_FREE_API_KEY	Gemini free quota fallback
TRANSLATE_API_KEY / TRANSLATE_FREE_API_KEY	한국어 종목명 번역
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	Google OAuth 로그인
KAKAO_REST_API_KEY / KAKAO_CLIENT_SECRET	Kakao OAuth 로그인
RESEND_API_KEY / EMAIL_FROM	이메일 발송
NEXT_PUBLIC_SITE_URL	사이트 canonical URL
NEXT_PUBLIC_ADSENSE_*	Google AdSense
SIGLENS_GITHUB_TOKEN	@y0ngha/siglens-core 설치용 GitHub Packages token
WORKER_URL / WORKER_SECRET	Cloud Run worker 호출

Development Server

yarn dev

http://localhost:4200 접속

Architecture

Siglens는 Feature-Sliced Design 6-layer 구조를 사용합니다.

app -> pages -> widgets -> features -> entities -> shared
                                                   ^
                           @y0ngha/siglens-core는 모든 레이어에서 직접 import 가능

siglens/
├── src/
│   ├── app/              Next.js App Router, RSC, Route Handler
│   ├── widgets/          차트, 분석 패널, 대시보드, 페이지 조합 UI
│   ├── features/         인증, 검색, 채팅, premium gate 등 사용자 기능
│   ├── entities/         user, session, bars, analysis, ticker 등 도메인 엔티티
│   └── shared/           공통 UI, config, db, email, api, hooks, lib
├── skills/               분석 기법 정의 Markdown
├── docs/                 아키텍처, 도메인, 컨벤션 문서
└── refs/                 보조지표와 투자 이론 레퍼런스

분석 도메인 로직의 본체는 @y0ngha/siglens-core 패키지에 있습니다. 이 패키지는 일반 외부 라이브러리가 아니라 Siglens 분석 로직을 분리한 코어 패키지이므로 모든 FSD 레이어에서 직접 import할 수 있습니다.

자세한 규칙은 ARCHITECTURE.md와 SCOPE.md를 참고하세요.

Skills System

분석 기법은 코드가 아니라 skills/ 디렉터리의 Markdown 파일로 정의합니다.

/skills/<category>/my-strategy.md 파일 추가 -> 새로운 분석 기법 적용

entities/skill이 Markdown 파일을 읽고, 파싱된 Skill 데이터가 @y0ngha/siglens-core의 프롬프트 빌더에 전달됩니다. 도메인 계산식을 수정하지 않고도 분석 기법을 추가하거나 보완할 수 있습니다.

현재 카테고리:

• skills/patterns/: 차트 패턴
• skills/indicators/: 보조지표 시그널 해석
• skills/strategies/: 엘리어트 파동, 대순환 분석 등
• skills/support-resistance/: 피보나치, 피봇포인트
• skills/candlesticks/: 캔들 패턴 교육
• skills/fundamental/: 가치, 성장, 퀄리티 투자 관점
• skills/news/: 이벤트 드리븐, 매크로 영향, 어닝 리액션

Documentation

문서	내용
SERVICE.md	서비스 개요, 대상 사용자, 기술 스택, Skills 시스템
ARCHITECTURE.md	FSD 레이어 구조, 의존성 규칙, 데이터 흐름
SCOPE.md	siglens와 siglens-core의 책임 분리
AUTH.md	인증, 세션, OAuth, 이메일 토큰 흐름
DOMAIN.md	인디케이터 계산 명세, 캔들 패턴, Skills 시스템
API.md	데이터/AI API와 환경변수
CONVENTIONS.md	코딩 컨벤션, 네이밍, 테스트 정책
E2E.md	Playwright E2E 하니스 구조, 로컬/CI 실행, 스펙 작성 가이드
DESIGN.md	컬러 시스템, Tailwind 설정, 차트 컬러 상수
GIT_CONVENTIONS.md	브랜치, 커밋 메시지, PR 규칙
MISTAKES.md	반복 실수와 방지 규칙

Testing

yarn test                    # 전체 테스트
yarn test-watch              # watch
yarn test-coverage           # 커버리지 포함
yarn test-coverage-report    # 상세 커버리지 리포트

커버리지 목표는 전체 FSD 레이어 기준 90%입니다. 현재 Vitest 설정은 entities/, features/, shared/, widgets/, app/, src/proxy.ts를 커버리지 측정 대상으로 포함합니다.

실제 브라우저로 사용자 여정을 검증하는 Playwright E2E 스위트는 Vitest 위에 별도로 올라갑니다. 하니스 구조와 로컬/CI 실행 방법은 E2E.md를 참고하세요.

Commands

yarn dev               # 개발 서버, port 4200
yarn build             # 프로덕션 빌드
yarn lint              # ESLint
yarn lint:fix
yarn lint:style        # Stylelint
yarn lint:style-fix
yarn typecheck         # TypeScript
yarn format            # Prettier

패키지 설치는 항상 yarn을 사용합니다. npm과 pnpm은 사용하지 않습니다.

Contributing

아직 외부 코드 기여 프로세스는 정식으로 열려 있지 않습니다. 버그 리포트나 제안은 Issues로 남겨주세요.

Skills 기여도 아직 공개된 리뷰/머지 워크플로가 없습니다. skills/ 디렉터리에 Markdown 파일 하나를 추가하면 분석 기법을 확장할 수 있도록 설계되어 있지만, frontmatter 표준과 검증 절차가 정리된 뒤 기여 가이드를 공개할 예정입니다.

License

PolyForm Noncommercial License 1.0.0

---

Back to top