포트폴리오 매니저은(는) 무엇을 하나요?
개요
Alpaca MCP 서버와 통합하여 실시간 보유 데이터를 가져온 후 자산 배분, 다각화, 위험 지표, 개별 포지션 평가, 리밸런싱 추천을 포함한 종합적인 분석을 수행합니다. 실행 가능한 인사이트가 포함된 상세 포트폴리오 보고서를 생성합니다.
이 스킬은 Alpaca의 중개 API를 MCP(Model Context Protocol)를 통해 활용하여 라이브 포트폴리오 데이터에 접근하므로, 수동으로 입력한 데이터가 아닌 실제 현재 포지션을 기반으로 분석을 수행합니다.
사용 시기
사용자가 다음을 요청할 때 이 스킬을 호출하세요:
- "내 포트폴리오 분석해줘"
- "내 현재 포지션 검토해줘"
- "내 자산 배분은 어떻게 되나요?"
- "내 포트폴리오 위험 확인해줘"
- "포트폴리오 리밸런싱을 해야 할까요?"
- "내 보유 종목 평가해줘"
- "포트폴리오 성과 검토"
- "어떤 주식을 사거나 팔아야 할까요?"
- 포트폴리오 수준의 분석이나 관리를 포함한 모든 요청
전제 조건
Alpaca MCP 서버 설정
이 스킬을 사용하려면 Alpaca MCP 서버가 구성 및 연결되어 있어야 합니다. MCP 서버는 다음에 대한 접근을 제공합니다:
- 현재 포트폴리오 포지션
- 계좌 자기자본 및 구매력
- 과거 포지션 및 거래 내역
- 보유 증권의 시장 데이터
사용되는 MCP 서버 도구:
get_account_info- 계좌 자기자본, 구매력, 현금 잔고 가져오기get_positions- 모든 현재 포지션의 수량, 원가 기준, 시장 가치 검색get_portfolio_history- 과거 포트폴리오 성과 데이터- 가격 호가 및 펀더멘털을 위한 시장 데이터 도구
Alpaca MCP 서버가 연결되어 있지 않은 경우, 사용자에게 알리고 references/alpaca_mcp_setup.md의 설정 지침을 제공하세요.
워크플로
1단계: Alpaca MCP 또는 REST 대체를 통해 포트폴리오 데이터 가져오기
가능한 경우 Alpaca MCP 서버 도구를 사용하여 현재 포트폴리오 정보를 수집하세요. 예약된 Hermes 작업에서는 Alpaca 자격 증명이 있어도 MCP 도구가 노출되지 않을 수 있습니다. 이 경우 ALPACA_API_KEY, ALPACA_SECRET_KEY, ALPACA_PAPER와 함께 Alpaca REST API를 직접 사용하세요.
1.1 계좌 정보 가져오기:
권장: mcp__alpaca__get_account_info를 사용하여 다음 가져오기:
- 계좌 자기자본 (총 포트폴리오 가치)
- 현금 잔고
- 구매력
- 계좌 상태
대체 REST 엔드포인트:
- paper: https://paper-api.alpaca.markets/v2/account
- live: https://api.alpaca.markets/v2/account
헤더:
- APCA-API-KEY-ID=$ALPACA_API_KEY
- APCA-API-SECRET-KEY=$ALPACA_SECRET_KEY
1.2 현재 포지션 가져오기:
권장: mcp__alpaca__get_positions를 사용하여 모든 보유 종목 가져오기:
- 심볼 티커
- 보유 수량
- 평균 진입 가격 (원가 기준)
- 현재 시장 가격
- 현재 시장 가치
- 미실현 손익 ($ 및 %)
- 포트폴리오 대비 포지션 비중 (%)
대체 REST 엔드포인트:
- paper: https://paper-api.alpaca.markets/v2/positions
- live: https://api.alpaca.markets/v2/positions
1.3 포트폴리오 히스토리 가져오기 (선택 사항):
권장: mcp__alpaca__get_portfolio_history를 성과 분석에 사용:
- 과거 자기자본 가치
- 시간 가중 수익률 계산
- 하락 분석
대체 REST 엔드포인트:
- /v2/account/portfolio/history
스케줄링 작업 대체 규칙:
- 소스를 MCP 대신
Alpaca REST fallback으로 명확하게 표시하세요. ALPACA_PAPER=true를 사용하여 페이퍼 엔드포인트를 선택하고, 그렇지 않으면 라이브 엔드포인트를 사용하세요.- 장기 시장 가치와 현금이 대략 계좌 자기자본과 일치하는지 계속 확인하고,
long_market_value > equity인 경우 마진/레버리지를 강조하세요. - 주간 핵심 포트폴리오 크론 작업의 경우, 자기자본과 총 시장 가치를 분모로 노출도를 계산하세요:
gross_long_exposure = long_market_value / equity,cash_pct = cash / equity, 총 노출도가 실질적으로 100%를 초과하거나 현금이 음수인 경우 마진 자금 조달 포트폴리오를 명시적으로 플래그하세요. 계정이 레버리지 상태일 때 총 롱 분모만 사용하여 섹터 비중이 양호해 보이지 않도록 하세요. - 요청에서 배당 보유 종목이나 강제 검토 트리거를 강조하는 경우, 라이브 보유 종목에서 정규화된 모니터 입력을 구축하여 내러티브 전용 섹션으로 취급하지 말고
kanchi-dividend-review-monitor에 전달하세요. 또한 계정 위치 정보가 요청될 때kanchi-dividend-us-tax-accounting을 위한 세금 계획 입력을 구축하고, 계정 유형이나 보유 기간 범위를 사용할 수 없는 경우 저하된 것으로 표시하세요.
데이터 검증:
- 모든 포지션에 유효한 티커 심볼이 있는지 확인
- 시장 가치의 합계가 대략 계좌 자기자본과 일치하는지 확인
- 부실하거나 비활성화된 포지션 확인
- 엣지 케이스 처리 (소수 주식, 옵션, 지원되는 경우 암호화폐)
2단계: 포지션 데이터 강화
포트폴리오의 각 포지션에 대해 추가 시장 데이터와 펀더멘털을 수집합니다:
2.1 현재 시장 데이터:
- 실시간 또는 지연된 가격 호가
- 일일 거래량 및 유동성 지표
- 52주 범위
- 시가총액
2.2 펀더멘털 데이터: WebSearch 또는 사용 가능한 시장 데이터 API를 사용하여 가져오기:
- 섹터 및 산업 분류
- 주요 평가 지표 (P/E, P/B, 배당 수익률)
- 최근 실적 및 재무 건전성 지표
- 애널리스트 등급 및 목표 주가
- 최근 뉴스 및 주요 개발 사항
2.3 기술적 분석:
- 가격 추세 (20일, 50일, 200일 이동 평균)
- 상대 강도
- 지지 및 저항 수준
- 모멘텀 지표 (RSI, MACD, 사용 가능한 경우)
3단계: 포트폴리오 수준 분석
참조 파일의 프레임워크를 사용하여 종합적인 포트폴리오 분석 수행:
3.1 자산 배분 분석
references/asset-allocation.md 참조 - 배분 프레임워크
다양한 차원에서 현재 배분 분석:
자산 클래스별:
- 주식 vs 채권 vs 현금 vs 대체 투자
- 사용자의 위험 프로필에 맞는 목표 배분과 비교
- 배분이 투자 목표와 일치하는지 평가
섹터별:
- 기술, 의료, 금융, 소비재 등
- 섹터 집중 위험 식별
- 벤치마크 섹터 비중과 비교 (예: S&P 500)
시가총액별:
- 대형주 vs 중형주 vs 소형주 분포
- 메가캡 집중도
- 시가총액 다각화 점수
지역별:
- 미국 vs 국제 vs 신흥 시장
- 국내 집중 위험 평가
출력 형식:
## 자산 배분
### 현재 배분 vs 목표
| 자산 클래스 | 현재 | 목표 | 차이 |
|------------|------|------|------|
| 미국 주식 | XX.X% | YY.Y% | +/- Z.Z% |
| ... |
### 섹터 분류
[파이 차트 설명 또는 섹터 비율 표]
### 상위 10개 보유 종목
| 순위 | 심볼 | 포트폴리오 비중 | 섹터 |
|------|------|----------------|------|
| 1 | AAPL | X.X% | 기술 |
| ... |
3.2 다각화 분석
references/diversification-principles.md 참조 - 다각화 이론
포트폴리오 다각화 품질 평가:
포지션 집중도:
- 상위 보유 종목 및 전체 비중 식별
- 단일 포지션이 포트폴리오의 10-15%를 초과하는 경우 플래그
- 집중도 측정을 위한 허핀달-허쉬만 지수(HHI) 계산
섹터 집중도:
- 지배적인 섹터 식별
- 어떤 섹터가 포트폴리오의 30-40%를 초과하는 경우 플래그
- 벤치마크 섹터 다양성과 비교
상관 관계 분석:
- 주요 포지션 간의 상관 관계 추정
- 높은 상관 관계를 가진 보유 종목 식별 (잠재적 중복)
- 진정한 다각화 이점 평가
포지션 수:
- 개인 포트폴리오에 최적 범위: 15-30개 주식
- 과소 분산된 경우 플래그 (<10개 주식) 또는 과다 분산된 경우 (>50개 주식)
출력:
## 다각화 평가
**집중 위험:** [낮음 / 중간 / 높음]
- 상위 5개 보유 종목이 포트폴리오의 XX%를 차지
- 가장 큰 단일 포지션: [SYMBOL] at XX%
**섹터 다각화:** [우수 / 양호 / 보통 / 미흡]
- 지배적인 섹터: [섹터 이름] at XX%
- [섹터 간 균형 평가]
**포지션 수:** [최적 / 과소 분산 / 과다 분산]
- 총 포지션: XX개 주식
- [추천]
**상관 관계 우려 사항:**
- [높은 상관 관계를 가진 포지션 쌍 목록]
- [다각화 개선 제안]
3.3 위험 분석
references/portfolio-risk-metrics.md 참조 - 위험 측정 프레임워크
주요 위험 지표 계산 및 해석:
변동성 측정:
- 추정 포트폴리오 베타 (포지션 베타의 가중 평균)
- 개별 포지션 변동성
- 포트폴리오 표준 편차 (과거 데이터 사용 가능한 경우)
하방 위험:
- 최대 하락 (포트폴리오 히스토리 기준)
- 고점 대비 현재 하락
- 상당한 미실현 손실이 있는 포지션
위험 집중:
- 고변동성 주식 비율 (베타 > 1.5)
- 투기적/비수익 기업 비율
- 레버리지 사용 (해당되는 경우)
꼬리 위험:
- 잠재적 블랙 스완 이벤트에 대한 노출
- 단일 주식 집중 위험
- 섹터 특정 이벤트 위험
출력:
## 위험 평가
**전반적 위험 프로필:** [보수적 / 중간 / 공격적]
**포트폴리오 베타:** X.XX (시장 1.00 대비)
- 해석: 포트폴리오는 시장보다 [더/덜] 변동성이 있음
**최대 하락:** -XX.X% ($XXX,XXX에서 $XXX,XXX으로)
- 고점 대비 현재 하락: -XX.X%
**고위험 포지션:**
| 심볼 | 포트폴리오 비중 | 베타 | 위험 요소 |
|--------|----------------|------|-------------|
| [TICKER] | XX% | X.XX | [높은 변동성 / 최근 손실 / 기타] |
**위험 집중:**
- XX%가 단일 섹터 ([섹터])
- XX%가 베타 > 1.5인 주식
- [기타 집중 위험]
**위험 점수:** XX/100 ([낮음/중간/높음] 위험)
3.4 성과 분석
사용 가능한 데이터를 사용하여 포트폴리오 성과 평가:
절대 수익률:
- 전체 포트폴리오 미실현 손익 ($ 및 %)
- 최고 성과 포지션 (상위 5개, % 상승 기준)
- 최저 성과 포지션 (하위 5개, % 손실 기준)
시간 가중 수익률 (히스토리 사용 가능한 경우):
- YTD 수익률
- 1년, 3년, 5년 연환산 수익률
- 벤치마크와 비교 (S&P 500, 관련 지수)
포지션 수준 성과:
- 승자 vs 패자 비율
- 승리 포지션 평균 수익
- 패배 포지션 평균 손실
- 52주 고점/저점 근처 포지션
출력:
## 성과 검토
**총 포트폴리오 가치:** $XXX,XXX
**총 미실현 손익:** $XX,XXX (+XX.X%)
**현금 잔고:** $XX,XXX (포트폴리오의 XX%)
**최고 성과 종목:**
| 심볼 | 수익 | 포지션 가치 |
|--------|------|----------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |
**최저 성과 종목:**
| 심볼 | 손실 | 포지션 가치 |
|--------|------|----------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |
**벤치마크 대비 성과 (사용 가능한 경우):**
- 포트폴리오 수익률: +X.X%
- S&P 500 수익률: +Y.Y%
- 알파: +/- Z.Z%
4단계: 개별 포지션 분석
주요 포지션 (포트폴리오 비중 기준 상위 10-15개)에 대해 상세 분석 수행:
references/position-evaluation.md 참조 - 포지션 분석 프레임워크
각 중요 포지션에 대해:
4.1 현재 투자 논리 검증:
- 이 포지션은 왜 시작되었는가? (사용자 컨텍스트에서 알 수 있는 경우)
- 투자 논리가 실현되었는가, 아니면 깨졌는가?
- 최근 회사 개발 사항 및 뉴스
4.2 가치 평가:
- 현재 평가 지표 (P/E, P/B 등)
- 과거 평가 범위와 비교
- 섹터 동종 기업과 비교
- 과대 평가 / 적정 / 저평가 평가
4.3 기술적 건전성:
- 가격 추세 (상승 추세, 하락 추세, 횡보)
- 이동 평균 대비 포지션
- 지지 및 저항 수준
- 모멘텀 상태
4.4 포지션 크기:
- 포트폴리오 내 현재 비중
- 확신과 위험을 고려할 때 크기가 적절한가?
- 최적 대비 과대 또는 과소 비중
4.5 조치 추천:
- 유지 - 포지션 크기가 적절하고 투자 논리가 유효함
- 추가 매수 - 기회 대비 과소 비중, 논리 강화 중
- 일부 매도 - 과대 비중 또는 평가 가격이 높음
- 전량 매도 - 논리가 깨졌거나, 다른 곳에 더 나은 기회 있음
포지션별 출력:
### [SYMBOL] - [회사 이름] (포트폴리오의 XX.X%)
**포지션 세부 정보:**
- 주식 수: XXX
- 평균 원가: $XX.XX
- 현재 가격: $XX.XX
- 시장 가치: $XX,XXX
- 미실현 손익: $X,XXX (+XX.X%)
**펀더멘털 요약:**
- 섹터: [섹터]
- 시가총액: $XX.XB
- P/E: XX.X | 배당 수익률: X.X%
- 최근 개발 사항: [주요 뉴스 또는 실적]
**기술적 상태:**
- 추세: [상승 추세 / 하락 추세 / 횡보]
- 50일 이동 평균 대비 가격: [초과/미달 XX%]
- 지지: $XX.XX | 저항: $XX.XX
**포지션 평가:**
- **논리 상태:** [유효 / 약화 / 깨짐 / 강화 중]
- **가치 평가:** [저평가 / 적정 / 과대 평가]
- **포지션 크기:** [최적 / 과대 비중 / 과소 비중]
**추천:** [유지 / 추가 매수 / 일부 매도 / 전량 매도]
**근거:** [1-2문장 설명]
5단계: 리밸런싱 추천
references/rebalancing-strategies.md 참조 - 리밸런싱 접근법
구체적인 리밸런싱 추천 생성:
5.1 리밸런싱 트리거 식별:
- 목표 비중에서 크게 벗어난 포지션
- 조정이 필요한 섹터/자산 클래스 배분
- 매도해야 할 과대 비중 포지션 (임계값 초과)
- 추가해야 할 과소 비중 영역 (임계값 미만)
- 세금 고려 사항 (양도소득세 영향)
5.2 리밸런싱 계획 수립:
매도할 포지션:
- 과대 비중 포지션 (>목표 대비 임계값 이상 편차)
- 크게 상승한 주식 (가치 평가 우려)
- 포트폴리오의 15-20%를 초과하는 집중 포지션
- 논리가 깨진 포지션
추가 매수할 포지션:
- 과소 비중인 섹터 또는 자산 클래스
- 현재 과소 비중인 높은 확신 포지션
- 다각화를 개선할 새로운 기회
현금 배치:
- 잉여 현금이 있는 경우 (포트폴리오의 >10%), 배치 제안
- 기회와 배분 격차에 따라 우선 순위 지정
5.3 우선 순위 지정: 리밸런싱 조치를 우선 순위별로 정렬:
- 즉시 - 위험 감소 (집중 포지션 매도)
- 높은 우선 순위 - 주요 배분 편차 (목표 대비 >10%)
- 중간 우선 순위 - 중간 편차 (목표 대비 5-10%)
- 낮은 우선 순위 - 미세 조정 및 기회주의적 조정
출력:
## 리밸런싱 추천
### 요약
…
[잘림: 번역을 위해 잘림]