equity-research-agent은(는) 무엇을 하나요?
MCP 기반 주식 리서치 에이전트 — 세 개의 FastMCP 서버, Claude Code 스킬 및 독립형 CLI 모드를 통해 8개 섹션의 대화형 HTML 리서치 보고서를 생성합니다.
개요
이 에이전트는 FastMCP 프로토콜을 사용하여 주식 리서치를 자동화합니다. 세 개의 전문화된 서버가 각각 데이터 수집, 분석 및 보고서 생성을 담당하며, Claude Code 스킬과 독립형 CLI 모드를 모두 지원합니다.
주요 기능
- 8개 섹션 HTML 보고서: 개요, 재무 분석, 경쟁사 비교, 위험 평가, 기술적 분석, 뉴스 요약, 투자 의견, 부록
- 대화형 시각화: 차트, 표 및 필터 가능한 데이터
- 멀티 플랫폼 지원: Claude Code, Cursor, Codex 및 모든 MCP 호환 클라이언트
- CLI 모드: 단일 명령어로 전체 리서치 파이프라인 실행
필수 조건
- Python 3.10+
- FastMCP (
pip install fastmcp) - Claude Code (선택 사항)
빠른 시작
-
서버 시작
python server_data.py python server_analysis.py python server_report.py -
CLI 실행
python cli_agent.py --ticker AAPL -
Claude Code 스킬 사용
Claude Code 내에서 다음 명령어를 사용하세요:
/skill equity-research-agent --ticker MSFT
서버 개요
| 서버 | 포트 | 역할 |
|---|---|---|
server_data | 8001 | 재무 데이터 및 뉴스 수집 |
server_analysis | 8002 | 분석 및 지표 계산 |
server_report | 8003 | HTML 보고서 생성 |
구성
환경 변수는 .env 파일에 설정하세요:
ALPHA_VANTAGE_KEY=your_key_here
NEWS_API_KEY=your_key_here
OPENAI_API_KEY=your_key_here
출력 예시
보고서는 reports/ 디렉토리에 저장됩니다.
<!-- reports/AAPL_2024-01-01.html -->
라이선스
MIT