Stock Market Pro - 주식 시장 전문 분석 스킬
Stock Market Pro는 Yahoo Finance 데이터를 활용해 전 세계 주식(미국, 한국), 암호화폐, 외환 시장을 실시간급으로 분석하는 전문 금융 스킬입니다. 개인 투자자부터 트레이더까지 다양한 사용자층을 대상으로 합니다.
핵심 기능
| 기능 | 설명 | 사용 예시 |
|------|------|-----------|
| 실시간 시세 | 현재가, 등락률, 거래량 조회 | `uv run --script scripts/yf price AAPL` |
| 전문 차트 | 이동평균선(5/20/60일) 포함 봉차트/라인차트 PNG 생성 | `uv run --script scripts/yf pro TSLA 6mo` |
| 펀더멘털 분석 | PER, EPS, ROE, 마켓캡 등 재무지표 표 제공 | `uv run --script scripts/yf fundamentals NVDA` |
| 실적 캘린더 | 다음 실적 발표일 및 컨센서스(Revenue/EPS) 확인 | `uv run --script scripts/yf earnings 005930.KS` |
| 히스토리 추세 | 최근 10거래일 데이터 + ASCII 터미널 차트 | `uv run --script scripts/yf history BTC-USD` |
현재 상태: 문서형 스킬 (설계 단계)
중요: 현재 버전은 실제 실행 가능한 코드 없이 Markdown 문서만 포함한 "문서형 스킬"입니다. uv run --script scripts/yf 명령어는 기능 설명용 예시이며, 실제 scripts/yf 스크립트 파일이 존재하지 않습니다. 사용자가 직접 Python 환경에 yfinance, mplfinance, rich 등의 라이브러리를 설치하고 유사한 기능을 구현해야 합니다.
장점
- 데이터 권위: Yahoo Finance는 전 세계적으로 신뢰받는 무료 금융 데이터 소스
- API 키 불필요: 공개 데이터 활용으로 별도 인증 없이 접근 가능
- 다자산 지원: 주식 + 암호화폐 + 외환 통합 분석
- 시각화 강점: 고해상도 차트 이미지 자동 생성
한계 및 주의사항
| 한계 | 설명 |
|------|------|
| **실제 코드 부재** | 현재 순수 문서로, 바로 실행 불가 |
| **Yahoo Finance 제약** | 무료 API는 호출 한도, 지연시간, 데이터 정확도에 한계 |
| **실시간성 한계** | "실시간급" 표현은 지연된 시세(15-20분)를 의미할 수 있음 |
| **투자 책임 소재** | 제공 정보는 참고용이며, 투자 결정의 법적 책임은 사용자에게 |
| **환경 의존성** | Python 3.11+, uv, 여러 라이브러리 설치 필요 |
적합한 사용자
- 직접 개발 가능한 개발자: 문서를 기반으로 직접 스크립트를 구현할 능력이 있는 Python 사용자
- 빠른 프로토타입 검증: yfinance 기반 분석 도구의 개념을 먼저 확인하려는 기획자
- 개인 포트폴리오 관리: 소규모 자산 추적용 맞춤 도구가 필요한 개인 투자자
권장 개선 방향
1. 실제 실행 파일 추가: scripts/yf Python 스크립트 구현
2. 에러 핸들링: 네트워크 실패, 잘못된 티커, 데이터 누락 등 처리 로직
3. 캐싱 메커니즘: Yahoo Finance 호출 빈도 제한 대응
4. 라이선스 명시: 오픈소스 프로토콜 정의 및 투자 면책 조항 추가
---
현재 상태: 설계 문서 단계 | 실제 사용 시 직접 개발 필요