Communitygithub.com

포트폴리오 매니저

Alpaca MCP 서버와 통합하여 보유 현황을 가져오고 자산 배분, 위험 지표, 개별 주식 포지션, 다각화를 분석한 후 리밸런싱 추천을 제공하는 종합적인 포트폴리오 분석 도구입니다.

포트폴리오 매니저란 무엇인가요?

이 스킬은 Alpaca MCP 서버를 통해 실시간 포트폴리오 데이터를 가져와 종합적인 분석을 수행하는 AI 에이전트용 도구입니다. 자산 배분, 다각화, 위험 메트릭, 개별 포지션 평가를 포함한 포괄적인 분석을 제공하며, 리밸런싱 추천까지 생성합니다. MCP가 비활성화된 스케줄링된 작업 환경에서는 Alpaca REST API를 대체 수단으로 사용하여 데이터를 가져옵니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용 가능하며, 포트폴리오 검토, 위험 평가, 성과 평가 등을 요청할 때 특히 유용합니다. 이 스킬은 사용자가 직접 입력하지 않고 실제 보유 포지션을 기반으로 정확한 분석을 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/analysis/portfolio-manager

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

포트폴리오 매니저은(는) 무엇을 하나요?

개요

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 우선 순위 지정: 리밸런싱 조치를 우선 순위별로 정렬:

  1. 즉시 - 위험 감소 (집중 포지션 매도)
  2. 높은 우선 순위 - 주요 배분 편차 (목표 대비 >10%)
  3. 중간 우선 순위 - 중간 편차 (목표 대비 5-10%)
  4. 낮은 우선 순위 - 미세 조정 및 기회주의적 조정

출력:

## 리밸런싱 추천

### 요약

…

[잘림: 번역을 위해 잘림]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬