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

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

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

pip install "browser-use[memory]"

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)

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())

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.