O FinanceScraperAPI é uma solução automatizada para coleta e disponibilização de indicadores fundamentalistas de ações, como VPA (Valor Patrimonial por Ação), LPA (Lucro por Ação) e Dividend Yield (DivY).
💡 O projeto surgiu para contornar uma limitação do Google Finance, que não disponibiliza esses indicadores diretamente em planilhas do Google Sheets.
Essa API é consumida diretamente no Google Sheets, permitindo criar fórmulas personalizadas para análise de investimentos.
Criar uma ponte entre dados financeiros indisponíveis em ferramentas tradicionais e o ambiente de análise do usuário, permitindo:
Utilizado para automatizar a navegação e extração de dados diretamente de sites financeiros.
Responsável por hospedar os dados em formato JSON, simulando uma API pública acessível via HTTP. Formato leve e estruturado utilizado para disponibilizar os dados coletados.
Utilizado para consumir a API e montar dashboards e análises financeiras personalizadas.
Permite integrar chamadas HTTP dentro da planilha, automatizando a leitura dos dados da API.
git clone https://github.com/seu-usuario/FinanceScraperAPI.git
cd stockmetrics-api
Certifique-se de ter o Python 3 instalado e execute:
pip install selenium
O projeto utiliza o Google Chrome em modo headless.
Você precisa ter:
- Google Chrome instalado
- ChromeDriver compatível com sua versão
No código, localize a variável:
TICKERS = [ "PETR3", "VALE3", "ITUB3" ]
Adicione ou remova as ações conforme sua necessidade.
O script utiliza um arquivo local:
gitPages.json
Esse arquivo:
- Armazena os dados coletados
- Evita perda de informações anteriores
- Estrutura os dados no formato de "API"
Exemplo de saída:
{ "FinanceScraperAPI": { "PETR3": { "LPA": "2,15", "VPA": "18,30", "Div Yield": "12,45%" } } }
python main.py
O script irá:
- Acessar o site Status Invest
- Coletar os dados de cada ação:
- Dividend Yield
- LPA
- VPA
- Aplicar tratamento (ex: troca de ponto por vírgula)
- Atualizar o arquivo gitPages.json
Para cada ticker, o sistema:
- Abre a página da ação
- Aguarda entre 3 a 6 segundos (delay aleatório)
- Faz scraping usando XPath
- Armazena os dados estruturados em JSON
Após rodar o script:
- Faça commit do arquivo gitPages.json
- Envie para o repositório:
git add .
git commit -m "update data"
git push
- Ative o GitHub Pages no repositório
Agora o JSON estará disponível via URL pública, funcionando como uma API.
Você pode consumir os dados usando:
- Apps Script (UrlFetchApp)
- Ou funções personalizadas
Isso permite montar dashboards automáticos com:
- Dividend Yield
- LPA
- VPA
- O scraping depende da estrutura do site
- Mudanças no layout podem quebrar o código
- O uso de time.sleep ajuda a evitar bloqueios
- O script roda em modo headless (sem abrir o navegador)
| Planilha Google Sheets |
 |
| GitHubPages como API |
|
Desenvolvido por Enzo Rincon
📍 Localização: São Paulo
💼 Áreas de interesse: Desenvolvimento Fullstack.
📢 Aberto a oportunidades profissionais na área de desenvolvimento
Curtiu o projeto? Quer dar um feedback, trocar ideia sobre tecnologia ou até falar de vagas?
Tô sempre aberto a conversar! É só me chamar nos links aí embaixo 👇
| 📧 E-mail: | enzorincon2003@gmail.com |
| 💼 LinkedIn: | linkedin.com/in/enzorincon |
| 📷 Instagram: | @enzo.rincon |
| 🌐 Portifólio: | https://rincon23.github.io/ |
⭐ Obrigado por visitar este projeto! ⭐