Saltar a contenido

Comportamiento de entrada humanizado

El comportamiento de entrada humanizado canaliza las interacciones de la página a través de la capa de ratón, teclado y desplazamiento de CloakBrowser, que imita el comportamiento humano. Resulta útil cuando el equipo de control de calidad necesita un ritmo, un movimiento del puntero, una cadencia de escritura y un comportamiento de desplazamiento más realistas que los que ofrece la automatización estándar.

El puente no añade nuevas herramientas al navegador ni modifica los esquemas de Playwright MCP de origen. Aplica el parche de interacción con la página de CloakBrowser durante la inicialización de la página de Playwright MCP, por lo que las herramientas existentes siguen funcionando con los mismos datos de entrada.

Qué cambia

Cuando CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true, CloakBrowser puede humanizar las acciones habituales de la página, entre las que se incluyen:

  • movimientos y clics del ratón;
  • escritura en el teclado y pulsaciones de teclas;
  • cumplimentación de formularios y cambio de campo;
  • desplazamiento y comportamiento de «desplazamiento hasta un elemento».

Esto afecta a la sincronización de las interacciones y a los patrones de movimiento. No modifica el contenido de la página, el enrutamiento de red, la configuración del proxy ni la geolocalización del navegador.

Configuración general

Utiliza la variable de entorno cuando se desee que todas las sesiones de stdio o las sesiones HTTP predeterminadas de Streamable adopten un comportamiento más intuitivo:

CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
npx -y cloakbrowser-mcp@latest

La misma configuración funciona con el indicador explícito de la CLI:

npx -y cloakbrowser-mcp@latest --humanize --human-preset careful

Configuración de Docker

Pasa la misma variable de entorno al contenedor:

docker run --rm -i \
  -e CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
  -e CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest

En el caso de Streamable HTTP en Docker, la variable de entorno se convierte en el valor predeterminado para las nuevas sesiones HTTP:

docker run --rm -p 127.0.0.1:3000:3000 \
  -e CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true \
  -e CLOAK_PLAYWRIGHT_MCP_HUMAN_PRESET=careful \
  -v "$PWD/artifacts:/data" \
  swimmwatch/cloakbrowser-mcp:latest \
  --transport streamable-http --http-host 0.0.0.0 --http-port 3000

Configuración de HTTP «Streamable» por sesión

Los clientes HTTP compatibles con Streamable pueden optar por un comportamiento humanizado en el momento de la inicialización de la sesión MCP. Esto permite a un servidor comparar el comportamiento de interacción estándar y el humanizado sin necesidad de reiniciarse.

Envía los metadatos del puente en la solicitud initialize:

{
  "params": {
    "_meta": {
      "io.github.swimmwatch/cloakbrowser-mcp": {
        "humanize": true,
        "humanPreset": "careful"
      }
    }
  }
}

humanize anula la configuración a nivel de proceso para esa sesión HTTP. Utilice true para habilitar el comportamiento humanizado o false para desactivarlo, incluso si el servidor se inició con CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true.

humanPreset acepta default o careful y selecciona el ajuste preestablecido de comportamiento humano de CloakBrowser para la sesión. No activa el comportamiento humanizado por sí mismo; establecer humanize: true o habilitar CLOAK_PLAYWRIGHT_MCP_HUMANIZE=true. El preajuste careful es más lento y cauteloso que default.

Las sesiones HTTP existentes son inmutables. Crea otra sesión HTTP de Streamable para alternar entre el comportamiento estándar y el humanizado.

Casos de uso

  • QA de formularios

Ejercita escritura, rellenado, cambios de foco y flujos de validación con una cadencia de teclado más realista.

  • Flujos de compra

Prueba rutas de compra con muchas interacciones donde el tiempo de escritura, clics y cambio de campos puede afectar la validación del cliente.

  • Comprobaciones de UI sensibles a la interacción

Compara la automatización estándar con la interacción humanizada cuando una página reacciona de forma distinta a entradas muy rápidas o perfectamente lineales.

  • Páginas con mucho desplazamiento

Valida páginas largas, feeds, listas de productos y contenido lazy-loading con un desplazamiento más suave.

  • Demos y grabaciones

Produce sesiones de navegador que parezcan menos mecánicas durante demos de producto, walkthroughs o evidencias QA grabadas.

Precedencia y límites

Área Comportamiento
Stdio Usa solo variables de entorno y flags de CLI a nivel de proceso.
Valor predeterminado de Streamable HTTP Usa variables de entorno y flags de CLI a nivel de proceso cuando no se proporcionan metadatos runtime.
Metadatos Streamable HTTP initialize.params._meta["io.github.swimmwatch/cloakbrowser-mcp"].humanize puede sobrescribir el comportamiento humanizado para una sesión. humanPreset puede seleccionar default o careful.
Sesiones existentes Conservan la configuración humanize capturada durante initialize.
Motor de navegador Aplica solo cuando PLAYWRIGHT_MCP_BROWSER_ENGINE=cloak.
Esquemas de herramientas Los esquemas de herramientas de navegador de upstream Playwright MCP permanecen sin cambios.
Configuración personalizada humanConfig no se acepta todavía de forma intencionada; la configuración estructurada necesita un esquema de validación explícito.

Esta función está destinada a pruebas legítimas de control de calidad, realismo de la interacción y coherencia. No debe considerarse una forma de eludir los controles de acceso ni las comprobaciones de políticas.

Configuración relacionada

  • Configuración enumera todas las variables de entorno del puente y del servidor de origen.
  • Coincidencia de proxy GeoIP explica los perfiles de proxy coherentes con la región.
  • Herramientas explica por qué las herramientas del navegador Playwright MCP de origen se reenvían sin modificaciones.

Más rutas prácticas

Para elegir entre Playwright MCP upstream y este paquete, consulta la comparación. Para tareas rápidas, usa las recetas: perfil persistente, extensiones, reverse proxy, QA regional, Claude Desktop, Codex CLI y prueba smoke de CI.

CloakBrowser

La dependencia actual de CloakBrowser es ^0.6.3. La escritura humanizada solapa las pulsaciones y varía los intervalos entre teclas. El tiempo de movimiento del ratón depende de la distancia. El desplazamiento usa pasos completos de la rueda para la plataforma simulada, por lo que los pequeños desplazamientos solicitados pueden redondearse. Las interacciones admiten modales con posición fija y elementos con posición absoluta fuera de los contenedores de desplazamiento antecesores. Elegir una opción que provoca navegación devuelve los valores elegidos en lugar de un error de elemento obsoleto.

Para CloakBrowser 0.6.2/0.6.3, el puente se desplaza al primer segmento con ArrowLeft antes de escribir en los editores nativos de fecha y hora. Esto evita que el primer clic coloque todos los dígitos en el campo del año. Los valores se introducen con el teclado, sin asignación programática.

CloakBrowser 0.6.2 corrige las comprobaciones de visibilidad de las acciones humanizadas con Playwright 1.64. El puente transmite la visibilidad real de los iframe antecesores a ambas rutas de comprobación del estado del elemento, en lugar del true incondicional de upstream.

Las acciones humanizadas siguen la semántica de los selectores de Playwright, incluido el modo estricto. Los localizadores ambiguos y las acciones no admitidas generan errores en lugar de recurrir silenciosamente a acciones normales. Por ejemplo, el fill() humanizado no admite input[type=color]; desactive humanize en una sesión que necesite esta operación.

Con humanize activado, el puente solo acepta versiones y hashes de código verificados. Comprueba la visibilidad de los iframe antecesores y conserva referencias débiles a los elementos DOM resueltos para permitir la recolección de los elementos separados. Las versiones no compatibles o el código modificado se rechazan; utiliza CLOAK_PLAYWRIGHT_MCP_HUMANIZE=false hasta que el puente los admita.

CloakBrowser 0.6.1 ejecuta inputValue(), textContent(), innerText(), innerHTML(), getAttribute() y dispatchEvent() en el mundo aislado de humanize para Page, Frame, Locator y ElementHandle. Para elementos ElementHandle ocultos o superpuestos, y argumentos de eventos que contienen un JSHandle, upstream utiliza Playwright sin humanize como alternativa para leer y enviar eventos.

La selección en listas desplegables utiliza la búsqueda por prefijo y admite selecciones repetidas. En macOS, una etiqueta que comienza con un emoji puede ser inaccesible mediante entrada humanizada; el error se transmite por MCP. Si la selección programática es aceptable, utilice explícitamente el método upstream page._original.selectOption().