Communitygithub.com

6missedcalls/personal-finance-skill

Habilidade abrangente de gestão financeira pessoal com 75 ferramentos em 7 extensões para agregação bancária (Plaid), corretagem (Alpaca), monitoramento de portfólio (IBKR), otimização tributária, inteligência de mercado (Finnhub, SEC EDGAR, FRED, BLS, Alpha Vantage), sentimento social (StockTwits, X/Twitter, Quiver) e análise financeira. Suporta varreduras programadas, detecção de anomalias, acompanhamento de patrimônio líquido, colheita de prejuízos fiscais e execução de ações financeiras com aprovação.

O que é personal-finance-skill?

Esta skill oferece uma suíte completa de 75 ferramentas organizadas em 7 extensões para gerenciamento de finanças pessoais, cobrindo desde agregação bancária via Plaid até negociação na Alpaca, monitoramento de portfólio com IBKR, otimização tributária (processamento de 15 tipos de formulários fiscais, colheita de prejuízos, verificação de wash sales), inteligência de mercado (Finnhub, SEC EDGAR, FRED, BLS, Alpha Vantage) e análise de sentimento social (StockTwits, X/Twitter, Quiver). Ela é especialmente útil para desenvolvedores e agentes de IA que precisam automatizar fluxos financeiros complexos, como varreduras diárias de anomalias, relatórios semanais de patrimônio, colheita de prejuízos fiscais e processamento completo de declarações de imposto de renda. A arquitetura em três camadas (Inteligência, Adaptadores de Fonte de Dados e Fundamentos) garante que os dados sejam normalizados e armazenados de forma consistente antes de serem analisados, com um mecanismo de políticas para validar ações de alto risco antes da execução. As extensões são configuráveis via variáveis de ambiente e arquivos de configuração, e a skill suporta agendamento cron para fluxos de trabalho recorrentes.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add 6missedcalls/personal-finance-skill

Perguntar na sua IA favorita

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

Documentação

Habilidade de Finanças Pessoais

Uma habilidade abrangente de gestão financeira pessoal com 75 ferramentas em 7 extensões para fluxos de trabalho bancários, de investimento, tributários, inteligência de mercado, sentimento social e análise financeira.

Quando Usar

Ative esta habilidade quando um usuário solicitar:

  • Agregação de contas — conectar contas bancárias, visualizar saldos, sincronizar transações
  • Patrimônio líquido / fluxo de caixa — calcular totais, rastrear gastos, análise da taxa de poupança
  • Monitoramento de portfólio — posições, alocação, desempenho, detecção de desvio
  • Negociação — colocar/cancelar ordens, dados de mercado, consulta de ativos (Alpaca)
  • Otimização tributária — estimativa de passivo, candidatos à colheita de prejuízos fiscais, verificações de wash sale, pagamentos trimestrais
  • Processamento de documentos fiscais — análise de W-2, 1099-B/DIV/INT, K-1, Formulário 1040, Anexos A-E/SE, Formulário 8949, Formulário 6251 (AMT), declarações estaduais
  • Inteligência de mercado — notícias da empresa, arquivos da SEC, recomendações de analistas, dados econômicos (FRED, BLS), sentimento de notícias
  • Sentimento social — sentimento do StockTwits, análise de cashtag no X/Twitter, símbolos em tendência, negociações congressuais
  • Rastreamento de despesas recorrentes — assinaturas, contas, fluxos de receita
  • Detecção de anomalias — transações incomuns, quedas de saldo, cobranças duplicadas
  • Briefings financeiros — resumos semanais/mensais com itens de ação
  • Fluxos de trabalho financeiros agendados — varreduras baseadas em cron, alertas, relatórios

Visão Geral da Arquitetura

Sete extensões organizadas em três camadas:

Camada de Inteligência
  tax-engine (23 ferramentas) — análise (15), passivo, colheita de prejuízos fiscais, wash sales, lotes,
    cálculo do Anexo D, imposto estadual, AMT
  market-intel (10 ferramentas) — notícias, fundamentos, arquivos da SEC, dados econômicos
  social-sentiment (6 ferramentas) — StockTwits, X/Twitter, negociações congressuais

Adaptadores de Fonte de Dados
  plaid-connect (8)   alpaca-trading (10)   ibkr-portfolio (9)

Camada de Fundação
  finance-core (9 ferramentas) — modelos canônicos, armazenamento, normalização,
    verificações de política, detecção de anomalias, briefings

Fluxo de dados: Adaptadores buscam dados do provedor → finance-core normaliza e armazena → camada de inteligência analisa → mecanismo de políticas controla ações.

Catálogo de Ferramentas

finance-core — 9 ferramentas

FerramentaDescriçãoRisco
finance_upsert_snapshotArmazenar instantâneo de dados financeiros normalizados (idempotente)BAIXO
finance_get_stateObter estado financeiro atual (contas, posições, etc.)LEITURA
finance_get_transactionsConsultar transações com filtros e paginaçãoLEITURA
finance_get_net_worthCalcular detalhamento do patrimônio líquido por categoria/contaLEITURA
finance_detect_anomaliesEscanear transações incomuns, quedas de saldo, picos de taxasLEITURA
finance_cash_flow_summaryReceitas vs despesas por categoria com taxa de poupançaLEITURA
finance_subscription_trackerIdentificar cobranças recorrentes e padrões de assinaturaLEITURA
finance_generate_briefCriar resumo financeiro estruturado com itens de açãoLEITURA
finance_policy_checkValidar ação proposta contra regras de políticaLEITURA

Esquemas completos: references/ext-finance-core.md

plaid-connect — 8 ferramentas

FerramentaDescriçãoRisco
plaid_create_link_tokenInicializar Plaid Link para conexão de contaBAIXO
plaid_exchange_tokenTrocar token público por acesso permanenteMÉDIO
plaid_get_accountsListar contas conectadas com saldosLEITURA
plaid_get_transactionsBuscar transações via sincronização baseada em cursorLEITURA
plaid_get_investmentsBuscar participações, títulos, transações de investimentoLEITURA
plaid_get_liabilitiesBuscar dados de crédito, empréstimos estudantis e hipotecasLEITURA
plaid_get_recurringIdentificar fluxos recorrentes de entrada/saídaLEITURA
plaid_webhook_handlerProcessar eventos de webhook do Plaid recebidosBAIXO

Esquemas completos: references/ext-plaid-connect.md

alpaca-trading — 10 ferramentas

FerramentaDescriçãoRisco
alpaca_get_accountObter saldos da conta, poder de compra, statusLEITURA
alpaca_list_positionsListar todas as posições abertasLEITURA
alpaca_get_positionObter posição única por símboloLEITURA
alpaca_list_ordersListar ordens com filtros de status/dataLEITURA
alpaca_create_orderEnviar ordem de compra/venda com verificações de segurançaALTO
alpaca_cancel_orderCancelar uma ordem pendenteMÉDIO
alpaca_portfolio_historyHistórico de patrimônio líquido e P/L ao longo do tempoLEITURA
alpaca_get_assetsPesquisar ativos negociáveis por classe/bolsaLEITURA
alpaca_market_dataObter snapshots, barras ou cotações para símbolosLEITURA
alpaca_clockVerificar se o mercado está aberto, próxima abertura/fechamentoLEITURA

Esquemas completos: references/ext-alpaca-trading.md

ibkr-portfolio — 9 ferramentas

FerramentaDescriçãoRisco
ibkr_auth_statusVerificar status de autenticação do gatewayLEITURA
ibkr_tickleManter sessão do gateway ativa (~intervalo de 1 min)BAIXO
ibkr_list_accountsListar contas (deve ser chamado primeiro)LEITURA
ibkr_get_positionsObter posições para uma conta (paginado)LEITURA
ibkr_portfolio_allocationAlocação por classe de ativo, setor, grupoLEITURA
ibkr_portfolio_performanceSérie temporal do NAV e retornosLEITURA
ibkr_search_contractsPesquisar contratos por símbolo/nome/tipoLEITURA
ibkr_market_snapshotDados de mercado em tempo real para contratosLEITURA
ibkr_get_ordersObter ordens atuais em abertoLEITURA

Esquemas completos: references/ext-ibkr-portfolio.md

tax-engine — 23 ferramentas

FerramentaDescriçãoRisco
tax_parse_1099bAnalisar 1099-B (receitas, base de custo, wash sales)LEITURA
tax_parse_1099divAnalisar 1099-DIV (dividendos, ganhos de capital)LEITURA
tax_parse_1099intAnalisar 1099-INT (juros, prêmios de títulos)LEITURA
tax_parse_w2Analisar W-2 (salários, retenções, SS/Medicare)LEITURA
tax_parse_k1Analisar Anexo K-1 (pass-through de parceria)LEITURA
tax_parse_1040Analisar Formulário 1040 (declaração federal principal)LEITURA
tax_parse_schedule_aAnalisar Anexo A (deduções detalhadas)LEITURA
tax_parse_schedule_bAnalisar Anexo B (pagadores de juros/dividendos)LEITURA
tax_parse_schedule_cAnalisar Anexo C (renda de trabalho autônomo)LEITURA
tax_parse_schedule_dAnalisar Anexo D (compensação de ganhos de capital)LEITURA
tax_parse_schedule_eAnalisar Anexo E (aluguéis/royalties/parcerias)LEITURA
tax_parse_schedule_seAnalisar Anexo SE (imposto de trabalho autônomo)LEITURA
tax_parse_form_8949Analisar Formulário 8949 (vendas e alienações)LEITURA
tax_parse_state_returnAnalisar declaração estadual (CA 540, NY IT-201, etc.)LEITURA
tax_parse_form_6251Analisar Formulário 6251 (AMT)LEITURA
tax_estimate_liabilityCalcular imposto federal/estadual com faixasLEITURA
tax_find_tlh_candidatesIdentificar oportunidades de colheita de prejuízos fiscaisLEITURA
tax_check_wash_salesValidar conformidade com a regra de wash sale (janela de 61 dias)LEITURA
tax_lot_selectionComparar FIFO/LIFO/ID específico para uma venda propostaLEITURA
tax_quarterly_estimatePagamentos estimados trimestrais com safe harborLEITURA
tax_compute_schedule_dCalcular compensação do Anexo D com carryover de perdasLEITURA
tax_compute_state_taxCalcular imposto estadual para CA/NY/NJ/IL/PA/MA/TX/FLLEITURA
tax_compute_amtCalcular Imposto Mínimo Alternativo (Formulário 6251)LEITURA

Esquemas completos: references/ext-tax-engine.md

market-intel — 10 ferramentas

FerramentaDescriçãoRisco
intel_company_newsObter artigos de notícias recentes para uma empresa (Finnhub)LEITURA
intel_market_newsObter notícias gerais de mercado por categoria (Finnhub)LEITURA
intel_stock_fundamentalsObter demonstrações financeiras relatadas (Finnhub)LEITURA
intel_analyst_recommendationsObter consenso de analistas comprar/manter/vender (Finnhub)LEITURA
intel_sec_filingsListar arquivos da SEC para uma empresa por ticker (EDGAR)LEITURA
intel_sec_searchPesquisa de texto completo em arquivos da SEC (EDGAR)LEITURA
intel_fred_seriesBuscar séries temporais econômicas (PIB, IPC, taxas) (FRED)LEITURA
intel_fred_searchPesquisar séries FRED por palavra-chaveLEITURA
intel_bls_dataBuscar séries temporais de estatísticas trabalhistas/preços (BLS)LEITURA
intel_news_sentimentObter notícias com sentimento pontuado por IA (Alpha Vantage)LEITURA

Esquemas completos: references/ext-market-intel.md

social-sentiment — 6 ferramentas

FerramentaDescriçãoRisco
social_stocktwits_sentimentObter sentimento otimista/pessimista para uma ação (StockTwits)LEITURA
social_stocktwits_trendingObter símbolos atualmente em tendência (StockTwits)LEITURA
social_x_searchPesquisar tweets recentes por palavra-chave (X/Twitter)LEITURA
social_x_user_timelineObter tweets recentes de um usuário (X/Twitter)LEITURA
social_x_cashtagPesquisar cashtag com pontuação de sentimento por palavra-chave (X)LEITURA
social_quiver_congressObter divulgações de negociação de ações do congresso (Quiver)LEITURA

Esquemas completos: references/ext-social-sentiment.md

Fluxos de Trabalho Principais

1. Integração — Conectar Contas

plaid_create_link_token(products: ["transactions", "investments", "liabilities"])
  → Usuário completa o Plaid Link
  → plaid_exchange_token(publicToken)
  → plaid_get_accounts → finance_upsert_snapshot(source: "plaid")
  → plaid_get_transactions → finance_upsert_snapshot
  → plaid_get_investments → finance_upsert_snapshot
  → finance_get_net_worth → apresentar linha de base ao usuário

2. Varredura Diária — Detecção de Anomalias

plaid_get_transactions(cursor) → finance_upsert_snapshot
alpaca_list_positions → finance_upsert_snapshot(source: "alpaca")
ibkr_auth_status → ibkr_get_positions → finance_upsert_snapshot(source: "ibkr")
  → finance_detect_anomalies(lookbackDays: 7)
  → Alertar sobre achados de gravidade média/alta

3. Colheita de Prejuízos Fiscais

finance_get_state(include: ["positions"])
  → tax_find_tlh_candidates(positions, marginalRate)
  → tax_check_wash_sales(proposedSales, recentPurchases)
  → tax_lot_selection(symbol, qty, lots)
  → finance_policy_check(actionType: "tax_move")
  → [Se aprovado] alpaca_create_order(side: "sell", ...)

4. Revisão Fiscal Trimestral

tax_parse_w2 + tax_parse_1099b + tax_parse_1099div + tax_parse_1099int
  → tax_estimate_liability(filingStatus, income)
  → tax_quarterly_estimate(projectedIncome, priorYearTax, paymentsMade)
  → finance_generate_brief(period: "quarterly")

5. Monitoramento de Portfólio

alpaca_list_positions + ibkr_get_positions
  → finance_upsert_snapshot (ambas as fontes)
  → ibkr_portfolio_allocation (verificar desvio)
  → alpaca_portfolio_history (tendência de desempenho)
  → finance_detect_anomalies
  → finance_generate_brief(period: "weekly")

6. Pesquisa de Empresa — Inteligência de Mercado

intel_company_news(symbol: "AAPL", limit: 10)
  → intel_analyst_recommendations(symbol: "AAPL")
  → intel_stock_fundamentals(symbol: "AAPL", freq: "quarterly")
  → intel_sec_filings(symbol: "AAPL", formType: "10-K")
  → intel_news_sentiment(tickers: "AAPL")
  → social_stocktwits_sentiment(symbol: "AAPL")
  → social_x_cashtag(symbol: "AAPL")

7. Visão Geral Econômica

intel_fred_series(seriesId: "GDP")
  → intel_fred_series(seriesId: "CPIAUCSL")
  → intel_fred_series(seriesId: "UNRATE")
  → intel_bls_data(seriesIds: ["CES0000000001"])
  → intel_fred_series(seriesId: "DFF")

8. Processamento Completo de Declaração de Imposto

tax_parse_1040(rawData) → tax_parse_schedule_a(rawData)
  → tax_parse_schedule_b(rawData) → tax_parse_schedule_c(rawData)
  → tax_parse_schedule_d(rawData) → tax_parse_schedule_e(rawData)
  → tax_parse_form_8949(rawData) → tax_parse_schedule_se(rawData)
  → tax_compute_schedule_d(gains, losses, carryovers)
  → tax_compute_state_tax(stateCode, taxableIncome, filingStatus)
  → tax_compute_amt(taxableIncome, adjustments, regularTax)
  → tax_parse_state_return(rawData)

9. Sinais de Negociação do Congresso

social_quiver_congress(daysBack: 30)
  → Filtrar por grandes compras
  → intel_company_news(symbol: <top_ticker>)
  → alpaca_market_data(symbols: <top_ticker>)
  → social_stocktwits_sentiment(symbol: <top_ticker>)

Configuração

Variáveis de Ambiente

VariávelExtensãoDescrição
PLAID_CLIENT_IDplaid-connectID do cliente da API Plaid
PLAID_SECRETplaid-connectChave secreta da API Plaid
PLAID_ENVplaid-connectsandbox / development / production
ALPACA_API_KEYalpaca-tradingChave da API Alpaca
ALPACA_API_SECRETalpaca-tradingSegredo da API Alpaca
ALPACA_ENValpaca-tradingpaper / live
IBKR_BASE_URLibkr-portfolioURL do Gateway do Portal do Cliente
FINNHUB_API_KEYmarket-intelChave da API Finnhub (finnhub.io)
FRED_API_KEYmarket-intelChave da API FRED (fred.stlouisfed.org)
BLS_API_KEYmarket-intelChave de registro BLS (v2)
ALPHA_VANTAGE_API_KEYmarket-intelChave da API Alpha Vantage
X_API_BEARER_TOKENsocial-sentimentToken de Portador OAuth 2.0 do X/Twitter
QUIVER_API_KEYsocial-sentimentChave da API Quiver Quantitative

Configuração das Extensões

Cada extensão possui um openclaw.plugin.json com um configSchema. Configurações principais:

  • finance-core: storageDir, anomalyThresholds, policyRulesPath
  • plaid-connect: plaidEnv, webhookUrl, clientName, countryCodes
  • alpaca-trading: env (paper/live), maxOrderQty, maxOrderNotional
  • ibkr-portfolio: baseUrl, defaultAccountId
  • tax-engine: defaultFilingStatus, defaultState, defaultTaxYear
  • market-intel: finnhubApiKeyEnv, fredApiKeyEnv, blsApiKeyEnv, alphaVantageApiKeyEnv, secEdgarUserAgent
  • social-sentiment: xApiBearerTokenEnv, quiverApiKeyEnv

Exemplos de Cron

Semanal

...

Habilidades Relacionadas