Inicio rápido: Headless Browser

Empieza a usar Headless Browser de Oxylabs en solo unos minutos con una sencilla guía paso a paso.

¿Ya estás familiarizado con lo básico? Consulta la documentación de Headless Browser.

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

1

Configuración y credenciales

1. Crea una cuenta: Regístrate en el panel de control de Oxylabs.
2. Elige un plan: Selecciona un plan o una prueba gratuita en Scraping Solutions → Headless Browser.
3. Crea credenciales de usuario: Ve a la pestaña Users en la sección del producto Headless Browser y crea un nombre de usuario y una contraseña (Estas credenciales se usan para la autenticación de WebSocket).

2

Tu primera solicitud

Oxylabs Headless Browser usa el Chrome DevTools Protocol (CDP). Puedes conectarte mediante Playwright o Puppeteer sin gestionar binarios de navegador locales.

Ejemplo en Python + Playwright:

1. Instala Playwright: pip install playwright
2. Ejecuta el siguiente script (reemplaza USERNAME y PASSWORD con tus 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

Usa el endpoint que coincida con tu navegador preferido y la cercanía 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

Personalizar el navegador

También puedes 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	Activa la herramienta de inspección de sesión para depuración visual.

Siguientes pasos

• ¿Quieres supervisar tu navegador? Aprende sobre la herramienta de inspección de sesión para seguir visualmente, en tiempo real, las interacciones de tu script con el navegador.
• ¿Tu script es demasiado lento? Prueba Optimizing Traffic para bloquear la carga de recursos innecesarios. Esto aumentará la velocidad de scraping y reducirá el consumo de ancho de banda.
• ¿Tienes errores o tiempos de espera agotados? Visita la guía de solución de problemas para resolver problemas comunes de conexión CDP, desajustes en las versiones de las bibliotecas y tiempos de espera de ejecución.
• ¿Recibes un "403 Forbidden" en un sitio importante? Consulta la lista de Restricted Targets para ver qué sitios web o servicios tienen restringido el acceso para Headless Browser.