Início rápido: Headless Browser

Comece a usar o Headless Browser da Oxylabs em apenas alguns minutos com um guia simples passo a passo.

Já está familiarizado com o básico? Confira a documentação do Headless Browser.

Oxylabs Headless Browser é uma infraestrutura de navegador hospedada na nuvem que lida automaticamente com sistemas anti-bot, CAPTCHAs e rotação de proxies. É totalmente compatível com Playwright, Puppeteer e o Model Context Protocol (MCP) para aplicações de IA.

1

Configuração e credenciais

1. Crie uma conta: Cadastre-se no Oxylabs Dashboard.

2. Escolha um plano: Selecione um plano ou teste gratuito em Scraping Solutions → Headless Browser.

3. Crie credenciais de usuário: Vá até a aba Users na seção do produto Headless Browser e crie um nome de usuário e uma senha (Essas credenciais são usadas para autenticação via WebSocket).

2

Sua primeira solicitação

O Oxylabs Headless Browser usa o Chrome DevTools Protocol (CDP). Você pode se conectar a ele usando Playwright ou Puppeteer sem gerenciar binários locais do navegador.

Exemplo com Python + Playwright:

1. Instale o Playwright: pip install playwright

2. Execute o script a seguir (substitua USERNAME e PASSWORD pelas suas credenciais):

from playwright.sync_api import sync_playwright

username = "USERNAME"
password = "PASSWORD"
endpoint = "ubc.oxylabs.io"
browser_url = f"wss://{username}:{password}@{endpoint}"

with sync_playwright() as p:
    # Conecta ao navegador remoto da Oxylabs
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"Título da página: {page.title()}")
    
    browser.close()

Referência de conexão

Use o endpoint que corresponda ao navegador preferido e à proximidade geográfica:

Navegador	Endpoint global	Endpoint baseado nos EUA
Chrome	wss://ubc.oxylabs.io	wss://ubc-us.oxylabs.io
Firefox	wss://ubs.oxylabs.io	wss://ubs-us.oxylabs.io

Personalizando o navegador

Você também pode passar instruções diretamente pela URL de conexão usando parâmetros de consulta:

Parâmetro	Exemplo	Descrição
p_cc	?p_cc=US	Roteia o tráfego do navegador por um país específico.
p_device	?p_device=mobile	Simula um tipo de dispositivo específico (apenas Chrome).
o_vnc	?o_vnc=true	Ativa a Session Inspection Tool para depuração visual.

Próximos passos

• Quer monitorar seu navegador? Saiba mais sobre a Session Inspection Tool para acompanhar visualmente, em tempo real, as interações do seu script com o navegador.

• Seu script está muito lento? Tente Optimizing Traffic para bloquear o carregamento de recursos desnecessários. Isso aumentará a velocidade de scraping e reduzirá o consumo de banda.

• Encontrando erros ou timeouts? Visite o Troubleshooting Guide para resolver problemas comuns de conexão CDP, incompatibilidades de versão de bibliotecas e timeouts de execução.

• Recebendo um "403 Forbidden" em um site importante? Confira a Restricted Targets lista para ver quais sites ou serviços têm acesso restrito para o Headless Browser.