cloud

Visión general de cloud skill

Para qué sirve cloud skill

La cloud skill es una ayuda guiada por documentación para Browser Use Cloud, la plataforma alojada y API de automatización de navegador. Encaja mejor para quienes necesitan automatizar sitios web a través del servicio en la nube, usar la REST API o los SDK, conectar herramientas externas de navegador mediante CDP, o diseñar flujos de trabajo en torno a sesiones, perfiles, proxies y monitorización en vivo.

Quién debería instalar esta cloud skill

Instala esta cloud skill si tu trabajo real se parece a alguno de estos casos:

• empezar a usar Browser Use Cloud rápido sin tener que leer todos los archivos de referencia
• elegir entre la REST API v2, la agent API v3, el uso de SDK o la conexión directa al navegador
• automatizar tareas de navegador desde Python, TypeScript, cURL o herramientas externas
• ejecutar automatización de navegador en infraestructura alojada para casos de Browser Automation
• trabajar con sesiones, perfiles persistentes, proxies residenciales, resolución de CAPTCHA o webhooks

No la instales si en realidad necesitas ayuda con la configuración de la librería Python local de código abierto browser-use. La propia skill separa explícitamente el uso en la nube del paquete open source de agentes.

Qué hace diferente a esta cloud skill frente a un prompt genérico

Un prompt genérico puede describir la automatización de navegador a un nivel alto. Esta cloud skill resulta más útil cuando necesitas las rutas exactas de Browser Use Cloud: qué versión de API consultar, cómo funciona la autenticación, de dónde sale liveUrl, en qué se diferencian las sesiones cloud de las ejecuciones puntuales, cómo se inicia el acceso por CDP y qué patrón de integración encaja con tu stack.

Su mayor valor está en la orientación y en ayudarte a encontrar el encaje correcto, no en herramientas ocultas. Te lleva rápido al archivo de referencia adecuado:

• references/quickstart.md para la primera configuración y precios
• references/api-v2.md para endpoints REST estables
• references/api-v3.md para la agent API más nueva basada en sesiones
• references/browser-api.md para Playwright, Puppeteer, Selenium y CDP puro
• references/sessions.md para diseño de sesiones y perfiles
• references/features.md para proxies, webhooks, workspaces, skills, MCP y vista en vivo
• references/patterns.md para ejecuciones en paralelo, streaming, geo-scraping y salida estructurada

Casos de uso ideales de cloud para Browser Automation

Esta cloud skill es especialmente relevante cuando buscas cloud para Browser Automation en lugar de control local del navegador. Algunos encajes habituales son:

• scraping o extracción que se beneficia de stealth y proxies
• flujos autenticados que necesitan perfiles de navegador persistentes
• sesiones remotas de navegador que puedes observar mediante liveUrl
• automatización directa desde Playwright, Puppeteer o Selenium vía CDP alojado
• integraciones con sistemas de agentes, interfaces de chat, herramientas no-code o backends impulsados por webhooks

Principales bloqueos de adopción que conviene revisar primero

La mayoría de decisiones de instalación se reducen a unas pocas preguntas prácticas:

• ¿Necesitas automatización cloud alojada o control local open source?
• ¿Quieres endpoints REST estables de v2 o el modelo más nuevo de sesiones/mensajes de v3?
• ¿Necesitas tareas simples con run(), o gestión explícita de sesiones/perfiles?
• ¿Vas a usar SDK, cURL o frameworks de navegador externos sobre CDP?
• ¿Necesitas enrutamiento geográfico, persistencia de autenticación o callbacks por webhook?

Si esas preguntas siguen sin resolverse, esta skill ayuda porque el repositorio está organizado por rutas de decisión, no como un tutorial lineal único.

Cómo usar cloud skill

Instalar cloud skill

Usa el instalador estándar de skills contra el repositorio y apunta a la skill cloud:

npx skills add https://github.com/browser-use/browser-use --skill cloud

Después de instalarla, invócala cuando tu petición trate específicamente de Browser Use Cloud, no del paquete local open source.

Empieza por el archivo correcto según tu objetivo

Lee por decisión, no por orden de archivos:

• Si eres nuevo en la plataforma: references/quickstart.md
• Si necesitas cobertura estable de API y ejemplos con cURL: references/api-v2.md
• Si necesitas el modelo nuevo de agente/sesión: references/api-v3.md
• Si necesitas acceso a navegador alojado desde frameworks que ya usas: references/browser-api.md
• Si necesitas estado persistente, autenticación o estrategia de perfiles: references/sessions.md
• Si necesitas funciones avanzadas como proxies o webhooks: references/features.md
• Si necesitas patrones de implementación: references/patterns.md

Esto importa porque la skill no oculta la complejidad del producto; te ayuda a elegir la ruta de lectura más corta que realmente te sirva.

Entiende las cuatro rutas principales de uso cloud

Antes de escribir tu prompt, decide cuál de estas quieres:

1. ejecución de tareas con run() a través del SDK
2. endpoints de tareas/sesiones/navegador de la REST API v2
3. agent API v3 con sesiones, mensajes y workspaces
4. conexión directa al navegador por CDP para Playwright, Puppeteer o Selenium

Muchos prompts flojos fallan porque piden “uso de Browser Use Cloud” sin indicar la ruta concreta.

Configura correctamente la autenticación

Browser Use Cloud usa el header X-Browser-Use-API-Key, y los SDK suelen leer BROWSER_USE_API_KEY desde el entorno.

export BROWSER_USE_API_KEY=your-key

Detalles útiles que aparecen en las referencias:

• base API para v2: https://api.browser-use.com/api/v2
• base API para v3: https://api.browser-use.com/api/v3
• creación de API key: https://cloud.browser-use.com/new-api-key

Si en tu prompt no indicas cómo quieres manejar la autenticación, la respuesta puede quedarse demasiado abstracta.

Elige SDK, REST o CDP antes de pedir ejemplos

Usa ejemplos con SDK cuando quieras la experiencia de desarrollo más simple.
Usa REST cuando necesites control a nivel de endpoint.
Usa CDP cuando ya tengas código de automatización de navegador y solo necesites un navegador alojado como destino.

Esa diferencia cambia materialmente la respuesta:

• las respuestas con SDK se centran en run(), sesiones, perfiles y salida estructurada
• las respuestas con REST se centran en endpoints, polling, esquemas y headers
• las respuestas con CDP se centran en URLs WebSocket e integración con herramientas de navegador

Convierte un objetivo impreciso en un buen prompt de uso cloud

Prompt débil:

Help me use Browser Use Cloud.

Mejor prompt:

I want cloud usage guidance for Python. I need a hosted browser workflow that logs into a site, persists cookies across runs, uses a US proxy, and lets me monitor progress live. Show whether I should use run() with auto-created sessions or manual sessions with a profile, and point me to the exact repo files to read first.

Por qué este es mejor:

• indica el lenguaje
• indica el tipo de flujo
• menciona persistencia de sesión
• incluye requisitos de proxy
• pide monitorización en vivo
• pide orientación de archivos, no solo código

Datos de entrada que mejoran la calidad de la respuesta

Para obtener mejores resultados con cloud skill, incluye:

• lenguaje: Python, TypeScript, cURL
• modo API: v2, v3 o no estoy seguro
• estilo de ejecución: tarea puntual, sesión de varios pasos o control directo del navegador
• necesidades de estado: sin estado vs perfil persistente
• necesidades de infraestructura: país del proxy, proxy personalizado, timeout, tamaño de pantalla
• necesidades de monitorización: liveUrl, streaming, webhooks
• formato de salida: texto libre vs esquema estructurado
• objetivo de integración: Playwright, Puppeteer, Selenium, chat UI, subagent, herramienta no-code

Sin eso, la respuesta normalmente será correcta, pero demasiado amplia como para implementarla rápido.

Usa cloud skill para diseñar sesiones y perfiles

Un valor práctico importante de la cloud skill es que te ayuda a evitar malos diseños de sesión.

Según las referencias:

• run() normalmente crea una sesión automáticamente
• las sesiones manuales son mejores para flujos de varios pasos
• los perfiles conservan cookies y local storage entre sesiones
• las sesiones concurrentes que usan el mismo perfil parten de una instantánea y no ven los cambios de estado de las demás

Ese último punto es fácil de pasar por alto en una lectura rápida y es importante para trabajo autenticado en paralelo.

Usa cloud skill con frameworks de Browser Automation

Si ya usas Playwright, Puppeteer o Selenium, puede que la mejor ruta sea acceso directo al navegador cloud en vez de tareas de agente.

El repositorio muestra un punto de entrada CDP como este:

wss://connect.browser-use.com?apiKey=YOUR_KEY&proxyCountryCode=us&timeout=30

Esto es importante porque el navegador puede arrancar automáticamente al conectar y detenerse automáticamente al desconectar, lo que implica un modelo operativo distinto al de crear y destruir tareas manualmente.

Usa cloud skill para funciones cloud avanzadas

Esta skill también es útil cuando tu decisión depende de capacidades de la plataforma, no de sintaxis:

• valores predeterminados de stealth
• proxies residenciales en muchos países
• proxies personalizados
• resolución de CAPTCHA
• webhooks con verificación de firma
• visualización en vivo y enlaces para compartir
• workspaces
• skills y soporte de marketplace
• referencias de plataforma relacionadas con MCP

Son el tipo de detalles que determinan si Browser Use Cloud encaja o no en producción.

Flujo de trabajo recomendado tras la instalación

Una secuencia práctica para usuarios nuevos:

1. Leer references/quickstart.md
2. Ejecutar una primera tarea trivial con SDK o cURL
3. Decidir si tu flujo real necesita sesiones manuales
4. Añadir perfiles solo si necesitas login persistente o estado
5. Añadir configuración de proxy y geografía solo cuando haga falta
6. Añadir salida estructurada o webhooks después de que funcione la ruta básica
7. Pasar a references/patterns.md para concurrencia o streaming

Este orden reduce la confusión y evita que sobre-diseñes antes de lograr la primera ejecución exitosa.

Preguntas frecuentes sobre cloud skill

¿Esta cloud skill es solo documentación o cambia el comportamiento?

Es principalmente una skill de orientación hacia la referencia correcta. Su valor está en ayudar a un agente o a un usuario a elegir la ruta adecuada dentro de la documentación de Browser Use Cloud y responder con menos suposiciones erróneas. No sustituye ni al SDK ni a la API de la plataforma.

¿cloud skill es buena para principiantes?

Sí, si eres principiante específicamente en Browser Use Cloud. El mejor punto de partida es references/quickstart.md. Aun así, conviene saber si buscas ejecución simple de tareas, gestión de sesiones o control de navegador a nivel de framework.

¿Cuándo no debería usar esta cloud skill?

No uses esta cloud skill para preguntas sobre los internals de la librería local open source browser-use, la configuración del agente o la puesta en marcha del paquete no cloud. La skill indica explícitamente que para eso debes usar la skill open source.

¿Debería usar v2 o v3?

Usa v2 si quieres una REST API estable con cobertura amplia de endpoints.
Usa v3 si quieres el modelo más nuevo de BU Agent API con sesiones, mensajes, archivos y workspaces, y aceptas que en las referencias aparece marcado como experimental.

¿Puede esta cloud skill ayudar con frameworks de navegador normales?

Sí. El repositorio incluye references/browser-api.md específicamente para Playwright, Puppeteer, Selenium y conexión CDP directa a navegadores alojados.

¿cloud para Browser Automation es mejor que un prompt normal?

Para tareas de Browser Use Cloud, por lo general sí. Un prompt normal puede pasar por alto detalles específicos de la plataforma como los headers de autenticación, las versiones de endpoints, liveUrl, el comportamiento de los perfiles, las firmas de webhook o el modelo de conexión CDP con autoarranque.

¿La cloud skill cubre precios y limitaciones operativas?

Sí, la referencia quickstart incluye precios y preguntas frecuentes, y otras referencias cubren timeout, manejo de sesiones, matices de concurrencia y limitaciones específicas de cada funcionalidad.

Cómo mejorar cloud skill

Pide una decisión, no solo una explicación

La forma más rápida de mejorar la salida de cloud skill es pedirle que elija entre opciones:

• “Should I use v2, v3, or CDP?”
• “Should this be auto-session or manual session?”
• “Should I use a profile or keep it stateless?”

Eso produce orientación de implementación en lugar de un resumen amplio.

Da una tarea y un entorno concretos

Mejor:

I need cloud install and usage help for a TypeScript backend. The workflow logs into a dashboard weekly, downloads a file, and posts completion to my server. I need persistent auth, webhook notifications, and a recommendation between SDK and REST.

Esto mejora los resultados porque deja ver el lenguaje, la cadencia, los requisitos de estado y cómo se señala la finalización.

Dile a la skill qué debe persistir entre ejecuciones

Un fallo habitual es no especificar bien el estado. Si importan el login, las cookies, el local storage o las credenciales guardadas, dilo explícitamente y pide orientación basada en perfiles desde references/sessions.md.

Si el estado no importa, dilo también. Entonces la skill podrá recomendar ejecuciones puntuales más simples.

Especifica si necesitas observación o callbacks

A muchos usuarios les importa una de estas cosas, pero se olvidan de pedirla:

• ver la ejecución en vivo con liveUrl
• transmitir actualizaciones paso a paso
• recibir callbacks por webhook cuando terminan las tareas

Eso lleva a patrones de implementación distintos y a archivos distintos para leer.

Pide primero la ruta mínima viable

Un buen patrón de mejora es:

1. pedir el ejemplo más pequeño que funcione
2. ejecutarlo
3. después preguntar cómo añadir perfiles, proxies o webhooks

Esta skill funciona mejor cuando ayuda a secuenciar la adopción, no cuando se le pide diseñar toda la arquitectura de producción de una sola vez.

Vigila la confusión entre versiones de API

Una de las formas más fáciles de obtener una respuesta floja es mezclar conceptos de v2 y v3 en la misma petición. Si quieres comparativas, pide una comparativa. Si quieres implementación, nombra una sola versión.

Buen prompt:

Compare Browser Use Cloud v2 vs v3 for a multi-step agent workflow, then recommend one and give only that version's starter example.

Pide rutas de lectura a nivel de archivo

El repositorio tiene suficiente material de referencia como para que una ruta de lectura dirigida ahorre tiempo. Haz preguntas como:

• “Which file should I read first for webhook verification?”
• “Which reference covers CDP and Playwright setup?”
• “Which document explains concurrent sessions with the same profile?”

Eso hace que la guía cloud sea más accionable que un resumen genérico.

Mejora las respuestas con criterios de éxito explícitos

En lugar de:

Show me cloud usage.

Usa:

Show me a cloud usage path that gets from API key to first successful task in under 10 minutes, then list the next file to read if I need structured output.

Los criterios de éxito obligan a orientar la respuesta hacia una ruta práctica de adopción.

Itera después de la primera respuesta señalando huecos, no reiniciando

Después de la primera respuesta, mejórala diciendo qué sigue faltando:

• falta manejo de autenticación
• falta ejemplo de polling
• falta limpieza de sesión
• falta configuración de proxy
• falta esquema de salida estructurada
• falta verificación de webhook
• faltan detalles de conexión con Playwright

Eso produce una segunda iteración mejor que volver a empezar desde cero.

La mejor forma de obtener orientación cloud de alto valor

La cloud skill da lo mejor de sí cuando tu prompt incluye:

• tu stack
• tu objetivo de automatización de navegador
• si el estado debe persistir
• si prefieres control de navegador alojado o ejecución por agente
• si necesitas monitorización, streaming o webhooks
• si te importan el enrutamiento geográfico o las limitaciones de stealth

Esa combinación le da a la skill contexto suficiente para llevarte al material adecuado de Browser Use Cloud y ofrecerte orientación que puedas implementar de inmediato.