Automatizando Processos com Python e Google Colab: Consulta de CNPJs com RPA

Você já imaginou automatizar tarefas repetitivas, como buscar dados de empresas pela internet, em poucos minutos usando apenas seu navegador? Com Python + Google Colab, isso é totalmente possível — e sem instalar nada no seu computador!

Hoje vamos te mostrar como criar um RPA (Robotic Process Automation) simples, que consulta dados públicos de CNPJs usando uma API, organiza as informações em uma planilha e salva tudo automaticamente. Bora lá?

O que é RPA?

RPA é uma sigla para Robotic Process Automation — ou seja, automação de processos com “robôs de software”. Na prática, isso significa ensinar o computador a fazer por você tarefas manuais e repetitivas, como copiar dados de sites, preencher planilhas, enviar e-mails, entre outros.

E sabe o melhor? Você não precisa ser expert em programação para começar!

Por que usar o Google Colab?

O Google Colab é uma plataforma online que permite executar códigos Python direto no navegador, sem precisar instalar nada no seu computador. Ele é gratuito, permite acesso a bibliotecas poderosas e se integra facilmente com outros serviços do Google, como o Drive e o Sheets.

O que vamos construir?

Vamos criar um robô que:

Consulta uma lista de CNPJs na API pública da ReceitaWS;
Coleta informações como razão social, nome fantasia, atividade principal, cidade e UF;
Salva tudo em uma planilha Excel prontinha pra usar.

Passo a passo no Colab

1️⃣ Instale as bibliotecas necessárias

Abra um novo notebook no Google Colab e cole o código abaixo na primeira célula:

!pip install requests pandas gspread oauth2client

Essas bibliotecas vão nos ajudar a:

Fazer requisições para a API (requests);
Manipular os dados em formato de tabela (pandas);
Se comunicar com planilhas do Google (gspread + oauth2client, se quiser estender o projeto depois).

2️⃣ Importe as bibliotecas

import requests
import pandas as pd
import time
import gspread
from oauth2client.service_account import ServiceAccountCredentials

3️⃣ Liste os CNPJs que deseja consultar

Aqui você pode colocar quantos quiser (lembrando que a API gratuita tem limite de 3 consultas por minuto):

cnpjs = [
    "27865757000102", 
    "33400410000150",  
    "00360305000104", 
]

4️⃣ Crie uma função para consultar a API

Essa função acessa os dados de cada CNPJ usando a API pública da ReceitaWS:

def consultar_cnpj(cnpj):
    url = f"https://www.receitaws.com.br/v1/cnpj/{cnpj}"
    response = requests.get(url)
    if response.status_code == 200:
        return response.json()
    else:
        print(f"Erro ao consultar {cnpj}: {response.status_code}")
        return None

5️⃣ Faça a consulta dos CNPJs

Vamos consultar cada CNPJ com um intervalo de 20 segundos para respeitar o limite da API:

dados = []

for cnpj in cnpjs:
    print(f"Consultando {cnpj}...")
    resultado = consultar_cnpj(cnpj)
    if resultado:
        dados.append({
            "CNPJ": cnpj,
            "Razão Social": resultado.get("nome"),
            "Nome Fantasia": resultado.get("fantasia"),
            "Situação": resultado.get("situacao"),
            "Atividade Principal": resultado.get("atividade_principal", [{}])[0].get("text", ""),
            "UF": resultado.get("uf"),
            "Município": resultado.get("municipio")
        })
    time.sleep(20)  # pausa para evitar bloqueios

6️⃣ Organize os dados em uma planilha

df = pd.DataFrame(dados)
df.head()

Você já vai ver os dados organizados em forma de tabela!

7️⃣ Exporte para Excel

Agora, vamos salvar tudo em um arquivo Excel:

excel_path = "/content/dados_cnpj.xlsx"
df.to_excel(excel_path, index=False)
print(f"✅ Arquivo Excel gerado em: {excel_path}")

Você pode baixar o arquivo clicando nele no painel esquerdo do Colab (ícone de pasta).

E onde isso pode ser útil?

Esse tipo de automação pode facilitar MUITO o dia a dia em:

Departamentos administrativos: consulta de fornecedores, validação de empresas;
Contabilidade: conferência rápida de situação cadastral;
Comercial: preparação de listas para prospecção B2B;
Startups e freelancers: análise de mercado e concorrentes;
Ensino: mostrar automação prática em sala de aula!

E o melhor: você pode adaptar esse código para ler os CNPJs de uma planilha no Google Sheets, ou até enviar os resultados direto para lá — tudo com Python no Colab!

RPA é para todos!

Automatizar tarefas com Python não é só para programadores. Com ferramentas acessíveis como o Google Colab e APIs abertas como a ReceitaWS, você pode transformar processos manuais em soluções inteligentes com poucas linhas de código.

Se você curtiu esse exemplo e quer ver mais automações com planilhas, e-mails ou sites, deixa nos comentários!