Como referenciar este texto: Automatizando a carteira do IBOVESPA no Google Planilhas. Rodrigo Terra. Publicado em: 11/06/2026. Link da postagem: https://www.makerzine.com.br/dados/automatizando-a-carteira-do-ibovespa-no-google-planilhas/.

---

 

Automatizando a carteira do IBOVESPA no Google Planilhas

Este projeto nasceu de uma necessidade bastante prática: manter uma planilha atualizada com os papéis que compõem o índice IBOVESPA, sem precisar copiar e colar informações manualmente sempre que a composição da carteira fosse alterada.

A ideia foi criar uma solução simples, gratuita e funcional usando o Google Planilhas, Google Apps Script, dados públicos da B3 e a função GOOGLEFINANCE. O objetivo não era construir uma plataforma profissional de análise financeira, mas sim desenvolver uma ferramenta útil para acompanhamento, triagem e organização de dados de ações brasileiras.

Este projeto faz parte do meu portfólio na área de dados porque reúne automação, coleta de informações, tratamento de dados, cálculo de indicadores e documentação técnica em um repositório público.

 

O código completo está disponível no GitHub:

Acessar o repositório do projeto no GitHub

 

Contexto do projeto

Eu queria montar uma planilha que trouxesse automaticamente os ativos do IBOVESPA e algumas informações complementares, especialmente relacionadas a proventos. A planilha deveria ser simples, fácil de atualizar e baseada em recursos gratuitos.

A estrutura final da planilha ficou organizada com as seguintes colunas:

Coluna	Informação
A	Código do papel
B	Nome da ação/empresa
C	Tipo do papel
D	Cotação atual
E	DY calculado
F	Data do último pagamento de proventos

A proposta foi deixar a coluna de cotação sob responsabilidade do próprio Google Planilhas, usando a função GOOGLEFINANCE, enquanto o script atualiza as demais informações.

 

Problema que o projeto resolve

Quem trabalha com dados financeiros em planilhas sabe que a parte mais trabalhosa nem sempre é a análise em si, mas a atualização da base. Quando os papéis mudam, é necessário revisar códigos, conferir informações, atualizar links, verificar pagamentos recentes e garantir que a planilha continue coerente.

Neste projeto, a atualização passou a ser automatizada. Com um clique no menu criado pelo Apps Script, a planilha busca a composição atual do IBOVESPA, preenche os códigos dos papéis, os nomes das ações, os tipos e atualiza os dados de proventos.

Com isso, a planilha pode ser usada como uma base inicial para análise, acompanhamento ou estudo de ações brasileiras.

 

Fontes de dados utilizadas

O projeto utiliza fontes gratuitas e acessíveis:

• B3: usada para buscar a composição atual da carteira do IBOVESPA e os registros de proventos.
• GOOGLEFINANCE: usado na própria planilha para obter a cotação atual dos papéis.
• Yahoo Finance: usado apenas como alternativa de apoio no cálculo do DY, caso a cotação ainda não tenha carregado na planilha no momento da execução.

Durante o desenvolvimento, também foram avaliadas outras alternativas, como fórmulas com IMPORTXML, IMPORTHTML e páginas de dados fundamentalistas. No entanto, essas abordagens se mostraram menos estáveis para atualização recorrente dentro do Google Planilhas.

 

Por que usar Apps Script?

O Google Apps Script foi escolhido porque permite transformar a planilha em uma pequena aplicação automatizada. Em vez de depender de várias fórmulas espalhadas pela planilha, o script concentra a lógica de atualização em um único lugar.

Com o Apps Script, foi possível:

• criar um menu personalizado dentro do Google Planilhas;
• buscar a carteira atual do IBOVESPA na B3;
• limpar apenas as colunas necessárias;
• preservar a coluna de cotação;
• consultar registros de proventos;
• calcular um DY aproximado;
• preencher a data do último pagamento;
• criar uma rotina de atualização diária.

 

Estratégia adotada para a cotação

Um ponto importante do projeto foi a decisão de não deixar o script escrever a fórmula de cotação. Isso aconteceu porque o Google Planilhas pode apresentar diferenças de localidade, especialmente entre fórmulas em português e inglês, além do uso de vírgula ou ponto e vírgula como separador.

Por isso, a coluna D, chamada Cotação, ficou sob controle manual da planilha. A fórmula usada é:

=SE(A2="";"";GOOGLEFINANCE(CONCATENAR("BVMF:";A2);"PRICE"))

O script não apaga, não sobrescreve e não copia nada nessa coluna. Ele apenas lê a cotação atual para calcular o DY.

 

Como o DY é calculado

O Dividend Yield exibido na planilha não é copiado diretamente de uma fonte externa. Ele é calculado pelo próprio script, a partir dos registros de proventos encontrados e da cotação atual do papel.

A lógica usada é:

DY = soma dos proventos pagos nos últimos 12 meses / cotação atual

Por exemplo:

Cotação atual: R$ 20,00

Proventos pagos nos últimos 12 meses:
R$ 0,30
R$ 0,20
R$ 0,50

Soma dos proventos: R$ 1,00

DY = 1,00 / 20,00
DY = 0,05
DY = 5,00%

Esse valor deve ser entendido como um indicador prático, e não como uma métrica oficial ou definitiva de valuation. Ele serve para indicar se o papel possui histórico recente de pagamento e se vale uma análise manual mais detalhada.

 

Data do último pagamento

A coluna Data Último Pag é preenchida a partir dos registros de proventos obtidos na B3. O script procura a data mais recente de pagamento já realizado e preenche essa informação na planilha.

No meu uso, essa data é especialmente útil para identificar rapidamente quais ações já tiveram pagamento de proventos no ano atual.

 

Fluxo de funcionamento da automação

O funcionamento geral da automação pode ser resumido da seguinte forma:

1. O usuário executa a atualização pelo menu personalizado criado na planilha.
2. O script busca a composição atual do IBOVESPA.
3. A planilha recebe os códigos dos papéis, nomes das ações e tipos.
4. A coluna de cotação continua sendo calculada pela própria fórmula do Google Planilhas.
5. O script consulta os registros de proventos.
6. Com base nesses registros, ele identifica a data do último pagamento.
7. O script soma os proventos pagos nos últimos 12 meses.
8. Por fim, calcula o DY aproximado usando a cotação atual.

O resultado é uma base atualizada que pode ser usada para análise inicial dos papéis do IBOVESPA.

 

Por que não usar apenas fórmulas?

Uma das primeiras tentativas foi resolver tudo apenas com fórmulas do Google Planilhas, usando recursos como IMPORTHTML, IMPORTXML e GOOGLEFINANCE.

Para a cotação, o GOOGLEFINANCE funcionou bem. Porém, para Dividend Yield e data de pagamento de proventos, as fórmulas se mostraram instáveis. Em alguns casos, as células não carregavam corretamente; em outros, a fonte não respondia bem; e, em vários momentos, a manutenção da planilha ficava mais trabalhosa do que a automação em si.

Por isso, a estratégia final foi híbrida: usar fórmula apenas onde ela funciona bem e usar Apps Script para as partes que exigem mais controle.

 

Cuidados durante o desenvolvimento

Durante a construção da solução, alguns ajustes foram necessários. Um deles foi separar completamente a coluna de cotação da lógica do script. Isso tornou a automação mais segura, pois evitou conflitos com fórmulas em português no Google Planilhas.

Outro cuidado foi evitar ferramentas pagas. A proposta era manter uma solução acessível, replicável e baseada em recursos gratuitos. Por isso, a versão final não depende de APIs comerciais pagas.

Também foi importante deixar claro que o DY calculado é uma aproximação. Ele cumpre bem o papel de triagem, mas não deve ser interpretado como dado financeiro oficial.

 

Resultado final

Ao final, a planilha passou a atualizar automaticamente os ativos do IBOVESPA, mantendo a cotação via GOOGLEFINANCE e preenchendo as colunas de DY e data do último pagamento de proventos.

O resultado é uma ferramenta simples, mas bastante útil para acompanhamento inicial de ações brasileiras. Ela também funciona como um bom exemplo de integração entre planilhas, scripts e dados públicos.

 

O papel deste projeto no meu portfólio

Este projeto entra no meu portfólio na categoria Dados porque ele combina automação, coleta de informações, organização de dados e criação de indicadores simples para apoiar uma análise inicial.

Embora a solução seja construída dentro do Google Planilhas, ela não é apenas uma planilha. O projeto envolve uma pequena arquitetura de atualização automática, com integração entre diferentes fontes, tratamento de dados e uma lógica de cálculo própria para facilitar a leitura das informações.

Para mim, esse tipo de projeto é importante porque mostra uma competência que considero essencial na área de dados: transformar uma necessidade prática em uma solução simples, documentada e reutilizável.

 

Competências demonstradas no projeto

Do ponto de vista de portfólio, este projeto demonstra competências importantes para trabalhos com dados e automação:

• automação de processos em planilhas;
• uso de Google Apps Script;
• integração com fontes externas de dados;
• tratamento e padronização de dados;
• cálculo de indicadores financeiros simples;
• organização de uma solução reutilizável;
• documentação técnica em repositório público;
• publicação de projeto no GitHub.

Além da parte técnica, o projeto também mostra a importância de testar alternativas, abandonar caminhos que não funcionam bem e simplificar a solução quando necessário.

 

Limitações conhecidas

Como todo projeto que depende de dados públicos e fontes externas, esta solução possui algumas limitações.

A primeira limitação é que os dados dependem da disponibilidade das fontes consultadas. Se a B3 alterar a estrutura dos dados ou os endpoints usados pelas páginas, o script pode precisar de ajustes.

A segunda limitação está relacionada à cotação. O GOOGLEFINANCE pode ter atraso, indisponibilidade temporária ou retornar valores diferentes de outras plataformas financeiras.

A terceira limitação está no próprio cálculo do DY. O valor calculado pelo script é uma aproximação baseada na soma dos proventos pagos nos últimos 12 meses dividida pela cotação atual. Esse número pode ser diferente do DY apresentado por sites especializados, bancos ou corretoras.

Por isso, o DY da planilha deve ser usado como um indicador de triagem, e não como uma informação oficial ou definitiva.

 

Possíveis melhorias futuras

Algumas melhorias podem ser adicionadas em versões futuras do projeto.

• Adicionar uma coluna indicando se o papel pagou proventos no ano atual.
• Separar dividendos, juros sobre capital próprio e outros tipos de proventos.
• Criar uma aba de histórico com todos os pagamentos encontrados.
• Adicionar filtros automáticos para destacar os papéis com pagamentos mais recentes.
• Criar uma versão com dashboard dentro do próprio Google Planilhas.
• Permitir comparação entre DY calculado e DY de outras fontes públicas.
• Registrar logs de atualização em uma aba separada.

Essas melhorias podem transformar a planilha em uma ferramenta mais completa de acompanhamento, mas a versão atual já atende bem ao objetivo principal: automatizar a atualização da carteira do IBOVESPA e indicar pagamentos recentes de proventos.

 

Repositório do projeto

O código completo está disponível no GitHub, junto com o arquivo README.md explicando a instalação, a estrutura da planilha e o funcionamento da automação.

Acesse o repositório no GitHub

No repositório estão disponíveis:

• o script completo em Google Apps Script;
• as instruções de instalação;
• a fórmula usada para cotação;
• a explicação do cálculo do DY;
• as limitações conhecidas da solução.