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á conhece o básico? Confira o documentação do Headless Browser.

Oxylabs Headless Browser é uma infraestrutura de navegador hospedada na nuvem que lida automaticamente com sistemas de controle de tráfego de bots, CAPTCHAs e rotação de proxy. É 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 Painel da Oxylabs.
2. Escolha um plano: Selecione um plano ou um teste gratuito em Scraping Solutions → Headless Browser.
3. Crie credenciais de usuário: Acesse 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 WebSocket Secure).

2

Sua primeira requisiçã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 em Python + Playwright:

1. Instale o Playwright: pip install playwright
2. Execute o seguinte script (substitua USERNAME e PASSWORD pelas suas credenciais):

from playwright.sync_api import sync_playwright

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

with sync_playwright() as p:
    # Conecte-se ao navegador remoto da Oxylabs
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"Page Title: {page.title()}")
    
    browser.close()

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	Emula um tipo específico de dispositivo.
session_name	?session_name=ses-1	Cria uma sessão persistente para manter sua instância remota do navegador em execução na nuvem.

Encontre mais opções de personalização na Headless Browser documentação.

Próximos passos

• Quer monitorar seu navegador? Saiba mais sobre a Ferramenta de Inspeção de Sessão para acompanhar visualmente as interações do seu script com o navegador em tempo real.
• Seu script está muito lento? Experimente Otimização de tráfego para bloquear o carregamento de ativos desnecessários. Isso aumentará a velocidade de scraping e reduzirá o consumo de largura de banda.
• Está encontrando erros ou timeouts? Visite o Guia de solução de problemas para resolver problemas comuns de conexão CDP, incompatibilidades de versão de biblioteca e timeouts de execução.
• Está recebendo um "403 Forbidden" em um site importante? Confira a Alvos restritos lista para ver quais sites ou serviços têm o acesso restrito para o Headless Browser.