Habilidade de Rastreador de Portfólio
Um rastreador de portfólio de investimentos que roda completamente localmente. Todos os dados ficam em ~/.portfolio-tracker/.
Arquitetura
- Dados:
~/.portfolio-tracker/data.json(portfólios, ativos, preços) - Config:
~/.portfolio-tracker/config.json(chaves de API, endereços de carteira, perfil do usuário) - Scripts: Ferramentas CLI em TypeScript em
<skill-path>/scripts/, executadas vianpx tsx
Configuração Inicial
Antes de executar qualquer script, certifique-se de que as dependências estejam instaladas:
npm install --prefix <skill-path>/scripts
Substitua <skill-path> pelo caminho real de instalação desta habilidade.
Como os Scripts Funcionam
Cada script é uma ferramenta CLI independente. Execute-os com:
npx tsx <skill-path>/scripts/<script>.ts <comando> [argumentos]
Scripts leem da entrada padrão quando necessário e geram JSON na saída padrão.
data-store.ts
load— Ler dados do portfólio (cria padrão se ausente)save— Escrever dados do portfólio (JSON da entrada padrão)load-config— Ler configuraçãosave-config— Escrever configuração (JSON da entrada padrão)
fetch-prices.ts
crypto <símbolo>— Obter preço de criptomoeda (Binance → CoinGecko)stock <símbolo>— Obter preço de ação (Yahoo Finance)fx— Obter taxas de câmbio USD/CNY/HKDhistorical <símbolo>— Obter dados históricos mensais de 3 anossearch <consulta>— Pesquisar ativos por nome/símbolorefresh— Atualizar preços em lote (JSON de ativos da entrada padrão)
binance-sync.ts
sync <apiKey> <apiSecret>— Buscar todos os saldos da Binance (6 tipos de conta)validate <apiKey> <apiSecret>— Validar credenciais da API
ibkr-sync.ts
sync <token> <queryId>— Buscar posições do IBKR via Flex Queryvalidate <token> <queryId>— Validar credenciais do IBKR
blockchain-sync.ts
sync <endereço> [rede]— Buscar saldos de carteira (rede única ou todas as 5 redes EVM)validate <endereço>— Validar endereço EVM
Tipos de Dados
Ativo
{
"id": "id-único",
"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" }
}
Portfólio
{
"id": "id-único",
"name": "Principal",
"assets": [...]
}
Padrões de Fluxo de Trabalho
Visualizando Portfólio
- Carregar dados via
data-store.ts load - Encontrar portfólio atual por
currentPortfolioId - Calcular valor total usando
quantity * currentPricepor ativo - Converter para moeda de exibição usando
exchangeRates - Exibir como uma tabela formatada
Adicionando Ativos
- Carregar dados
- Pesquisar o ativo usando
fetch-prices.ts search <consulta> - Obter preço atual via
fetch-prices.ts crypto/stock <símbolo> - Adicionar ativo ao portfólio atual com um ID único gerado
- Salvar dados
Atualizando Preços
- Carregar dados
- Enviar ativos do portfólio atual para
fetch-prices.ts refreshvia entrada padrão - Também executar
fetch-prices.ts fxpara taxas de câmbio - Atualizar
currentPricede cada ativo e osexchangeRates - Definir
lastPriceRefreshpara o timestamp ISO atual - Salvar dados
Sincronizando da Exchange/Carteira
- Carregar configuração para obter credenciais
- Executar o script de sincronização apropriado
- Mesclar resultados: atualizar ativos existentes (corresponder por símbolo+fonte), adicionar novos
- Salvar dados
Comandos
Comandos de usuário disponíveis:
/portfolio— Visualizar e gerenciar portfólios/prices— Atualizar todos os preços/setup— Configurar chaves de API e carteiras/sync-binance— Sincronizar da Binance/sync-ibkr— Sincronizar da Interactive Brokers/sync-wallet— Sincronizar da carteira blockchain/advise— Obter conselho de investimento da IA