DEV Community

Lucas Almeida
Lucas Almeida

Posted on

Browser Use com Scrapeless: um navegador limpo para agentes de IA

#ai #api #automation #tooling

cover page

TL;DR:

  • O Browser Use controla o navegador com um LLM; o Scrapeless entrega uma identidade limpa. Aponte o cdp_url para o navegador em nuvem da Scrapeless e rode em Chromium real, com fingerprint consistente e saída residencial — sem mexer no agente.
  • Um navegador local denuncia automação em três frentes: navigator.webdriver, fingerprint padrão de headless e seu próprio IP de saída. Sistemas anti-bot costumam pontuar tudo junto.
  • A integração fica em uma linha: a URL de conexão. Monte wss://browser.scrapeless.com/api/v2/browser e entregue para Browser(cdp_url=...).
  • Acompanhe o agente ao vivo pela URL da sessão no Scrapeless Dashboard enquanto ele raciocina, clica e lê a página.
  • Validado ao vivo: um agente conectou via CDP, percorreu sete etapas e retornou o título da página pelo navegador em nuvem.
  • Dá para começar sem custo. Novas contas incluem runtime gratuito do Scraping Browser.

Introdução: dê ao seu agente um navegador que passa limpo

O Browser Use permite que um modelo de linguagem opere um navegador real: decide passos, clica nos elementos certos e lê a página. Em um Chrome local, o agente herda sinais fáceis de reconhecer: expõe a propriedade navigator.webdriver, carrega padrões de headless em fontes e canvas, e sai por um IP já avaliável.

Resolver isso localmente vira manutenção contínua: patches de stealth, ajustes a cada mudança do Chromium e reação aos anti-bots. O Browser Use conversa com qualquer navegador compatível com CDP por cdp_url, e o Scrapeless Scraping Browser expõe esse navegador por um único endpoint WebSocket. Na prática, runtime, fingerprint e IP vão para o servidor; no código, muda só a origem do navegador.

O que você consegue fazer com isso

  • Executar tarefas em sites com anti-bot — o navegador em nuvem resolve desafios durante a renderização.
  • Localizar o comportamento — fixe proxyCountry para ver a página como um visitante daquele mercado.
  • Escalar além da máquina local — as sessões rodam na nuvem, não no notebook.
  • Manter o código do agente igual — troque apenas a fonte do navegador; Agent, tarefa e LLM continuam os mesmos.
  • Depurar ao vivo — o Scrapeless Dashboard transmite a sessão em execução.

Por que usar o Scrapeless Scraping Browser

O Scrapeless Scraping Browser é um navegador em nuvem personalizável e com anti-detecção, feito para crawlers e agentes de IA. Para o Browser Use, ele adiciona:

  • Chromium real, desenvolvido pela própria equipe, executando JavaScript como Chrome, para resolver SPAs e desafios.
  • Fingerprint consistente por sessão — sem o indício de navigator.webdriver e sem os padrões clássicos de headless.
  • Saída residencial em mais de 195 países, escolhida por sessão com um único valor em proxyCountry.
  • Uma superfície CDP única — cada opção entra como query parameter no mesmo endpoint WebSocket.

Obtenha a chave de API no plano gratuito em app.scrapeless.com.

Pré-requisitos

  • Python 3.11 ou mais recente (o Browser Use exige 3.11+)
  • Uma chave de API da OpenAI para o modelo de linguagem do agente
  • Uma conta Scrapeless e uma chave de API em app.scrapeless.com

Os detalhes de conexão ficam na documentação do Scraping Browser.

Instalação 

pip install browser-use
Enter fullscreen mode Exit fullscreen mode

Para usar memória do agente em tarefas mais longas (Python < 3.13):

pip install "browser-use[memory]"
Enter fullscreen mode Exit fullscreen mode

Conecte seu agente ao navegador em nuvem

Monte a URL WebSocket da Scrapeless e passe para Browser(cdp_url=...). navigator.webdriver é um sinal que a especificação W3C WebDriver exige em drivers compatíveis — o navegador em nuvem não carrega esse marcador.

import os
from urllib.parse import urlencode
from browser_use import Browser

def scrapeless_browser() -> Browser:
    params = {
        "token": os.environ["SCRAPELESS_API_KEY"],
        "sessionTTL": 900,
        "proxyCountry": "ANY",
    }
    ws = f"wss://browser.scrapeless.com/api/v2/browser?{urlencode(params)}"
    return Browser(cdp_url=ws)
Enter fullscreen mode Exit fullscreen mode

Execute o agente

O Browser Use se conecta ao navegador em nuvem pelo Chrome DevTools Protocol, então o Agent roda exatamente como rodaria no ambiente local.

Observação: para executar este exemplo, você precisa de uma sessão Scrapeless ativa e de uma chave de API da OpenAI para agent.run().

import os
import asyncio
from urllib.parse import urlencode
from dotenv import load_dotenv
from browser_use import Agent, Browser, ChatOpenAI

def scrapeless_browser() -> Browser:
    params = {"token": os.environ["SCRAPELESS_API_KEY"], "sessionTTL": 900, "proxyCountry": "ANY"}
    ws = f"wss://browser.scrapeless.com/api/v2/browser?{urlencode(params)}"
    return Browser(cdp_url=ws)

async def main():
    load_dotenv()
    browser = scrapeless_browser()
    await browser.start()

    agent = Agent(
        task="Go to Google, search for 'Scrapeless', open the first result and return its title",
        llm=ChatOpenAI(model="gpt-4o"),
        browser=browser,
    )
    print(await agent.run())
    await browser.kill()

asyncio.run(main())
Enter fullscreen mode Exit fullscreen mode

O que você recebe de volta

Em uma execução real, o agente conectou pelo cdp_url, concluiu sete etapas e retornou o título — Effortless Web Scraping Toolkit for Business and Developers — pelo navegador em nuvem da Scrapeless. Pontos claros:

  • O sinal de navigator.webdriver não aparece, então a primeira checagem parece um Chrome comum.
  • O IP de saída acompanha proxyCountry — páginas geo-gated carregam como para um visitante local.
  • O agente se adapta — se um caminho de busca encontra desafio, o LLM pode escolher outra rota, porque interpreta a página em vez de seguir um script fixo.
  • Memória é opcional — ative com enable_memory=True no Agent em tarefas longas.

Conclusão: o mesmo agente, um navegador mais limpo

O Browser Use decide o que fazer; o Scrapeless define como o navegador aparece para o site. A integração é uma URL: monte wss://browser.scrapeless.com/api/v2/browser, passe para Browser(cdp_url=...) e rode o agente sem mudar a lógica principal. Para conectar mais de uma ferramenta Python ao mesmo navegador em nuvem, veja o guia sobre fingerprint não detectada e compare os planos na página de preços da Scrapeless.

Pronto para montar seu pipeline de scraping com agente de IA?

Para testar, crie a chave de API, gere a URL WebSocket e substitua o navegador local por Browser(cdp_url=<scrapeless url>). O Browser Use segue cuidando do raciocínio e das ações; o navegador em nuvem cuida da fingerprint, da sessão e da saída residencial.

FAQ

P: Preciso alterar o código do meu agente Browser Use?
Não. Você muda só de onde o navegador vem — troca o lançamento local por Browser(cdp_url=<scrapeless url>). O Agent, a tarefa e o LLM continuam iguais.

P: Por que não rodar apenas um Chrome local?
O Chrome local usa seu IP, declara automação via navigator.webdriver e exige patches de stealth. O Scrapeless é um navegador em nuvem gerenciado, com saída residencial integrada e fingerprint consistente — a mesma API, sem essa manutenção.

P: Preciso contratar um proxy separado?
Não. A saída residencial já vem integrada — defina proxyCountry para uma região específica ou use ANY.

P: Qual versão do Python eu preciso usar?
O Browser Use exige Python 3.11 ou mais recente; a memória do agente, além disso, precisa de Python abaixo de 3.13.

P: Consigo assistir ao agente em execução?
Sim. O Scrapeless Dashboard transmite a sessão ao vivo enquanto o agente raciocina e clica.

Top comments (0)