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