Automatización del navegador con intervención humana: del inicio de sesión manual a tareas automatizadas
TL;DR
La automatización de navegador con humano en el circuito permite que una persona y un script trabajen en la misma sesión de navegador en ejecución con una entrega de control explícita.
Un humano puede iniciar sesión a través de Live View sin poner una contraseña en el script de automatización.
El script debe adjuntarse a la sesión original y seleccionar la pestaña de aplicación existente; una nueva sesión no hereda ese inicio de sesión.
Una señal de reanudación significa que el humano terminó su paso, mientras que una afirmación de página verifica que el estado de aplicación esperado está efectivamente presente.
Solo un actor debe navegar o mutar la página a la vez, y las acciones sensibles requieren la propia frontera de aprobación de la aplicación.
Las grabaciones y los registros pueden contener datos de página privados incluso cuando se habilita el enmascaramiento de entrada.
¿Qué es la automatización del navegador con intervención humana?
La automatización de navegador con humano en el circuito combina el trabajo de navegador scriptado con una pausa deliberada para que una persona complete un paso o tome una decisión. Un ejemplo común es el inicio de sesión manual seguido de una tarea de solo lectura en el mismo navegador. El valor proviene de preservar el estado de la aplicación en ejecución mientras se cambia quién controla la página.
Nstdata Cloud Browser proporciona navegadores en la nube gestionados para la automatización de navegadores y agentes de IA, incluidos una vista previa de navegador interactiva y adjunto CDP. Un operador puede iniciar sesión a través de la vista previa, luego dejar que un cliente Playwright inspeccione la pestaña existente. El cliente no necesita la contraseña del operador en el código fuente. Aún necesita acceso a la sesión autorizada y debe verificar qué cuenta y espacio de trabajo recibió.
La introducción al Cloud Browser describe el modelo de sesión compartida. Este recorrido implementa un chequeo de aceptación estrecho: encontrar exactamente una pestaña de aplicación aprobada y confirmar su marcador autenticado. No exporta cookies, automatiza un desafío de inicio de sesión, ni envía una acción consecuente.
¿Cuándo debes transferir el control a una persona?
Añade una entrega a un humano cuando una persona debe proporcionar identidad, contexto, o aprobación que la automatización no debe inferir. El inicio de sesión manual es un caso; confirmar un espacio de trabajo, resolver un registro ambiguo, o revisar un borrador antes de la presentación son otros. Decide la frontera de entrega antes de escribir selectores.
Por ejemplo, un operador de soporte puede abrir un espacio de trabajo de prueba permitido, iniciar sesión y dejar que un script verifique que se cargó un panel de control. Un analista puede elegir una cuenta autorizada antes de un paso de informe de solo lectura. Un ingeniero de QA puede proporcionar una entrada de verificación solo para pruebas antes de continuar con un flujo de trabajo de staging. Estas tareas tienen diferentes requisitos de aprobación incluso cuando utilizan la misma sesión de navegador.
No hagas que "el humano completó el inicio de sesión" signifique "el script puede realizar cualquier acción de cuenta disponible". La entrega debe especificar la tarea siguiente permitida. La autenticación y autorización de cuenta para enviar, comprar, eliminar o divulgar datos son decisiones separadas. Una página bloqueada o desconocida debería regresar al operador en lugar de activar intentos improvisados para eludir los controles de acceso.
¿Cómo Preserva el Estado una Sesión de Navegador Compartida?
Un navegador en ejecución compartido preserva las pestañas y el contexto del navegador en el que el operador completó el inicio de sesión. La conexión CDP accede a ese navegador en lugar de reproducir el inicio de sesión en otro proceso. La API de conexión CDP de Playwright expone el contexto predeterminado existente, razón por la cual elegir la sesión correcta es importante.
Un contexto recién creado tiene diferentes semánticas de aislamiento y no debe asumirse que contiene ese inicio de sesión. La referencia de BrowserContext describe el aislamiento de contexto. Asimismo, newPage() es útil para una prueba de página pública pero no selecciona la pestaña firmada exactamente que una persona dejó abierta.
El sitio web puede expirar la autenticación mientras el navegador permanece listo. Las reconexiones también pueden ocurrir después de que el operador cambió de cuentas o navegó fuera. Por lo tanto, inspecciona el estado de la página actual cada vez que cambia la propiedad. Un identificador de cuenta/espacio de trabajo estable es una evidencia más fuerte que un encabezado de bienvenida genérico.
¿Qué debes preparar antes del traspaso de control?
Prepara una cuenta de prueba autorizada, una URL de aplicación conocida, un selector de preparación único, y un propietario nombrado para el eventual apagado del navegador. Usa una cuenta de staging con permisos limitados para tu primera implementación. Obtén una clave de API de negocio de Nstdata de Settings → Account, o una clave de miembro de un compañero de equipo en Members.
Configuración
Significado
NSTDATA_API_KEY
Clave de negocio para la búsqueda de sesión y emisión de credenciales CDP
NSTDATA_TEAM_ID
Selección de equipo opcional para una clave personal
NSTDATA_SESSION_ID
La sesión exacta donde el operador inicia sesión
APP_URL
Origen y ruta esperada de la aplicación después del inicio de sesión
READY_SELECTOR
Un selector estable visible solo en la vista autenticada prevista
Regla de propiedad
El humano termina, el script verifica, luego el script realiza su tarea permitida
Elija READY_SELECTOR de su aplicación, como un atributo de prueba que representa el espacio de trabajo esperado. Ese nombre es un contrato de aplicación, no un selector integrado de Nstdata. Utilice un selector cuya ausencia falle la tarea en lugar de permitir que el script continúe en una página incierta.
La selección de página de la misma sesión y el comportamiento de separación a continuación se ejecutaron en un accesorio local aislado. La emisión de credenciales gestionadas y el inicio de sesión en un sitio real requieren su cuenta autorizada y no se probaron en vivo. El accesorio demuestra la preservación de una pestaña existente; no prueba un flujo de trabajo de identidad de producción.
¿Cómo le pasas una sesión iniciada manualmente a Playwright?
Pase la sesión a Playwright completando el inicio de sesión en Vista en Vivo, deteniendo la interacción manual y conectando un cliente que encuentre y valide la pestaña existente. Siga la guía de automatización del navegador actual para el flujo de tablero y credenciales.
Paso 1: Inicie la sesión prevista
Abra Cloud Browser → Playground, seleccione su espacio de trabajo, configure la sesión y haga clic en Launch Browser. Espere a que aparezca Running y la vista previa interactiva. Asigne a la sesión un nombre que su operador pueda distinguir del trabajo no relacionado.
Mantenga la grabación desactivada para la primera demostración de inicio de sesión, a menos que su organización haya aprobado lo que captura. Si la grabación es necesaria, habilítela antes del lanzamiento y revise el enmascaramiento de entrada y el acceso a los datos de la página grabada.
Paso 2: Inicie sesión manualmente a través de la vista previa
Navegue por el navegador remoto a su aplicación autorizada y complete el inicio de sesión allí. Esto debe ocurrir dentro de Browser Preview o su Live URL para la misma sesión. Iniciar sesión a través de una pestaña de escritorio de Chrome no relacionada no autentica este navegador gestionado.
[Captura de pantalla: La vista iniciada de una aplicación de staging autorizada dentro de Browser Preview; oculte identificadores de cuenta y todas las URL de acceso iniciadas.]
Mantenga las Live URLs privadas porque contienen credenciales de acceso de corta duración. Si una vista previa se desconecta, vuelva a abrir la sesión existente después de confirmar que todavía está en ejecución. No cree un navegador de reemplazo solo para actualizar la vista.
Paso 3: Marque la entrega como lista
Diga al propietario de la automatización que el trabajo manual ha terminado y deje de hacer clic o escribir en esa sesión. Para un solo desarrollador, esto puede ser una confirmación explícita del operador antes de ejecutar el script. Un sistema de producción debería persistir un estado esperando-humano delimitado y reanudar solo el trabajo que coincida.
La señal le da al script la oportunidad de verificar el estado, no el permiso para omitir afirmaciones. Registre el ID del trabajo, el ID de la sesión, la tarea permitida y la decisión del operador en su aplicación. No coloque credenciales ni Live URLs completas en ese registro.
Paso 4: Instale el cliente del navegador
Cree un proyecto de Node.js e instale la versión utilizada a continuación. Node.js 22.12 o posterior es la base para el helper de API que lo acompaña.
mkdir browser-handoff-demo
cd browser-handoff-demo
npm init -ynpminstall --save-exact playwright-core@1.65.1
Paso 5: Guarde el helper de conexión
Guarde este módulo como cloud-api.mjs. El helper requiere una sesión lista y emite credenciales de corta duración para esa sesión exacta. Nunca sustituye directamente la clave de negocio en la autenticación de CDP.
Requisito de credenciales: esta rama requiere su clave Nstdata y el ID de la sesión en ejecución original. No configure LOCAL_CDP_URL al conectarse al navegador gestionado.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('Set NSTDATA_API_KEY');const headers ={'x-api-key': key };if(process.env.NSTDATA_TEAM_ID) headers['x-team-id']= process.env.NSTDATA_TEAM_ID;if(body) headers['content-type']='application/json';let response;try{ response =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('API transport failed; reconcile the original operation'),{retryable:true});}const retryable = response.status===429|| response.status>=500;let result;try{ result =await response.json();}catch{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
Paso 6: Guardar el verificador de entrega
Guarde el script como handoff.mjs. Coincide con el origen y la ruta configurados, rechaza múltiples candidatos y espera el marcador autenticado esperado sin navegar por la pestaña. El código deliberadamente no realiza ninguna presentación de formulario.
Requisito de credenciales: la ejecución gestionada requiere la clave y la sesión del Paso 5 más la URL de su aplicación y el selector. La selección de pestañas en la misma sesión se verificó localmente con un marcador autenticado sintético.
import{ chromium }from'playwright-core';import{ endpoint }from'./cloud-api.mjs';asyncfunctionmain(){const target =newURL(process.env.APP_URL);if(!process.env.READY_SELECTOR)thrownewError('Set READY_SELECTOR for your authorized app');const config =awaitendpoint();const browser =await chromium.connectOverCDP(config.endpoint,{headers: config.headers});try{const candidates = browser.contexts().flatMap(context=> context.pages()).filter(page=>{try{const url =newURL(page.url());return url.origin=== target.origin&& url.pathname=== target.pathname;}catch{returnfalse;}});if(candidates.length!==1)thrownewError('Expected exactly one matching application tab');const page = candidates[0];await page.locator(process.env.READY_SELECTOR).waitFor({state:'visible',timeout:15_000});console.log(JSON.stringify({sessionMatched:true,authenticatedMarkerVisible:true,title:await page.title()}));// Add an approved read-only task here after checking the account/workspace marker.}finally{await browser.close();}}main().catch(()=>{console.error("Browser task failed; inspect private diagnostics and the original session."); process.exitCode=1;});
Paso 7: Verificar el estado de la aplicación seleccionada
Cree un archivo privado .env que contenga NSTDATA_API_KEY, NSTDATA_SESSION_ID, APP_URL y READY_SELECTOR, con un opcional NSTDATA_TEAM_ID. Mantenlo fuera del control de versiones, luego ejecuta el verificador.
node --env-file=.env handoff.mjs
El éxito informa sessionMatched: true y authenticatedMarkerVisible: true. Antes de agregar una tarea real, amplíe el verificador para afirmar el marcador de cuenta/espacio de trabajo esperado también. Revise la salida del título antes de conservarla porque los títulos de producción pueden contener identificadores privados. Un marcador genérico de sesión iniciada por sí solo no puede distinguir entre dos cuentas autorizadas.
Paso 8: Finalizar o devolver explícitamente la propiedad de la sesión
Después de la tarea aprobada, entregue la sesión aún en ejecución a su operador o haga clic en Stop Browser y confirme la finalización. Este ejemplo libera Playwright pero preserva la página existente. El propietario de la sesión sigue siendo responsable del apagado y su uso continuo.
¿Cómo apoya Cloud Browser un traspaso controlado?
Nstdata Cloud Browser apoya un traspaso permitiendo que una persona y un cliente de automatización accedan al mismo navegador en ejecución. Live View proporciona al operador un lugar visible para completar trabajos manuales. La conexión CDP permite que el código existente de Playwright o Puppeteer continúe con ese navegador. La búsqueda de sesión separa un recurso aún en ejecución de uno expirado. Su aplicación sigue siendo responsable de la propiedad del control, aprobaciones, verificaciones de cuenta y salida aceptada.
Vista en vivo interactiva: complete un paso manual autorizado sin incrustar una contraseña en el script de ejemplo.
CDP de sesión compartida: seleccione la pestaña de aplicación existente en lugar de recrear su estado de inicio de sesión en otro navegador.
Configuración de sesión y proxy incorporado: inicie con la configuración de red deseada antes del traspaso, sin agregar una segunda capa de proxy al cliente.
Diagnósticos disponibles: inspeccione la página seleccionada cuando falte el marcador esperado en lugar de suponer que el paso humano tuvo éxito.
Presupuesto para el tiempo pasado esperando al operador usando Cloud Browser pricing. Reabrir la vista previa no restablece la duración de la sesión. El tutorial de Playwright es útil para diseñar la próxima tarea de solo lectura, mientras que la visión general del flujo de trabajo de CAPTCHA explica por qué los desafíos necesitan un límite explícito de flujo de trabajo.
¿Cómo evitar fallos en el traspaso de control y la exposición de datos?
Prevén fallos de entrega verificando la sesión original, exigiendo un controlador activo, y reteniendo solo los diagnósticos necesarios para la tarea aprobada. La guía de gestión de sesiones de OWASP es relevante porque el acceso a un navegador autenticado es acceso al estado activo de la aplicación del usuario.
Síntoma
Causa probable
Respuesta
El script ve la página de inicio de sesión
Sesión incorrecta o inicio de sesión de la aplicación expirado
Regresar al operador; verificar la sesión y la cuenta originales
Múltiples pestañas coincidentes
Propiedad de página ambigua
Cerrar manualmente una pestaña innecesaria o fortalecer la coincidencia específica de la aplicación
La página cambia mientras el script se ejecuta
Humano y script están actuando juntos
Pausar la automatización y restablecer la propiedad
El marcador existe en la cuenta incorrecta
La verificación de disponibilidad es demasiado amplia
Afirmar un identificador estable de cuenta/espacio de trabajo permitido
El navegador terminó durante la pausa
Vida útil de la sesión expirada
Comenzar una nueva sesión autorizada y repetir el inicio de sesión deliberadamente
El enmascaramiento de entrada no oculta texto arbitrario de la página, salida de consola, datos de red, o cada campo de la aplicación. Mantener las URLs de acceso y los tokens fuera de capturas de pantalla y tickets. Limitar la retención de grabaciones y el acceso del operador de acuerdo con los datos reales presentes. Si el siguiente paso cambia el estado externo, requerir la revisión apropiada de la aplicación antes de ejecutarlo.
¿Qué debe conseguir el primer flujo de trabajo con intervención humana?
El primer flujo de trabajo de entrega debería entregar una transición verificada de una pestaña de operador a una tarea de script delimitada. Mantener la identidad de la sesión original, confirmar la cuenta destinada, y hacer la propiedad de detención explícita. Agregar acciones adicionales solo después de que la ruta de solo lectura se comporte de manera predecible bajo condiciones de tiempo de espera, inicio de sesión expirado, pestaña duplicada y cancelación del operador.
Q: ¿Puede el operador iniciar sesión a través de su navegador de escritorio habitual?
El operador debe iniciar sesión dentro de la sesión gestionada a la que se adjuntará el script. Un navegador de escritorio no relacionado tiene un estado separado.
Q: ¿Reutiliza un nuevo Cloud Browser el antiguo inicio de sesión?
No asumas que una nueva sesión hereda el inicio de sesión de una sesión anterior. Este flujo de trabajo preserva el estado reutilizando la misma sesión y pestaña en ejecución.
Q: ¿Necesita el script la contraseña del operador?
No. El operador ingresa credenciales a través de la aplicación autorizada en Vista en Vivo. El script necesita permiso para acceder a la sesión gestionada, no una contraseña copiada en su fuente.
Q: ¿Puede la persona seguir haciendo clic mientras se ejecuta el script?
El control concurrente puede cambiar el estado de la página de manera impredecible. Dar control a un actor a la vez y volver a validar la página cuando cambia la propiedad.
Q: ¿Hace que el enmascaramiento de entrada una grabación sea segura para compartir?
No. El texto de la página y otros diagnósticos pueden contener aún datos privados. Revisar el contenido capturado real y limitar el acceso en lugar de depender únicamente de entradas enmascaradas.
Q: ¿Qué pasa si la aplicación rechaza el inicio de sesión existente?
Pausar la tarea guionizada y regresar al operador autorizado. Un navegador en ejecución no anula la autenticación del sitio web ni las políticas de acceso.
Automatización del navegador con intervención humana: del inicio de sesión manual a tareas automatizadas
Deje que un operador inicie sesión a través de Live View antes de que un script verifique la misma pestaña de la aplicación. Defina la propiedad, las afirmaciones de cuenta, los límites de aprobación y la limpieza sin incluir una contraseña en la automatización.
Ivy Lin
Nov. 17th 2026
Inicia navegadores en la nube bajo demanda
Gestiona huellas digitales y CAPTCHA
Automatiza flujos de trabajo e impulsa agentes de IA
Desde la extracción de datos web y las pruebas hasta la automatización con IA, ejecútalo todo en la nube.