Fundamentus Data Scraping

Esse repositório tem o objetivo de extrair dados fundamentalistas de ações da bolsa brasileira a partir do site Fundamentus.

Dados Extraídos

O script script.py extrai os seguintes dados para o ativo especificado:

Os dados são extraídos da página de detalhes do ativo no Fundamentus.

É recomendado usar um ambiente virtual para isolar as dependências deste projeto. Para criar e ativar um ambiente virtual:

# Criar ambiente virtual
python3 -m venv venv

# Ativar ambiente virtual
source venv/bin/activate  # No Linux
venv\Scripts\activate     # No Windows

Depois de ativar o ambiente virtual, instale as dependências com:

pip install -r requirements.txt

As dependências do projeto estão listadas no arquivo requirements.txt:

Instale todas as dependências de uma vez usando pip install -r requirements.txt (de preferência dentro do seu ambiente virtual).

Para extrair os dados de um ativo, rode o script passando o código do ativo como argumento:

python script.py CODIGO_DO_ATIVO

Por exemplo, para o ativo ABEV3:

python script.py ABEV3

Os dados extraídos serão salvos na pasta output em dois formatos:

Aqui estão alguns planos e ideias para melhorias futuras deste projeto:

Integração com modelos de linguagem (LLMs) como OpenAI, Groq e DeepSeek para gerar agentes que possam analisar os dados fundamentalistas extraídos e sugerir boas opções de investimento.
Geração de gráficos e relatórios a partir dos dados extraídos para facilitar a visualização e análise das informações fundamentalistas.
Adição de funcionalidade para comparar os dados fundamentalistas do ativo especificado com outros papéis de categoria similar, fornecendo mais contexto para a análise.
Aprimoramento do script para coletar dados históricos e acompanhar a evolução dos indicadores fundamentalistas ao longo do tempo.
Criação de uma interface web amigável para permitir que usuários menos técnicos possam facilmente extrair e analisar dados fundamentalistas.
Expansão da cobertura para incluir ações de outras bolsas além da B3, como bolsas internacionais.

Sinta-se à vontade para abrir issues ou pull requests se tiver sugestões ou quiser contribuir com esses planos!

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.