Inicio rápido: Headless Browser

Oxylabs Headless Browser es una infraestructura de navegador alojada en la nube que gestiona automáticamente sistemas anti-bot, CAPTCHAs y la rotación de proxies. Es totalmente compatible con Playwright, Puppeteer y el Model Context Protocol (MCP) para aplicaciones de IA.

1

Configuración y credenciales

1. Cree una cuenta: Regístrese en el Panel de Oxylabs.

2. Elija un plan: Seleccione un plan o una prueba gratuita en Scraping Solutions → Headless Browser.

3. Cree credenciales de usuario: Vaya a la pestaña Users en la sección del producto Headless Browser y cree un nombre de usuario y una contraseña (Estas credenciales se usan para la autenticación WebSocket).

2

Su primera solicitud

Oxylabs Headless Browser usa Chrome DevTools Protocol (CDP). Puede conectarse a él usando Playwright o Puppeteer sin administrar binarios locales del navegador.

Ejemplo en Python + Playwright:

1. Instale Playwright: pip install playwright

2. Ejecute el siguiente script (reemplace USERNAME y PASSWORD con sus credenciales):

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:
    # Conectar al navegador remoto de Oxylabs
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"Título de la página: {page.title()}")
    
    browser.close()

Referencia de conexión

Use el endpoint que coincida con su navegador preferido y su proximidad geográfica:

Navegador	Endpoint global	Endpoint basado en EE. UU.
Chrome	wss://ubc.oxylabs.io	wss://ubc-us.oxylabs.io
Firefox	wss://ubs.oxylabs.io	wss://ubs-us.oxylabs.io

Personalización del navegador

También puede pasar instrucciones directamente a través de la URL de conexión usando parámetros de consulta:

Parámetro	Ejemplo	Descripción
p_cc	?p_cc=US	Dirige el tráfico del navegador a través de un país específico.
p_device	?p_device=mobile	Emula un tipo de dispositivo específico (solo Chrome).
o_vnc	?o_vnc=true	Habilita la herramienta Session Inspection Tool para depuración visual.

Siguientes pasos

• ¿Quiere supervisar su navegador? Obtenga información sobre la Session Inspection Tool para seguir visualmente en tiempo real las interacciones de su script con el navegador.

• ¿Su script es demasiado lento? Pruebe Optimizing Traffic para bloquear la carga de recursos innecesarios. Esto aumentará la velocidad de scraping y reducirá el consumo de ancho de banda.

• ¿Encuentra errores o tiempos de espera agotados? Visite la Troubleshooting Guide para resolver problemas comunes de conexión CDP, incompatibilidades de versiones de bibliotecas y tiempos de espera de ejecución.

• ¿Obtiene un "403 Forbidden" en un sitio importante? Consulte la lista de Restricted Targets para ver qué sitios web o servicios tienen el acceso restringido para el Headless Browser.