포트폴리오 트래커은(는) 무엇을 하나요?
실시간 가격, 손익(P&L), 배당 추적 기능을 갖춘 주식 및 암호화폐 포트폴리오를 추적하는 CLI 도구입니다.
이 스킬을 사용해야 하는 경우
다음과 같은 경우에 이 스킬을 사용하세요:
- 주식 및 암호화폐 보유 현황을 로컬에서 추적해야 할 때
- 실시간 가격과 손익(P&L)을 확인해야 할 때
- 배당 수익률, 원가 대비 수익률(Yield on Cost), 예상 배당 소득을 추적해야 할 때
- 다가오는 배당락일(ex-dividend date)을 확인해야 할 때
- 여러 포트폴리오를 관리해야 할 때
- 포트폴리오 데이터를 CSV로 내보내야 할 때
도구
이 스킬은 다음과 같은 기능을 제공합니다:
1. 보유 현황 조회
모든 보유 종목과 현재 가치 및 손익을 표시합니다.
명령어:
npx tsx portfolio.ts list
2. 보유 종목 추가
새로운 주식 또는 암호화폐 보유 종목을 추가합니다.
명령어:
npx tsx portfolio.ts add <symbol> <quantity> <price> <name> [type]
예시:
npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto
3. 보유 종목 매도
FIFO(선입선출) 원가 기준법을 사용하여 주식을 매도합니다.
명령어:
npx tsx portfolio.ts sell <symbol> <quantity> <price> [date]
예시:
npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000
4. 거래 내역 조회
모든 보유 종목 또는 특정 심볼의 매도 내역을 확인합니다.
명령어:
npx tsx portfolio.ts history [symbol]
예시:
npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL
5. 손익 요약
실현 손익과 미실현 손익을 모두 표시합니다.
명령어:
npx tsx portfolio.ts pnl
6. 배당 추적
주식 보유 종목에 대한 상세 배당 정보(수익률, 원가 대비 수익률(YOC), 예상 연간 소득)를 확인합니다.
명령어:
npx tsx portfolio.ts dividends
7. 배당 요약
포트폴리오 수준의 배당 요약(총 예상 소득, 가중 평균 수익률, 원가 대비 수익률)을 표시합니다.
명령어:
npx tsx portfolio.ts dividend-summary
출력 항목:
- 총 예상 연간 소득
- 월별/분기별 소득 예상
- 모든 보유 종목의 가중 평균 수익률
- 포트폴리오 원가 대비 수익률(Yield on Cost)
- 배당 지급 주식 수
8. 배당 캘린더
보유 종목의 다가오는 배당락일을 확인합니다.
명령어:
npx tsx portfolio.ts calendar [days]
예시:
npx tsx portfolio.ts calendar # 다음 30일
npx tsx portfolio.ts calendar 60 # 다음 60일
9. 배당 정보 포함 조회
list 명령어는 자동으로 배당 데이터를 가져옵니다. 건너뛰려면 --no-dividends 플래그를 사용하세요.
명령어:
npx tsx portfolio.ts list # 배당 정보 포함
npx tsx portfolio.ts list --no-dividends # 배당 정보 제외
10. 보유 종목 제거
심볼을 기준으로 보유 종목을 제거합니다.
명령어:
npx tsx portfolio.ts remove <symbol>
11. 포트폴리오 가치
총 포트폴리오 가치와 손익을 표시합니다.
명령어:
npx tsx portfolio.ts value
12. 포트폴리오 관리
포트폴리오 목록 보기, 전환, 생성 등을 수행합니다.
명령어:
npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Portfolio Name"
npx tsx portfolio.ts create "New Portfolio"
팁: npm link 실행 후에는 npx tsx portfolio.ts 대신 짧은 portfolio 명령어를 사용할 수 있습니다.
설치
먼저 필요한 종속성을 설치합니다:
npm install
이 명령어는 TypeScript 런타임(tsx), Next.js, React 및 package.json에 나열된 기타 종속성을 포함한 모든 필요한 패키지를 설치합니다.
선택 사항: CLI를 전역에 링크하여 더 쉽게 접근:
npm link
링크 후에는 npx tsx portfolio.ts <command> 대신 portfolio <command>를 사용할 수 있습니다.
NPM 스크립트
npm run dev # 웹 UI 시작 (선택 사항)
npm run build # 프로덕션 빌드
웹 UI (선택 사항)
전체 배당 추적을 지원하는 선택적 웹 인터페이스를 실행할 수도 있습니다:
npm run dev
그런 다음 http://localhost:3000 을 엽니다.
웹 UI 기능:
- 실시간 포트폴리오 가치 및 손익 추적
- 배당 요약 카드 (연간 소득, 가중 평균 수익률, YOC, 다가오는 날짜)
- 주식별 상세 배당 분석표
- 다가오는 배당락일의 시각적 캘린더
- 포트폴리오 할당을 위한 대화형 파이 차트
데이터 저장
포트폴리오 데이터는 data/portfolio.json 파일에 로컬로 저장됩니다. 데이터 파일은 첫 실행 시 빈 포트폴리오로 자동 생성됩니다.
기능
- Yahoo Finance API를 통한 실시간 주가
- CoinGecko API를 통한 실시간 암호화폐 가격
- 여러 포트폴리오 지원
- 보유 종목별 손익 추적
- 배당 추적 (수익률, YOC, 예상 소득, 배당락일)
- CLI 및 선택적 웹 인터페이스