# Inicio rápido: Headless Browser

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

{% stepper %}
{% step %}

### Configuración y credenciales

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

{% step %}

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

```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

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](/products/headless-browser/features/session-inspection.md) para seguir visualmente en tiempo real las interacciones de su script con el navegador.
* **¿Su script es demasiado lento?** Pruebe [Optimizing Traffic](/products/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.
* **¿Encuentra errores o tiempos de espera agotados?** Visite la [Troubleshooting Guide](/products/headless-browser/troubleshooting-guide.md) 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](/products/headless-browser/restricted-targets.md) para ver qué sitios web o servicios tienen el acceso restringido para el Headless Browser.


---

# Agent Instructions: 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.