Què és l’extensió de Safari de PocketHook?#
Una extensió de Safari per a macOS que permet al teu Agent Server autoallotjat treballar dins del teu navegador real: obrir i tancar pestanyes, llegir pàgines, trobar i prémer controls, omplir formularis i capturar pantalles — a la teva sessió, amb els teus inicis de sessió, a la teva màquina.
Tot funciona en local. L’extensió només parla amb l’Agent Server del teu propi Mac (loopback), i no s’envia res enlloc més.
Instal·lació#
L’extensió ve inclosa amb l’Agent Server com a app de macOS notaritzada — sense App Store, sense Xcode:
bun run safari:install
Això instal·la Pockethook Safari.app a /Applications i l’obre. Després, a Safari:
- Configuració → Extensions — activa PocketHook Safari i concedeix accés als llocs web.
- Genera un codi d’emparellament d’un sol ús al servidor:
bun run safari:code
- Obre el popup de l’extensió a la barra d’eines de Safari, introdueix el codi i prem Pair. El punt verd vol dir que estàs connectat.
Comprova la connexió quan vulguis amb bun run safari:status.
Nivells de permís#
Tu decideixes quanta autonomia té l’agent, per servidor, amb bun run safari:config:
| Nivell | Què significa |
|---|---|
confirm (per defecte) | Cada clic amb efectes externs (votar, enviar, publicar, comprar…) et demana confirmació primer |
autonomous | Vots, follows i enviaments s’executen sense preguntar; els pagaments, les eliminacions permanents i els canvis de compte o seguretat continuen demanant permís |
readonly | Només navegar, inspeccionar i capturar — fer clic i escriure estan desactivats |
Què pot fer l’agent#
- Obrir, navegar i tancar pestanyes
- Inspeccionar una pàgina: controls visibles amb selectors estables, estat i atributs semàntics
- Trobar controls pel seu text visible o pels seus atributs identificatius
- Fer clic i omplir formularis (compatible amb frameworks, amb verificació abans/després)
- Fer scroll i capturar pantalles, que tornen al teu xat
Cada acció informa del que ha passat realment — incloent-hi si un clic ha canviat res de debò — perquè l’agent verifiqui en lloc de suposar.
Model de seguretat#
- Només loopback — l’extensió es connecta exclusivament a adreces locals que tu configures.
- Codis d’un sol ús — els codis caduquen al cap de 5 minuts i només valen una vegada; la credencial resultant no surt mai del teu Mac.
- Caducitat de comandes — les comandes que l’extensió no recull en 20 segons es descarten, així res no s’executa tard.
- Les claus les tens tu — els pagaments i les accions destructives sempre requereixen la teva confirmació explícita, a tots els nivells de permís que permeten fer clic.
- Auditable — el JavaScript de l’extensió viatja llegible dins del paquet de l’app.
Descàrrega#
L’extensió ve inclosa amb l’Agent Server (assets/safari/PocketHook-Safari.zip), o descarrega-la directament: PocketHook-Safari.zip — signada i notaritzada per a macOS.