> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/documentation/es/comenzar/inicio-rapido-headless-browser.md).

# Inicio rápido: Headless Browser

{% hint style="info" %}
¿Ya estás familiarizado con lo básico? Consulta la [documentación de Headless Browser](/products/es/headless-browser.md).
{% endhint %}

Oxylabs [Headless Browser](https://oxylabs.io/products/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.

{% stepper %}
{% step %}

### Configuración y credenciales

1. **Crea una cuenta:** Regístrate en el [panel de control de Oxylabs](https://dashboard.oxylabs.io/).
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).
   {% endstep %}

{% step %}

### 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):

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

{% endstep %}
{% endstepper %}

### 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](/products/es/headless-browser/features/session-inspection.md) para seguir visualmente, en tiempo real, las interacciones de tu script con el navegador.
* **¿Tu script es demasiado lento?** Prueba [Optimizing Traffic](/products/es/headless-browser/optimizing-traffic.md) 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](/products/es/headless-browser/troubleshooting-guide.md) 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](/products/es/headless-browser/restricted-targets.md) para ver qué sitios web o servicios tienen restringido el acceso para Headless Browser.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/documentation/es/comenzar/inicio-rapido-headless-browser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.