¿Qué es la extensión de Safari de PocketHook?#
Una extensión de Safari para macOS que permite a tu Agent Server autoalojado trabajar dentro de tu navegador real: abrir y cerrar pestañas, leer páginas, encontrar y pulsar controles, rellenar formularios y capturar pantallas — en tu sesión, con tus inicios de sesión, en tu máquina.
Todo funciona en local. La extensión solo habla con el Agent Server de tu propio Mac (loopback), y nada se envía a ningún otro sitio.
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:
- Ajustes → 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 Safari, introduce el código y pulsa Pair. El punto verde significa que estás conectado.
Comprueba 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 — hacer 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 identificativos
- Hacer clic y rellenar formularios (compatible con frameworks, con verificación antes/después)
- Hacer scroll y capturar pantallas, que llegan de vuelta a tu chat
Cada acción informa de lo que realmente ha pasado — incluido si un clic ha cambiado algo de verdad — 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 valen 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 hacer 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.