Communitygithub.com

Rastreador de Portfólio

Rastreie portfólios de ações e criptomoedas via CLI - preços em tempo real, lucro/perda, rastreamento de dividendos e múltiplos portfólios.

O que é Rastreador de Portfólio?

Essa ferramenta de CLI (linha de comando) permite que você gerencie e acompanhe o desempenho de seus investimentos em ações e criptomoedas diretamente do terminal. Com ela, você pode adicionar, vender e remover ativos, visualizar lucros e perdas realizados e não realizados, e monitorar indicadores de dividendos como yield, Yield on Cost (YOC) e renda projetada. A skill oferece suporte a múltiplos portfólios, permitindo a troca entre eles e a exportação de dados para CSV. Ideal para desenvolvedores e entusiastas de finanças que preferem uma interface rápida e programável, a ferramenta consulta preços em tempo real via APIs (Yahoo Finance para ações e CoinGecko para criptomoedas). Além da interface CLI, um servidor web opcional fornece uma interface visual com gráficos de pizza, calendário de dividendos e cartões de resumo. O armazenamento local em arquivo JSON (data/portfolio.json) simplifica o backup e a portabilidade dos dados. Recomendado para uso com agentes de IA como Claude Code, Cursor e Codex, pois sua natureza scriptável e comandos padronizados facilitam a automação e integração em fluxos de trabalho.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Rastreador de Portfólio faz?

Uma ferramenta de CLI para rastrear portfólios de ações e criptomoedas com preços em tempo real, lucro/perda e rastreamento de dividendos.

Quando Usar Esta Skill

Use esta skill quando precisar:

  • Rastrear participações em ações e criptomoedas localmente
  • Obter preços em tempo real e P&L (lucro/perda)
  • Acompanhar dividend yields, Yield on Cost (YOC) e renda projetada
  • Visualizar próximas datas ex-dividendo
  • Gerenciar múltiplos portfólios
  • Exportar dados do portfólio para CSV

Ferramentas

Esta skill oferece as seguintes capacidades:

1. Listar Participações

Mostra todas as participações com valores atuais e P&L.

Comando:

npx tsx portfolio.ts list

2. Adicionar Participação

Adiciona uma nova participação em ação ou criptomoeda.

Comando:

npx tsx portfolio.ts add <símbolo> <quantidade> <preço> <nome> [tipo]

Exemplos:

npx tsx portfolio.ts add AAPL 10 150 "Apple Inc." stock
npx tsx portfolio.ts add BTC 0.5 45000 Bitcoin crypto

3. Vender Participação

Vende ações usando o método de custo base FIFO (First-In-First-Out).

Comando:

npx tsx portfolio.ts sell <símbolo> <quantidade> <preço> [data]

Exemplos:

npx tsx portfolio.ts sell AAPL 5 180 2025-06-01
npx tsx portfolio.ts sell BTC 0.25 50000

4. Histórico de Transações

Visualiza o histórico de vendas de todas as participações ou de um símbolo específico.

Comando:

npx tsx portfolio.ts history [símbolo]

Exemplos:

npx tsx portfolio.ts history
npx tsx portfolio.ts history AAPL

5. Resumo de P&L

Mostra tanto o lucro/perda realizado quanto o não realizado.

Comando:

npx tsx portfolio.ts pnl

6. Rastreamento de Dividendos

Visualiza informações detalhadas de dividendos para participações em ações, incluindo yield, Yield on Cost (YOC) e renda anual projetada.

Comando:

npx tsx portfolio.ts dividends

7. Resumo de Dividendos

Mostra o resumo de dividendos do portfólio: renda total projetada, yield médio ponderado e Yield on Cost.

Comando:

npx tsx portfolio.ts dividend-summary

A saída inclui:

  • Renda anual total projetada
  • Estimativas de renda mensal/trimestral
  • Yield médio ponderado em todas as participações
  • Portfólio Yield on Cost
  • Contagem de ações que pagam dividendos

8. Calendário de Dividendos

Visualiza as próximas datas ex-dividendo para suas participações.

Comando:

npx tsx portfolio.ts calendar [dias]

Exemplos:

npx tsx portfolio.ts calendar       # Próximos 30 dias
npx tsx portfolio.ts calendar 60    # Próximos 60 dias

9. Listar com Dividendos

O comando list busca automaticamente dados de dividendos. Use a flag --no-dividends para pular.

Comandos:

npx tsx portfolio.ts list           # Com info de dividendos
npx tsx portfolio.ts list --no-dividends  # Pular dividendos

10. Remover Participação

Remove uma participação pelo símbolo.

Comando:

npx tsx portfolio.ts remove <símbolo>

11. Valor do Portfólio

Mostra o valor total do portfólio e P&L.

Comando:

npx tsx portfolio.ts value

12. Gerenciar Portfólios

Listar, trocar ou criar portfólios.

Comandos:

npx tsx portfolio.ts portfolios
npx tsx portfolio.ts switch "Nome do Portfólio"
npx tsx portfolio.ts create "Novo Portfólio"

Dica: Após executar npm link, você pode usar o comando mais curto portfolio em vez de npx tsx portfolio.ts.

Instalação

Primeiro, instale as dependências necessárias:

npm install

Isso instalará todos os pacotes necessários, incluindo o runtime TypeScript (tsx), Next.js, React e outras dependências listadas no package.json.

Opcional: Vincule a CLI globalmente para acesso mais fácil:

npm link

Após vincular, você pode usar portfolio <comando> em vez de npx tsx portfolio.ts <comando>.

Scripts NPM

npm run dev        # Iniciar interface web (opcional)
npm run build      # Construir para produção

Interface Web (Opcional)

Você também pode executar uma interface web opcional com suporte completo a rastreamento de dividendos:

npm run dev

Em seguida, abra http://localhost:3000

Recursos da Interface Web:

  • Acompanhamento de valor do portfólio e P&L em tempo real
  • Cartões de resumo de dividendos (renda anual, yield ponderado, YOC, datas futuras)
  • Tabela detalhada de detalhamento de dividendos por ação
  • Calendário visual de próximas datas ex-dividendo
  • Gráfico de pizza interativo para alocação do portfólio

Armazenamento de Dados

Os dados do portfólio são armazenados localmente em data/portfolio.json. O arquivo de dados é criado automaticamente na primeira execução com um portfólio vazio.

Recursos

  • Preços de ações em tempo real via API do Yahoo Finance
  • Preços de criptomoedas em tempo real via API do CoinGecko
  • Suporte a múltiplos portfólios
  • Rastreamento de P&L por participação
  • Rastreamento de dividendos (yield, YOC, renda projetada, ex-datas)
  • CLI e interface web opcional

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.

Habilidades Relacionadas