Camofox Browser
Camofox Browser explicado: un servicio de navegador para agentes, no solo HTML
Distingue el servicio REST de Camofox y el motor Camoufox, comprende instantáneas accesibles y referencias, y define un primer uso autorizado.
Qué aprenderás
- Camofox es la capa de servicio y Camoufox el motor.
- Instantáneas y capturas responden a preguntas diferentes.
- Los cambios de página requieren referencias actuales.
Antes de empezar
- HTTP y JSON básicos
- Servicio aislado y página propia o permitida
Explica la frontera real del servicio y verifica la muestra de observación o ciclo propuesta.
Conclusiones clave
- Camofox es la capa de servicio y Camoufox el motor.
- Instantáneas y capturas responden a preguntas diferentes.
- Los cambios de página requieren referencias actuales.
Dos nombres para capas diferentes
Camofox Browser envuelve el motor Camoufox en un servicio para clientes de automatización y agentes. El paquete inspeccionado es @askjo/camofox-browser, versión 1.14.0. Su API REST crea pestañas, devuelve observaciones y aplica acciones. Camoufox es el navegador basado en Firefox; API, ciclo de sesión y configuración del servicio constituyen responsabilidades diferentes.
El README destaca compatibilidad con sitios que detectan automatización. Son afirmaciones del proyecto, no garantías demostradas aquí. La compatibilidad no autoriza acceder a cuentas, contenido protegido o servicios que rechazan acceso automatizado. Evalúa en un sitio propio o una tarea expresamente permitida y detente ante restricciones, sin tratarlas como errores que deban superarse.
Observar antes de actuar
El servicio ofrece instantáneas de accesibilidad y referencias breves como e1. Permiten al agente leer roles y nombres sin consumir todo el HTML. Una captura de pantalla cumple otro propósito: ayuda a evaluar apariencia, mientras la instantánea semántica localiza controles. Ninguna representación demuestra por sí sola que se haya capturado toda la información de la página.
Las referencias no son identificadores permanentes del sitio. El servidor revisado las asocia con rol, nombre e índice de ocurrencia, además del marco cuando procede. Navegar o cambiar la página puede invalidar esa asociación. La integración debe observar, elegir una acción adecuada y observar de nuevo; reutilizar una referencia antigua puede actuar sobre un estado equivocado.
Definir la frontera del producto antes de adoptarlo
Un servicio de navegador mantiene recursos y posiblemente sesiones autenticadas. El cliente gestiona identificadores de usuario, grupos, pestañas y limpieza; una conexión HTTP correcta no completa un flujo de agente. Los capítulos de arquitectura y seguridad distinguen contexto de navegador y autorización, así como un servicio inactivo saludable y un navegador que realmente renderizó una página.
El paquete declara MIT, pero eso no licencia automáticamente cada dependencia, sitio visitado o recurso capturado. La serie inspecciona un commit fijo y ejecuta solo algunos auxiliares puros. No afirma haber instalado el navegador completo, medido compatibilidad en sitios reales ni certificado la seguridad de un servicio alojado.
Pasos de implementación
- 1
Elige una página propia o expresamente autorizada.
- 2
Identifica cliente, servicio y motor.
- 3
Define observación esperada y acción permitida antes de abrir una pestaña.
Ejemplo para copiar
{
"task": "inspeccionar formulario propio",
"authorization": "aprobación del propietario",
"observation": "instantánea y captura opcional",
"action": "solo lectura inicial",
"success": "encabezado y etiquetas esperados presentes"
}Preguntas frecuentes
¿Camofox y Camoufox son el mismo proyecto?
No. Camofox proporciona un servicio de automatización alrededor del motor Camoufox; sus responsabilidades y configuración difieren.
¿Las referencias e1 sobreviven a la navegación?
No lo presupongas. El servidor reconstruye los mapas y notifica referencias obsoletas tras cambios de página.
Fuentes
- README.mdFuente verificada 2026-09-08
- package.jsonFuente verificada 2026-09-08
- DockerfileFuente verificada 2026-09-08
- lib/auth.jsFuente verificada 2026-09-08
- lib/snapshot.jsFuente verificada 2026-09-08
- lib/extract.jsFuente verificada 2026-09-08
- lib/config.jsFuente verificada 2026-09-08
- lib/reporter.jsFuente verificada 2026-09-08
- lib/page-lease.jsFuente verificada 2026-09-08
- server.jsFuente verificada 2026-09-08
- tests/unit/snapshot.test.jsFuente verificada 2026-09-08
- tests/unit/auth.test.jsFuente verificada 2026-09-08