Navegador — Consultar y operar la web
Theus lanza un Chrome real en tu escritorio y lo controla por Chrome DevTools Protocol: navega, lee el texto de la página, ve lo que hay en pantalla y puede operarla (clic, escritura, desplazamiento y teclas). Va montado por defecto y no necesita extensiones ni dependencias externas.
Qué hace
El navegador cubre dos usos que antes exigían pedirte a ti que copiaras y pegaras:
- Consultar la web en vivo — abrir una URL o buscar, y devolver el título, la URL y el texto legible de la página.
- Operar la página — hacer clic en un punto, escribir en un campo, desplazarse y pulsar teclas, con una captura antes y después para comprobar el efecto.
Es un Chrome de verdad, no headless: lo ves abrirse. Usa un perfil propio en ~/.theus/navegador, así que no toca tus sesiones ni tus cookies del navegador de diario.
Acciones
| Acción | Qué hace | Parámetros |
|---|---|---|
abrir | Navega a una URL y devuelve el texto de la página. | url |
buscar | Busca en la web y abre los resultados. | query |
leer | Relee la página abierta (útil tras interactuar). | — |
captura | Toma una captura y se la entrega al modelo como imagen. | — |
clic | Clic en un punto del viewport. | x, y |
escribir | Escribe en el elemento enfocado (respeta acentos). | texto |
desplazar | Desplaza la página verticalmente. | deltaY |
tecla | Pulsa una tecla especial. | key |
cerrar | Cierra el navegador. | — |
Teclas admitidas en tecla: Enter, Tab, Escape, Backspace, ArrowUp, ArrowDown, ArrowLeft, ArrowRight.
El ciclo de trabajo
Operar una página es un ciclo de ver → actuar → volver a ver:
captura → el modelo VE la página y decide dónde actuar
clic (x, y) → pulsa el botón o enfoca el campo
escribir "…" → introduce el texto
tecla Enter → envía
captura → comprueba que ocurrió lo esperado
Theus nunca da por hecho que una interacción funcionó: la verifica con otra captura o releyendo la página.
Permisos y seguridad
- Navegar pide aprobación —
abrirybuscarte preguntan antes de ir a un destino nuevo, para que una inyección de prompt no pueda llevar el navegador a donde quiera. - Interactuar también pide aprobación — un clic puede enviar un formulario, confirmar una compra o borrar algo. Son acciones con efectos reales, así que se confirman contigo.
- Solo http y https — se bloquean esquemas peligrosos (
file:,javascript:,data:…). - El contenido de una web no es una orden — el texto que Theus lee es información, nunca instrucciones que deba obedecer.
Variables de entorno
| Variable | Efecto |
|---|---|
THEUS_NAVEGADOR=0 | Desmonta el navegador por completo. |
THEUS_NAVEGADOR_AUTO=1 | Renuncia a la fricción: navega e interactúa sin pedir aprobación. Úsalo solo si confías en la tarea. |
THEUS_NAVEGADOR_BIN | Ruta a un binario de Chrome concreto. |
Requiere Google Chrome, Brave, Chromium o Edge instalado. Si no encuentra ninguno, la acción devuelve un aviso claro y el turno continúa.
Cuándo usar cada cosa
Theus tiene tres formas de tocar un navegador o el escritorio, y sirven para cosas distintas:
- Navegador (esta página) — Chrome propio con perfil aislado. Para consultar la web y operar páginas públicas. Montado por defecto.
- Control de Chrome — opera tu navegador real con tus sesiones iniciadas. Para tareas que exigen estar autenticado.
- Computer-use — control del escritorio macOS completo, más allá del navegador. Opt-in.