Communitygithub.com

포트폴리오 트래커

CLI 도구로 실시간 가격, 손익, 배당 추적, 여러 포트폴리오 관리를 통해 주식 및 암호화폐 포트폴리오를 추적합니다.

포트폴리오 트래커란 무엇인가요?

이 스킬은 개발자와 파워 유저가 CLI(Command Line Interface)를 통해 주식 및 암호화폐 포트폴리오를 효율적으로 관리할 수 있도록 설계된 포트폴리오 트래커입니다. 실시간 가격 데이터(Yahoo Finance 및 CoinGecko API 활용)를 기반으로 보유 자산의 현재 가치와 손익(P&L)을 추적하며, FIFO(선입선출) 원가 기준법을 사용한 매도 거래와 거래 내역 조회 기능을 제공합니다. 특히 배당 추적 기능이 강화되어, 개별 주식의 배당 수익률, 원가 대비 수익률(YOC), 예상 연간 배당 소득, 그리고 예정된 배당락일(ex-dividend date)까지 확인할 수 있습니다. 여러 포트폴리오를 생성 및 전환하여 관리할 수 있으며, 데이터는 로컬 JSON 파일에 안전하게 저장됩니다. CLI 외에도 선택적으로 웹 UI(Next.js 기반)를 실행하여 포트폴리오 할당 파이 차트, 배당 요약 카드, 시각적 캘린더 등 직관적인 인터페이스를 제공합니다. 지원 플랫폼은 Node.js 기반의 모든 환경(로컬 개발 머신, CI/CD 파이프라인 등)이며, npm link를 통해 전역 CLI 명령어로 간편하게 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/claw-portfolio

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

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

문서

포트폴리오 트래커은(는) 무엇을 하나요?

실시간 가격, 손익(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 및 선택적 웹 인터페이스

Individual skills in this repo

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

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Use this skill when the user asks to build, create, design, develop, or improve ANY frontend interface, web page, UI component, or visual element. This includes: - Building landing pages, websites, web apps, dashboards, portfolios, or any web interface - Creating UI components (buttons, forms, cards, navbars, modals, etc.) - Designing pages with React, Vue, Next.js, Svelte, or any frontend framework - Adding styling or improving visual design of existing components - Implementing specific design aesthetics (modern, dark, minimalist, brutalist, etc.) - User mentions "frontend", "UI", "UX", "design", "interface", "web design", or "styling" - User asks for "beautiful", "modern", "professional", "clean", or any aesthetic adjective - User requests help with CSS, Tailwind, styled-components, or any styling approach This skill automatically retrieves the appropriate design system prompt (Neo-brutalism, Modern Dark, Bauhaus, Cyberpunk, Material, etc.) to help create visually distinctive, production-grade frontend...

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

관련 스킬