¿Qué es la extensión de Safari de PocketHook?#
Una extensión de Safari para macOS que le permite a tu Agent Server autoalojado trabajar dentro de tu navegador real: abrir y cerrar pestañas, leer páginas, encontrar controles y darles clic, llenar formularios y capturar pantallas — en tu sesión, con tus inicios de sesión, en tu computadora.
Todo corre en local. La extensión solo habla con el Agent Server de tu propia Mac (loopback), y nada se envía a ningún otro lado.
Instalación#
La extensión viene incluida con el Agent Server como app de macOS notarizada — sin App Store, sin Xcode:
bun run safari:install
Esto instala Pockethook Safari.app en /Applications y la abre. Después, en Safari:
- Configuración → Extensiones — activa PocketHook Safari y concede acceso a sitios web.
- Genera un código de emparejamiento de un solo uso en el servidor:
bun run safari:code
- Abre el popup de la extensión en la barra de herramientas de Safari, ingresa el código y presiona Pair. El punto verde significa que estás conectado.
Verifica la conexión cuando quieras con bun run safari:status.
Niveles de permiso#
Tú decides cuánta autonomía tiene el agente, por servidor, con bun run safari:config:
| Nivel | Qué significa |
|---|---|
confirm (por defecto) | Cada clic con efectos externos (votar, enviar, publicar, comprar…) te pide confirmación primero |
autonomous | Votos, follows y envíos se ejecutan sin preguntar; los pagos, borrados permanentes y cambios de cuenta o seguridad siguen pidiendo permiso |
readonly | Solo navegar, inspeccionar y capturar — dar clic y escribir están desactivados |
Qué puede hacer el agente#
- Abrir, navegar y cerrar pestañas
- Inspeccionar una página: controles visibles con selectores estables, estado y atributos semánticos
- Encontrar controles por su texto visible o por sus atributos identificadores
- Dar clic y llenar formularios (compatible con frameworks, con verificación antes/después)
- Hacer scroll y capturar pantallas, que llegan de regreso a tu chat
Cada acción reporta lo que realmente pasó — incluyendo si un clic de verdad cambió algo — para que el agente verifique en lugar de suponer.
Modelo de seguridad#
- Solo loopback — la extensión se conecta exclusivamente a direcciones locales que tú configuras.
- Códigos de un solo uso — los códigos caducan a los 5 minutos y solo sirven una vez; la credencial resultante nunca sale de tu Mac.
- Caducidad de comandos — los comandos que la extensión no recoge en 20 segundos se descartan, así que nada se ejecuta tarde.
- Las llaves las tienes tú — los pagos y las acciones destructivas siempre requieren tu confirmación explícita, en todos los niveles de permiso que permiten dar clic.
- Auditable — el JavaScript de la extensión viaja legible dentro del paquete de la app.
Descarga#
La extensión viene incluida con el Agent Server (assets/safari/PocketHook-Safari.zip), o descárgala directamente: PocketHook-Safari.zip — firmada y notarizada para macOS.