• Automaticamente busca todos as suas operacoes na bolsa no site do canal eletronico do investidor (CEI) (https://cei.b3.com.br/)
• Apos buscar os trades no CEI, salva tudo em um arquivo csv no dropbox da sua conta
• Todo dia 5 de cada mes executa e calcula (automaticamente):
  • Preco medio de compra
  • Preco medio de venda
  • Lucro/Prejuizo no mes
  • IR a pagar, ja considerando o possivel prejuizo acumulado
  • Tabela com a custodia atual para conferencia
  • Envia email com todas as informacoes para voce pagar o imposto
• A ideia é ser TUDO automatico, mas ainda ter a opcao de voce manualmente ter controle de tudo via um arquivo csv caso algum papel sofra desdobramento ou mude o ticker de negociacao
• Funciona com FIIs, ETFs, Acoes e Opcoes. Em desenvolvimento (FIP, FIPIE, Futuros)
• Funciona com qualquer corretora. (Na verdade, nao depende da corretora)
• Como alternativa a busca automática no CEI, é possível exportar as negociações manualmente para Excel (XSLX) e importar na aplicação

• Uma conta no CEI (https://cei.b3.com.br/)
• Uma conta no dropbox com API habilitada (https://blogs.dropbox.com/developers/2014/05/generate-an-access-token-for-your-own-account/)
• Configurar as variaveis de ambiente conforme (https://github.com/guilhermecgs/ir/blob/master/tests/test_environment_variables.py)
• Voce pode executar tudo localmente e ver os resultados. Se quiser envio por email (SMTP), recomendo usar o https://elasticemail.com/ gratuitamente
• Executar os comandos abaixo:
  • python3 ./ir.py --do check_environment_variables
  • python3 ./ir.py --do busca_trades_e_faz_merge_operacoes
  • python3 ./ir.py --do calculo_ir
  • python3 ./ir.py --do importar_negociacoes

https://github.com/guilhermecgs/ir/blob/master/exemplo_relatorio_automatico.pdf

• DROPBOX_FILE_LOCATION:/Finance/GCGS/export_operacoes_gcgs.txt
• DROPBOX_API_KEY:jOznaw_xxxxxxxxxxxxxxxxxxxxtkw9ox_a9I_8-_aU2xw1xxxxxxxxxxKWek69Z
• SEND_TO:emaildestinatario@gmail.com
• CPF:00098765434
• SENHA_CEI:minha_senha_cei
• SMTP_USER=meu_smtp_user@sss.com
• SMTP_PASSWORD=passkkk
• SMTP_SERVER=smtp.elasticemail.com
• SMTP_PORT=2525

Além da definição das configurações do sistema via variáveis de ambiente, também é possível utilizar um arquivo de configuração .env:

DROPBOX_FILE_LOCATION=/Finance/GCGS/export_operacoes_gcgs.txt
DROPBOX_API_KEY=jOznaw_xxxxxxxxxxxxxxxxxxxxtkw9ox_a9I_8-_aU2xw1xxxxxxxxxxKWek69Z

Variáveis não definidas assumem os valores padrões definidos no arquivo config.py. Sendo que as únicas variáveis obrigatórias são: DROPBOX_FILE_LOCATION e DROPBOX_API_KEY.

1. Exporte as negociações do site da bovespa acessando https://www.investidor.b3.com.br/extrato/negociacao

2. Copie o arquivo exportado para pasta importar

3. Execute o comando para importar os arquivos: python3 ./ir.py --do importar_negociacoes

4. Remova os arquivos da pasta importar

Alternativa ao CEI/import manual de XLSX: uma skill do Claude Code (.claude/skills/extrai-movimentacoes-print/) lê printscreens do extrato de movimentações de qualquer site (investidor10, portal da B3, corretora, etc.), valida o formato, detecta duplicidade contra o arquivo de operações atual, e apresenta linhas prontas para colar manualmente em export_operacoes.txt.

1. Tire printscreen(s) da tela de extrato/movimentações
2. Peça para o Claude Code usar a skill extrai-movimentacoes-print passando os paths das imagens
3. Copie as linhas do bloco "PRONTO PARA COPIAR" para export_operacoes.txt
4. Revise o bloco "OBSERVAÇÕES" — tipos de movimentação fora de compra/venda (desdobramento, conversão, subscrição, bonificação) precisam de codificação manual, seguindo os exemplos na seção "Exemplos de Ajustes manuais" abaixo

A skill nunca escreve no arquivo sozinha — a inserção final é sempre manual.

• Aceito PRs :-) Eu fiz o software pensando em automatizar exatamente como eu fazia as coisas manualmente
• Nao funciona com daytrade e aluguel de acoes/fii
• Desconsidera custos e emolumentos para simplificação do calculo!

- Incluir desconto de taxas, emolumentos e dedo duro - http://www.b3.com.br/pt_br/produtos-e-servicos/tarifas/listados-a-vista-e-derivativos/renda-variavel/tarifas-de-acoes-e-fundos-de-investimento/a-vista/
- Incluir opcao completa ou so ultimos x meses

- python
- selenium
- gitlab ci
- beautifulsoap
- pandas

Na maioria das vezes, nenhuma intervenção manual é necessária. Apenas algumas situaçoes (listadas abaixo) será preciso alterar alguma coisa no csv de dados de forma pontual. Geralmente só acrescentando uma linha a mais com a compra/venda já resolve.

• Subscricao de titulos (nao existe essa informacao no cei; é necessário acrescentar uma linha com dos dados da compra)
• Venda de direitos subscricao
• IPOs
• Mudança no ticker de negociacao
• Desdobramento do ticker
• Na primeira execução, é intessante bater a custódia calculada com o que aparece na sua corretora

canal eletronico do investidor, CEI, selenium, bovespa, IRPF, IR, imposto de renda, finance, yahoo finance, acao, fii, etf, python, crawler, webscraping, calculadora ir

• https://br.advfn.com/investimentos/futuros/imposto-de-renda
• https://www.arenadopavini.com.br/acoes-na-arena/receita-permite-compensar-perdas-de-etf-com-ganhos-de-acoes