stock-briefing-cli

투자 성향(공격형/안정형)에 맞는 일일 주식 브리핑 CLI.

• 기술적 지표: 이동평균(MA5/20/60/120), 골든·데드크로스, 볼린저밴드, 이격도, 캔들패턴, 거래량
• 재무 건전성: 유동비율, 부채비율, ROE, 영업현금흐름 (A~D 등급)
• 뉴스: Google News RSS 실시간 수집
• AI 시그널: Upstage Solar Pro 3 — 강매수/매수/주목/관망/매도/강매도

설치

npm install -g stock-briefing-cli

요구사항: Node.js 14+, Python 3 (/opt/anaconda3/bin/python3)

Python 경로가 다르면 환경변수로 지정:

export STOCK_BRIEFING_PYTHON=/usr/bin/python3

Python 패키지 설치 (최초 1회):

pip install yfinance requests

사용법

1. 투자 프로필 설정 (최초 1회)

stock-briefing setup

• 투자 성향 선택: 공격형 / 안정형
• 관심 종목 입력 (국내: 005930, 해외: AAPL)
• 급변 알림 임계값 설정 (기본 5%)

2. 일일 브리핑

stock-briefing run

출력 예시:

조회 중... 삼성전자 (005930.KS)
  🔴📈  75,400원  ▲2.31%
  MA: 정배열  [골든크로스]  |  볼린저: 중간(52%)
  이격도: 101.2 → 보통  |  추세: 상승
  거래량: 급증🔥 (평균 2.3배)
  캔들: 상승장악형(매수)
  📰  삼성전자, HBM4 공급 계약 체결...

[005930.KS | 삼성전자]
🎯 매매 전략 (공격형)
시그널: 강매수
핵심 근거:
  1. 골든크로스 + 정배열로 기술적 상승 신호 확인
  2. 거래량 급증(2.3배)으로 모멘텀 강화
  3. HBM4 공급 계약 체결로 실적 개선 기대
주의사항: 볼린저 상단(78,000원) 근접 시 단기 차익실현 고려

3. 급변 알림 체크

stock-briefing alert

관심 종목 중 설정한 임계값 이상 급등·급락한 종목을 즉시 감지하고 AI 긴급 분석을 출력합니다.

AI 시그널 설정 (선택)

export UPSTAGE_API_KEY=your_api_key_here

API 키 없이도 주가·기술적 지표·뉴스 조회는 동작합니다. AI 시그널만 비활성화됩니다.

지원 종목

| 시장 | 형식 | 예시 | |------|------|------| | KOSPI | 숫자 6자리 입력 시 자동 .KS | 005930 → 005930.KS | | KOSDAQ | 숫자 6자리 입력 시 자동 .KQ 선택 가능 | 035720 → 035720.KQ | | 미국 | 티커 그대로 | AAPL, NVDA, TSLA | | ETF | 티커 그대로 | SPY, QQQ, 360750.KS |

데이터 저장 위치

~/.stock-briefing/
└── data/
    ├── profile.json    ← 투자 프로필 & 관심 종목
    └── cache/          ← 캐시

환경변수 STOCK_BRIEFING_DATA_DIR로 변경 가능.

옵션

stock-briefing --help     도움말
stock-briefing --version  버전 확인

라이선스

MIT