Voltar à biblioteca

Tutorial · Agentes de IA · Automação · Cerca de 11 min de leitura

Reverse API Engineer: puxe os dados de um site pelos pedidos que ele faz por trás

Ferramenta grátis e de código aberto (MIT): você diz o site e o dado, uma IA navega, grava os pedidos escondidos que o site faz e escreve o código pra buscar tudo de novo. Instalação, IA paga ou grátis, modo coletor para CSV, todas as opções e os limites honestos. Nem todo site; só site seu, autorizado ou com dados públicos.

Começar tutorial
Paulo Cauhi · Conferido em

Prefere em PDF? Receba no seu e-mail.

Você recebe o PDF e os próximos guias por e-mail. Cancele quando quiser. Privacidade

Comentou REVERSO? Aqui está o link e o passo a passo. O Reverse API Engineer é uma ferramenta grátis e de código aberto que puxa os dados de um site pelos mesmos pedidos que o próprio site faz por trás, mesmo quando ele não oferece um acesso oficial. Você diz o site e o dado que quer, a IA navega, observa esses pedidos e escreve um código pra buscar tudo de novo quando você quiser.

banner: Banner oficial do Reverse API Engineer, com a marca rae e a frase Turn websites into APIs, do repositório do projeto (licença MIT).

O banner oficial do projeto (licença MIT, kalil0321).

Antes de tudo, quatro verdades:

  • A ferramenta é grátis (licença MIT), mas precisa de uma IA conectada. A padrão é o Claude, que é pago (por uso, com chave de API). Existe caminho com modelo gratuito pelo OpenCode (veja o passo 3).
  • Não é “qualquer site”. O próprio README avisa: site com detecção forte de robô pode bloquear a captura ou pedir que você interaja na mão.
  • Use só em site seu, autorizado ou com dados públicos. Muitos sites proíbem extração automática nos termos de uso, e dados pessoais caem na LGPD.
  • Os passos vêm da documentação oficial e NÃO FORAM TESTADOS POR NÓS. Não instalamos nem rodamos a ferramenta para escrever este guia. As imagens são capturas de páginas públicas.
O que éDetalhe
NomeReverse API Engineer (apelido rae)
Quem fezKalil (kalil0321), dev de Zurique, Suíça
LicençaMIT: grátis para usar, copiar e modificar, mantendo o aviso de licença
Funciona comClaude Code (padrão), Cursor, GitHub Copilot e OpenCode (inclusive com modelo grátis)
Gera código em10 linguagens: Python (padrão), JavaScript, TypeScript, Go, Java, C#, PHP, Ruby, C e PowerShell
Onde rodaNo seu computador: Mac com chip Apple, Windows 64 bits ou Linux. Não roda em Mac Intel nem celular
Versãov0.14.0 (23/09/2026), atualizada em 27/10/2026 (consultado em 28/10/2026)

Como funciona, em palavras simples

Todo site, quando carrega, faz pedidos escondidos ao servidor para buscar os dados (preços, fotos, textos). Esse “canal” por onde os pedidos passam é a API: pense num garçom que leva o pedido da página até a cozinha e volta com os dados.

Muitos sites não oferecem uma API pública, mas a página usa uma por dentro. O Reverse API Engineer faz engenharia reversa (desmontar pra entender como funciona):

  1. Você escreve o objetivo, tipo “pega o nome e o preço dos produtos desta página”.
  2. Um navegador abre o site. Você navega, ou um agente de IA navega sozinho (clica, pesquisa, passa as páginas).
  3. A ferramenta grava todos os pedidos que o site faz nesse tempo.
  4. A IA lê esses pedidos, descobre qual deles traz o dado que você quer e escreve um código que faz esse mesmo pedido direto, sem abrir o site de novo.

Por isso não depende do visual da página: se o site mudar o design, o código continua pedindo direto pra cozinha. Mas não é “nunca quebra”: se o site mudar os próprios pedidos internos, o código precisa ser refeito.

Quer ver a “cozinha” com os próprios olhos? O site de treino quotes.toscrape.com/scroll foi feito justamente para quem está aprendendo a coletar dados. Quando você desce a página, ela busca mais frases por um pedido escondido. Abra esse pedido direto no navegador: quotes.toscrape.com/api/quotes?page=1. Aparecem as frases, os autores e as tags em texto puro (formato JSON), sem o visual da página. É exatamente esse tipo de pedido que a ferramenta procura (conferimos o endereço em 28/10/2026; isso não é um teste da ferramenta).

site-de-treino: Página pública quotes.toscrape.com/scroll, um site de treino que carrega frases de pessoas famosas conforme você rola a página, capturada em 28/10/2026.

O site de treino, capturado em 28/10/2026. Os exemplos deste guia usam ele de propósito: foi feito para isso.

O caminho mais simples

Passo da documentação, não testado por nós. Você vai precisar de um computador (Mac com chip Apple, Windows 64 bits ou Linux) e de colar alguns comandos no Terminal (no Mac: aplicativo Terminal; no Windows: PowerShell). Não precisa saber programar: é copiar, colar e apertar Enter.

Instale o uv (o instalador recomendado)

O projeto recomenda instalar pelo uv, um instalador de ferramentas Python. Se você já tem, pule.

Mac ou Linux:

Terminal
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

Terminal
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Feche e abra o Terminal de novo depois de instalar. (Comandos da documentação oficial do uv.)

O modo agente (a IA navegando sozinha) também precisa do Node.js 20 ou mais novo: baixe o instalador “LTS” em nodejs.org.

Instale o Reverse API Engineer

Um comando:

Terminal
uv tool install reverse-api-engineer

Para conferir se deu certo (deve aparecer um número de versão):

Terminal
reverse-api-engineer --version

Se disser que o comando não existe, feche e abra o Terminal de novo.

Conecte uma IA (paga ou grátis)

A ferramenta é só o “motor”: quem lê os pedidos e escreve o código é a IA que você conectar. Escolha uma:

Opção A: Claude (o padrão, pago). Crie uma chave de API no console da Anthropic, coloque crédito e informe a chave no Terminal antes de abrir a ferramenta (troque o texto pela sua chave; no Windows, use $env:ANTHROPIC_API_KEY="sua-chave"):

Terminal
export ANTHROPIC_API_KEY=sua-chave-aqui

O modelo padrão é o Claude Sonnet 4.6, cobrado por uso: em 28/10/2026, US$ 3 por milhão de tokens de entrada e US$ 15 por milhão de saída (preços da Anthropic). Quanto custa cada captura depende do tamanho do site; a ferramenta mostra o custo de cada execução em /history. Nunca cole a sua chave em sites ou mensagens.

Opção B: modelo grátis pelo OpenCode. Dentro da ferramenta, digite /settings, escolha SDK e troque para opencode. Segundo a documentação, ela baixa e liga o OpenCode sozinha (precisa do Node.js 20+) e, numa configuração nova, usa o modelo gratuito big-pickle. Modelos grátis costumam ser mais fracos e a lista muda; a própria ferramenta mostra quais estão disponíveis.

Também dá para usar Cursor ou GitHub Copilot (se você já assina um deles) ou um modelo local pelo Ollama, sempre em /settings.

Peça o dado e deixe a IA navegar

Abra a ferramenta:

Terminal
reverse-api-engineer

Ela já começa no modo agente (a IA navega sozinha). Escreva o que você quer, em palavras simples, e aperte Enter. Um pedido de exemplo, escrito por nós, usando o site de treino:

Pedido de exemplo
Pegue as frases, os autores e as tags do site https://quotes.toscrape.com/scroll e gere um código que busque as 3 primeiras páginas

Um navegador abre, a IA navega e grava os pedidos. No fim, segundo o README, aparece uma pasta scripts/ com o código gerado (api_client.py), um README explicando e um exemplo de uso (example_usage.py).

Prefere navegar você mesmo? Aperte Shift+Tab para trocar de modo (agent → manual → engineer → collector). No manual, você navega, fecha o navegador e a IA escreve o código. Esse modo precisa de um extra (veja “Para quem quer ir além”).

Quer uma planilha? Use o modo coletor

O modo normal entrega código, não planilha. Para sair com uma tabela, use o modo collector (aperte Shift+Tab até aparecer collector) e descreva o que quer juntar. Ele salva os dados em JSON e CSV numa pasta collected/. O arquivo CSV abre no Excel e no Google Sheets (no Sheets: Arquivo → Importar).

Duas observações honestas: no código atual, o coletor usa o Claude (não o modelo grátis) e trabalha com busca e leitura de páginas na web, não com a gravação dos pedidos do navegador. Os nomes dos arquivos variam entre a documentação (items.csv) e o código atual (data.csv).

O que é verdade (e o que o vídeo simplificou)

  • “Transforma qualquer site numa API” / “dados de qualquer site”: exagero. Sites com detecção forte de robô podem bloquear a captura ou pedir interação manual (README, “Caveats”). Na tela do vídeo: “nem todo site”.
  • “Ferramenta grátis”: a ferramenta é grátis (MIT). A IA que ela usa pode ser paga (Claude, o padrão) ou grátis (OpenCode com big-pickle, ou modelo local pelo Ollama).
  • “Se a loja mudar o visual, continua funcionando”: meia verdade. Não depende do visual, mas o site pode mudar os pedidos internos, e aí o código precisa ser refeito.
  • “Sai tudo numa planilha do Excel ou do Google Sheets”: a planilha vem do modo coletor, que salva CSV (abre no Excel e no Sheets). O modo normal gera código.
  • A loja do vídeo é ilustrativa (“loja-exemplo.com.br”): produtos, preços e pedidos na tela são exemplos do mecanismo, não uma loja real nem um teste nosso.
  • O nome é Reverse API Engineer (no vídeo, falado como “Reverse API Engineering”).

Para quem quer ir além

Opcional, para quem usa terminal. Comandos do README e da documentação do projeto (commit de 27/10/2026), passo da documentação, não testado por nós.

Instalar com pip (em vez do uv; precisa de Python 3.11+):

Terminal
pip install reverse-api-engineer

Modo manual (você navega num Chromium local): instale o extra e o navegador.

Terminal
uv tool install "reverse-api-engineer[manual]"
Terminal
playwright install chromium

Os 4 modos (troque com Shift+Tab):

ModoO que faz
agentPadrão. A IA dirige o navegador (Playwright MCP, seu Chrome real ou o agent-browser da Vercel)
manualVocê navega; ao fechar o navegador, a IA gera o código a partir dos pedidos gravados (arquivo HAR)
engineerGera o código de novo a partir de uma captura anterior (engineer <run_id>), sem navegar de novo
collectorA IA junta dados estruturados com busca e leitura de páginas e exporta JSON e CSV

Rodar sem a tela interativa (bom para automação; --json devolve um resultado legível por outros programas):

Terminal
reverse-api-engineer agent --prompt "capture a API pública das frases" --url https://quotes.toscrape.com/scroll --json

Para testar a configuração sem abrir navegador (confere pedido, endereço, IA, Node.js e pasta de saída):

Terminal
reverse-api-engineer agent --prompt "capture a API pública das frases" --url https://quotes.toscrape.com/scroll --dry-run

Coletor direto pela linha de comando:

Terminal
reverse-api-engineer collector --prompt "junte as frases e os autores de quotes.toscrape.com"

Rodar de novo um código gerado (instala o que faltar sozinho):

Terminal
reverse-api-engineer run <run_id> --file api_client.py --no-interactive --auto-install

Outros comandos: reverse-api-engineer list --json (lista as execuções), reverse-api-engineer show <run_id> --json (detalhes de uma). Dentro da ferramenta: /settings (IA, modelo, modo do agente, linguagem), /history (execuções com custo), /messages <run_id> (o que a IA fez), /help, /exit.

Usar o seu Chrome de verdade (para manter as sessões em que você já está logado, em sites onde isso é permitido): em /settings, “agent provider” → chrome-mcp. Precisa do Chrome 146+, do Node.js 20.19+ e de ligar a conexão automática em chrome://inspect/#remote-debugging.

Configuração em ~/.reverse-api/config.json (ou pelo /settings). Os campos principais, com os valores padrão do README:

{
  "sdk": "claude",
  "claude_code_model": "claude-sonnet-4-6",
  "collector_model": "claude-sonnet-4-6",
  "opencode_provider": "opencode",
  "opencode_model": "big-pickle",
  "agent_provider": "auto",
  "output_language": "python",
  "output_dir": null
}
  • sdk: claude (padrão), opencode, cursor ou copilot.
  • output_language: python, javascript, typescript, go, java, csharp, php, ruby, c ou powershell.
  • Ollama (modelo local, grátis): em /settings, provedor do OpenCode → ollama. Só aparecem modelos já instalados com uso de ferramentas e 64 mil tokens de contexto ou mais; baixe antes com ollama pull <modelo>.
  • Onde ficam os arquivos: ~/.reverse-api/runs/scripts/{run_id}/ (cópia permanente) e ./scripts/{nome}/ na pasta onde você abriu a ferramenta; coletor em ./collected/{pasta}/.
  • Erro estranho? Rode com a variável RAE_DEBUG=1 para ver o detalhe técnico.

Exemplos prontos do próprio projeto (código gerado pela ferramenta e publicado pelo autor, MIT): Apple (vagas), Uber (vagas), IKEA (busca e preços de produtos), AutoScout24 (anúncios de carros), Ashby e Mintlify. Baixe aqui, com o README e a licença: exemplos do Reverse API Engineer (ZIP, 87 KB). Servem para ver como fica o código gerado; sites reais mudam, então eles podem já não funcionar.

Perguntas rápidas

Precisa saber programar?

Para instalar e pedir, não: é copiar comandos, colar e escrever o que você quer em palavras simples. Mas o resultado normal é código (Python, por padrão). Para usar esse código no dia a dia, ajuda muito ter alguém ou uma IA que explique e rode por você. O modo coletor entrega CSV, que abre no Excel ou no Google Sheets.

É grátis?

A ferramenta é grátis (MIT). A IA conectada é à parte: o Claude (padrão) é pago por uso; em 28/10/2026, o Sonnet 4.6 custava US$ 3 por milhão de tokens de entrada e US$ 15 por milhão de saída. Há caminho grátis com o OpenCode (modelo big-pickle) ou um modelo local pelo Ollama. O modo coletor, no código atual, usa o Claude.

Funciona no meu computador? E no celular?

Funciona em Mac com chip Apple (M1 ou mais novo), Windows 64 bits e Linux. Não funciona em Mac Intel, Windows 32 bits nem no celular (é uma ferramenta de computador, de terminal).

É seguro?

Depende do uso:

  • Tudo roda na sua máquina, sem conta e sem servidor do projeto (reverseapi.dev). Mas os pedidos gravados (inclusive cookies e senhas de sessão, se você navegar logado) vão para a IA que você configurou para gerar o código (documentação do modo manual).
  • Revise o código gerado antes de rodar (README, “Caveats”): ele roda no seu computador.
  • Respeite as regras do site: use em site seu, autorizado ou com dados públicos. Muitos sites proíbem extração automática nos termos de uso, e dados pessoais exigem base legal pela LGPD.
  • Nunca compartilhe a sua chave de API.

Funciona em site com login, como redes sociais?

Não indicamos. Isso não foi verificado e redes como LinkedIn, Instagram e Reddit proíbem coleta automática nos termos delas.

Limites honestos

  • Nem todo site: bloqueio forte de robô pode barrar a captura ou exigir que você interaja na mão.
  • Não é “nunca quebra”: não depende do visual, mas o site pode mudar os pedidos internos.
  • Precisa de uma IA conectada. A padrão (Claude) é paga; os modelos grátis costumam ser mais fracos.
  • O resultado é código, que você precisa revisar e rodar. A planilha vem do modo coletor.
  • Computador obrigatório: sem Mac Intel, sem Windows 32 bits, sem celular.
  • Os números (versão, 10 linguagens, preços) foram consultados em 28/10/2026 e mudam. Não medimos nada e não testamos a ferramenta.

Créditos e fonte

  • Projeto: Reverse API Engineer, de Kalil (kalil0321). Copyright (c) 2025 kalil0321, licença MIT. O banner e os exemplos desta página vêm do repositório no commit 4e15017 (27/10/2026), sem alterações.
  • Por que ele fez: no post do autor no DEV (31/12/2025), ele conta que precisava de dados de vagas para um mapa de empregos e fazia tudo na mão: abria as ferramentas do navegador, copiava os pedidos, colava no Claude e montava o código. “Funcionava, mas era muito repetitivo.” Então automatizou.
  • Fonte oficial: github.com/kalil0321/reverse-api-engineer e o site reverseapi.dev.
  • Site de treino: toscrape.com, sandbox público feito para aprender coleta de dados.
  • Preços do Claude: platform.claude.com (consultado em 28/10/2026).
  • Este guia não é afiliado ao autor nem à Anthropic.

site: Página pública reverseapi.dev com a frase Turn websites into APIs e o comando de instalação uv tool install reverse-api-engineer, capturada em 28/10/2026.

Página pública reverseapi.dev, capturada em 28/10/2026.

post-criador: Post público do autor Kalil no DEV, Reverse-engineering undocumented APIs with Claude, de 31/12/2025, capturado em 28/10/2026.

O post do autor contando por que criou a ferramenta, capturado em 28/10/2026.

github-repo: Página pública do projeto Reverse API Engineer no GitHub, capturada em 28/10/2026.

Página pública do projeto no GitHub, capturada em 28/10/2026.

Continue aprendendo

Escolha um próximo passo prático.

Voltar à biblioteca

Baixe o guia em PDF

Receba o PDF deste guia e os próximos guias práticos por e-mail.

Você recebe o PDF e os próximos guias por e-mail. Cancele quando quiser. Privacidade

Comentários

Comentários

Ficou com alguma dúvida ou tem algo a acrescentar? Participe da conversa.

Sem precisar de conta. Clique em Entrar e escolha um nome para comentar.

Carregando a conversa…

Privacidade dos comentáriosDiretrizes para comentários