포트폴리오 트래커 스킬
완전히 로컬에서 실행되는 투자 포트폴리오 트래커입니다. 모든 데이터는 ~/.portfolio-tracker/에 저장됩니다.
아키텍처
- 데이터:
~/.portfolio-tracker/data.json(포트폴리오, 자산, 가격) - 설정:
~/.portfolio-tracker/config.json(API 키, 지갑 주소, 사용자 프로필) - 스크립트: TypeScript CLI 도구 (
<skill-path>/scripts/),npx tsx로 실행
첫 설정
스크립트를 실행하기 전에 의존성을 설치해야 합니다:
npm install --prefix <skill-path>/scripts
<skill-path>를 이 스킬이 실제로 설치된 경로로 바꾸세요.
스크립트 작동 방식
각 스크립트는 독립적인 CLI 도구입니다. 다음과 같이 실행합니다:
npx tsx <skill-path>/scripts/<script>.ts <명령어> [인수]
필요시 스크립트는 stdin에서 데이터를 읽고 stdout에 JSON을 출력합니다.
data-store.ts
load— 포트폴리오 데이터 읽기 (없으면 기본값 생성)save— 포트폴리오 데이터 저장 (stdin에서 JSON 입력)load-config— 설정 읽기save-config— 설정 저장 (stdin에서 JSON 입력)
fetch-prices.ts
crypto <심볼>— 암호화폐 가격 조회 (Binance → CoinGecko)stock <심볼>— 주식 가격 조회 (Yahoo Finance)fx— USD/CNY/HKD 환율 조회historical <심볼>— 3년 월간 과거 데이터 조회search <검색어>— 이름/심볼로 자산 검색refresh— 가격 일괄 갱신 (stdin에서 자산 JSON 입력)
binance-sync.ts
sync <apiKey> <apiSecret>— 모든 Binance 잔고 조회 (6개 계정 유형)validate <apiKey> <apiSecret>— API 자격 증명 유효성 검사
ibkr-sync.ts
sync <token> <queryId>— Flex Query를 통해 IBKR 포지션 조회validate <token> <queryId>— IBKR 자격 증명 유효성 검사
blockchain-sync.ts
sync <주소> [체인]— 지갑 잔고 조회 (단일 체인 또는 5개 EVM 체인 전체)validate <주소>— EVM 주소 유효성 검사
데이터 타입
자산
{
"id": "고유-id",
"type": "CRYPTO | USSTOCK | HKSTOCK | ASHARE | CASH",
"symbol": "BTC",
"name": "Bitcoin",
"quantity": 1.5,
"avgPrice": 40000,
"currentPrice": 50000,
"currency": "USD | CNY | HKD",
"transactions": [],
"source": { "type": "manual | binance | wallet | ibkr" }
}
포트폴리오
{
"id": "고유-id",
"name": "Main",
"assets": [...]
}
워크플로 패턴
포트폴리오 조회
data-store.ts load로 데이터 로드currentPortfolioId로 현재 포트폴리오 찾기- 자산별
quantity * currentPrice로 총 가치 계산 exchangeRates를 사용하여 표시 통화로 변환- 포맷된 표로 표시
자산 추가
- 데이터 로드
fetch-prices.ts search <검색어>로 자산 검색fetch-prices.ts crypto/stock <심볼>로 현재 가격 조회- 생성된 고유 ID로 현재 포트폴리오에 자산 추가
- 데이터 저장
가격 갱신
- 데이터 로드
- 현재 포트폴리오 자산을 stdin을 통해
fetch-prices.ts refresh로 파이프 fetch-prices.ts fx도 실행하여 환율 가져오기- 각 자산의
currentPrice와exchangeRates업데이트 lastPriceRefresh를 현재 ISO 타임스탬프로 설정- 데이터 저장
거래소/지갑 동기화
- 설정 로드하여 자격 증명 가져오기
- 적절한 동기화 스크립트 실행
- 결과 병합: 기존 자산 업데이트 (symbol+source로 매칭), 새 자산 추가
- 데이터 저장
명령어
사용 가능한 사용자 명령어:
/portfolio— 포트폴리오 조회 및 관리/prices— 모든 가격 갱신/setup— API 키 및 지갑 설정/sync-binance— Binance에서 동기화/sync-ibkr— Interactive Brokers에서 동기화/sync-wallet— 블록체인 지갑에서 동기화/advise— AI 투자 조언 받기