[![CI](https://github.com/dragon1086/prism-insight/actions/workflows/ci.yml/badge.svg)](https://github.com/dragon1086/prism-insight/actions/workflows/ci.yml) [![Codacy Badge](https://app.codacy.com/project/badge/Grade/2f8fd766b0634c068ff9da57ccda00c6)](https://app.codacy.com/gh/dragon1086/prism-insight/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) # PRISM-INSIGHT [![GitHub Sponsors](https://img.shields.io/github/sponsors/dragon1086?style=for-the-badge&logo=github-sponsors&color=ff69b4&label=Sponsors)](https://github.com/sponsors/dragon1086) [![Stars](https://img.shields.io/github/stars/dragon1086/prism-insight?style=for-the-badge)](https://github.com/dragon1086/prism-insight/stargazers) > **AI 기반 주식시장 분석 및 매매 시스템** > > 13개 이상의 전문화된 AI 에이전트가 협업하여 급등주를 포착하고, 애널리스트급 리포트를 생성하며, 자동으로 매매를 실행합니다.

English | 한국어 | 日本語 | 中文 | Español

--- ### 플래티넘 스폰서

**[AI3](https://www.ai3.kr/) | [WrksAI](https://wrks.ai/ko)** 직장인을 위한 AI 비서 **웍스AI**를 만드는 **AI3**가
투자자를 위한 AI 비서 **PRISM-INSIGHT**를 후원합니다.

--- ## 신기능: ChatGPT Plus/Pro 구독으로 바로 사용 **API 키 없어도 됩니다.** PRISM-INSIGHT는 이제 ChatGPT Plus($20/월) 또는 Pro($200/월) 구독을 통해 **Codex OAuth 프록시** 방식으로 분석을 직접 실행할 수 있습니다. ```bash # 최초 1회 로그인 (브라우저가 자동으로 열려 ChatGPT 인증 진행) python -m cores.chatgpt_proxy.oauth_login # 재인증이 필요할 때 (계정 변경, 토큰 만료 등) python -m cores.chatgpt_proxy.oauth_login --force # ChatGPT 구독으로 실행 PRISM_OPENAI_AUTH_MODE=chatgpt_oauth python stock_analysis_orchestrator.py --mode morning ``` > 토큰은 백그라운드에서 자동 갱신되므로, ChatGPT 계정을 바꾸거나 비밀번호를 변경한 경우에만 다시 로그인하면 됩니다. API 요금 0원. 동일한 강력한 분석. 기존 구독으로 충분합니다. --- ## 모바일 앱

**AI 주식 분석을 언제 어디서나**

- **스마트 필터링** — 원하는 텔레그램 알림만 선별해서 받기 - **PDF 리포트** — 모바일 최적화 AI 분석 리포트 - **출시 프로모션 (2026년 4월 23일까지)** — 지금 설치하면 **20 크레딧 무료 제공** (기본 10크레딧) --- ## PRISM-INSIGHT 홍보영상 [![PRISM-INSIGHT 소개영상](https://img.youtube.com/vi/zAywb1G0wRA/maxresdefault.jpg)](https://www.youtube.com/watch?v=zAywb1G0wRA) --- ## 바로 체험하기 (설치 없이) ### 1. 라이브 대시보드 AI 매매 성과를 실시간으로 확인하세요: **[analysis.stocksimulation.kr](https://analysis.stocksimulation.kr/)** ### 2. 텔레그램 채널 매일 급등주 알림과 AI 분석 리포트를 받아보세요: - **[한국 채널](https://t.me/stock_ai_agent)** - **[영어 채널](https://t.me/prism_insight_global_en)** - **[일본어 채널](https://t.me/prism_insight_ja)** - **[중국어 채널](https://t.me/prism_insight_zh)** - **[스페인어 채널](https://t.me/prism_insight_es)** ### 3. 샘플 리포트 AI가 생성한 Apple Inc. 분석 리포트를 확인하세요: [![샘플 리포트 - Apple Inc. 분석](https://img.youtube.com/vi/LVOAdVCh1QE/maxresdefault.jpg)](https://youtu.be/LVOAdVCh1QE) --- ## 60초 안에 체험하기 (미국 주식) PRISM-INSIGHT를 가장 빠르게 체험하는 방법입니다. **OpenAI API 키**만 있으면 됩니다. ```bash # 클론 후 퀵스타트 스크립트 실행 git clone https://github.com/dragon1086/prism-insight.git cd prism-insight ./quickstart.sh YOUR_OPENAI_API_KEY ``` Apple(AAPL)의 AI 분석 리포트가 생성됩니다. 다른 종목도 분석해보세요: ```bash python3 demo.py MSFT # Microsoft python3 demo.py NVDA # NVIDIA python3 demo.py TSLA --language ko # Tesla (한국어 리포트) ``` > **OpenAI API 키 발급**: [OpenAI Platform](https://platform.openai.com/api-keys) > > **선택사항**: 뉴스 분석을 위해 [Perplexity API 키](https://www.perplexity.ai/)를 `mcp_agent.config.yaml`에 추가하세요 AI가 생성한 PDF 리포트는 `prism-us/pdf_reports/`에 저장됩니다.

또는 Docker로 실행 (Python 설치 불필요)

```bash # 1. OpenAI API 키 설정 export OPENAI_API_KEY=sk-your-key-here # 2. 로컬 quickstart 이미지 빌드 및 시작 docker compose -f docker-compose.quickstart.yml up --build -d # 3. 분석 실행 docker exec -it prism-quickstart python3 demo.py NVDA ``` 첫 실행 시 이미지를 로컬에서 빌드하므로 몇 분 정도 걸릴 수 있습니다. 리포트는 `./quickstart-output/`에 저장됩니다.

--- ## 전체 설치 ### 사전 요구사항 - Python 3.10+ 또는 Docker - OpenAI API 키 ([여기서 발급](https://platform.openai.com/api-keys)) 또는 ChatGPT Plus/Pro 구독 ### 옵션 A: Python 설치 ```bash # 1. 클론 & 설치 git clone https://github.com/dragon1086/prism-insight.git cd prism-insight pip install -r requirements.txt # 2. Playwright 설치 (PDF 생성용) python3 -m playwright install chromium # 3. perplexity-ask MCP 서버 설치 cd perplexity-ask && npm install && npm run build && cd .. # 4. 설정 cp mcp_agent.config.yaml.example mcp_agent.config.yaml cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml # mcp_agent.secrets.yaml에 OpenAI API 키 입력 # mcp_agent.config.yaml에 KRX 인증 정보 입력 (카카오 계정) # 5. 분석 실행 (텔레그램 설정 불필요!) python stock_analysis_orchestrator.py --mode morning --no-telegram ``` ### 옵션 B: Docker (프로덕션 권장) ```bash # 1. 클론 & 설정 git clone https://github.com/dragon1086/prism-insight.git cd prism-insight cp mcp_agent.config.yaml.example mcp_agent.config.yaml cp mcp_agent.secrets.yaml.example mcp_agent.secrets.yaml # 설정 파일에 API 키 입력 # 2. 빌드 & 실행 docker compose up -d # 3. 수동 분석 실행 (선택) docker exec prism-insight-container python3 stock_analysis_orchestrator.py --mode morning --no-telegram ``` **전체 설치 가이드**: [docs/SETUP_ko.md](docs/SETUP_ko.md) --- ## PRISM-INSIGHT란? PRISM-INSIGHT는 **한국 (코스피/코스닥)** 및 **미국 (NYSE/NASDAQ)** 시장을 위한 **완전 오픈소스, 무료** AI 주식 분석 시스템입니다. ### 핵심 기능 - **급등주 포착** — 비정상적인 거래량/가격 움직임을 보이는 종목 자동 탐지 - **AI 분석 리포트** — 13개 전문 AI 에이전트가 생성하는 전문가급 리포트 - **매매 시뮬레이션** — 포트폴리오 관리와 함께 AI 기반 매수/매도 결정 - **자동매매** — 한국투자증권 API를 통한 실제 매매 실행 - **텔레그램 통합** — 실시간 알림 및 다국어 브로드캐스팅 - **거시경제 인텔리전스** — 시장 국면 판단, 섹터 로테이션 분석, 리스크 이벤트 모니터링 ### AI 모델 - **분석 및 매매**: OpenAI GPT-5 / GPT-5.4-mini (API 또는 ChatGPT Plus 구독) - **리포트 생성**: Anthropic Claude Sonnet 4.6 - **번역**: OpenAI GPT-5 (영어, 일본어, 중국어, 스페인어 지원) --- ## AI 에이전트 시스템 13개 이상의 전문 에이전트가 팀으로 협업합니다: | 팀 | 에이전트 | 역할 | |---|---------|------| | **거시경제 팀** | 1개 | 시장 국면, 섹터 로테이션, 리스크 이벤트 | | **분석 팀** | 6개 | 기술적, 재무, 산업, 뉴스, 시장 분석 | | **전략 팀** | 1개 | 투자 전략 수립 | | **커뮤니케이션 팀** | 3개 | 요약, 품질 평가, 번역 | | **매매 팀** | 3개 | 매수/매도 결정, 매매 저널 | | **상담 팀** | 2개 | 텔레그램을 통한 사용자 상호작용 |

에이전트 워크플로우 다이어그램 보기

**상세 에이전트 문서**: [docs/CLAUDE_AGENTS_ko.md](docs/CLAUDE_AGENTS_ko.md) --- ## 주요 기능 | 기능 | 설명 | |-----|------| | **AI 분석** | GPT-5 다중 에이전트 시스템을 통한 전문가급 주식 분석 | | **급등주 포착** | 오전/오후 시장 트렌드 분석을 통한 자동 관심종목 선별 | | **텔레그램** | 채널로 실시간 분석 배포 | | **매매 시뮬레이션** | AI 기반 투자 전략 시뮬레이션 | | **자동매매** | 한국투자증권 API를 통한 실행 | | **대시보드** | 투명한 포트폴리오, 거래내역, 성과 추적 | | **자기개선 매매** | 매매 일지 피드백 루프 — 과거 트리거 승률이 자동으로 미래 매수 결정에 반영 ([상세](docs/TRADING_JOURNAL.md#performance-tracker-피드백-루프-self-improving-trading)) | | **미국 시장** | NYSE/NASDAQ 분석 완벽 지원 | | **거시경제 인텔리전스** | 시장 국면 판단 및 섹터 로테이션으로 더 스마트한 종목 선정 | | **모바일 앱** | iOS & Android 앱, 스마트 필터링 및 PDF 리포트 |

대시보드 스크린샷 보기

--- ## 매매 실적 ### 한국 시장 — 시즌 2 | 지표 | 값 | |-----|---| | 기간 | 2025.09.30 ~ 2026.03.24 | | 총 거래 | 86건 | | 승률 | 45.35% | | 거래당 평균 수익률 | +2.84% | | **누적 수익률** | **+244.63%** | | 현재 보유 종목 | 5종목 | ### 미국 시장 (베타) | 지표 | 값 | |-----|---| | 기간 | 2026.01.28 ~ 2026.03.21 | | 총 거래 | 13건 | | 현재 보유 종목 | 6종목 | **[라이브 대시보드](https://analysis.stocksimulation.kr/)** --- ## 미국 주식 모듈 미국 시장을 위한 동일한 AI 기반 워크플로우: ```bash # 미국 주식 분석 실행 python prism-us/us_stock_analysis_orchestrator.py --mode morning --no-telegram # 영어 리포트로 실행 python prism-us/us_stock_analysis_orchestrator.py --mode morning --language en ``` **데이터 소스**: yahoo-finance-mcp, sec-edgar-mcp (SEC 공시, 내부자 거래) --- ## 문서 | 문서 | 설명 | |-----|------| | [docs/SETUP_ko.md](docs/SETUP_ko.md) | 완전한 설치 가이드 | | [docs/CLAUDE_AGENTS.md](docs/CLAUDE_AGENTS.md) | AI 에이전트 시스템 상세 | | [docs/TRIGGER_BATCH_ALGORITHMS.md](docs/TRIGGER_BATCH_ALGORITHMS.md) | 급등주 탐지 알고리즘 | | [docs/TRADING_JOURNAL.md](docs/TRADING_JOURNAL.md) | 매매 메모리 시스템 | --- ## 프론트엔드 예제 ### 대시보드 실시간 포트폴리오 추적 및 성과 대시보드입니다. **[라이브 데모](https://analysis.stocksimulation.kr/)** ```bash cd examples/dashboard npm install npm run dev # http://localhost:3000 접속 ``` **기능**: 포트폴리오 개요, 매매 내역, 성과 지표, 마켓 선택기 (한국/미국), KOSPI/KOSDAQ 대비 수익률 비교 **대시보드 설정 가이드**: [examples/dashboard/DASHBOARD_README.md](examples/dashboard/DASHBOARD_README.md) --- ## MCP 서버 ### 한국 시장 - **[kospi_kosdaq](https://github.com/dragon1086/kospi-kosdaq-stock-server)** — KRX 주식 데이터 - **[firecrawl](https://github.com/mendableai/firecrawl-mcp-server)** — 웹 크롤링 - **[perplexity](https://github.com/perplexityai/modelcontextprotocol)** — 웹 검색 - **[sqlite](https://github.com/modelcontextprotocol/servers-archived)** — 매매 시뮬레이션 DB ### 미국 시장 - **[yahoo-finance-mcp](https://pypi.org/project/yahoo-finance-mcp/)** — OHLCV, 재무제표 - **[sec-edgar-mcp](https://pypi.org/project/sec-edgar-mcp/)** — SEC 공시, 내부자 거래 --- ## 기여하기 1. 프로젝트를 포크합니다 2. 기능 브랜치를 생성합니다 (`git checkout -b feature/멋진기능`) 3. 변경사항을 커밋합니다 (`git commit -m '멋진 기능 추가'`) 4. 브랜치에 푸시합니다 (`git push origin feature/멋진기능`) 5. Pull Request를 생성합니다 --- ## 라이선스 **이중 라이선스:** ### 개인 및 오픈소스 사용 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0) 개인 사용, 비상업적 프로젝트, 오픈소스 개발에 AGPL-3.0으로 무료 사용 가능합니다. ### 상업적 SaaS 사용 SaaS 기업은 별도의 상업 라이선스가 필요합니다. **연락처**: dragon1086@naver.com **상세**: [LICENSE-COMMERCIAL-ko.md](LICENSE-COMMERCIAL-ko.md) --- ## 면책 조항 분석 정보는 참고용이며 투자 권유가 아닙니다. 모든 투자 결정과 그에 따른 손익은 투자자 본인의 책임입니다. --- ## 후원 ### 프로젝트 지원 월간 운영 비용 (~$310/월): - OpenAI API: ~$235/월 - Anthropic API: ~$11/월 - Firecrawl + Perplexity: ~$35/월 - 서버 인프라: ~$30/월 현재 450명 이상이 무료로 사용하고 있습니다.

--- ## 프로젝트 성장 [![Star History Chart](https://api.star-history.com/svg?repos=dragon1086/prism-insight&type=Date)](https://star-history.com/#dragon1086/prism-insight&Date) --- **이 프로젝트가 도움이 되었다면 Star를 눌러주세요!** **문의**: [GitHub Issues](https://github.com/dragon1086/prism-insight/issues) | [텔레그램](https://t.me/stock_ai_agent) | [디스커션](https://github.com/dragon1086/prism-insight/discussions)