OpenClaw Automatización de Navegador

## Descripción General

Automatiza tareas repetitivas del navegador en sitios web autorizados: navega por páginas, extrae datos estructurados, completa formularios, captura capturas de pantalla como evidencia y ejecuta pruebas de regresión visual. Construido sobre tres habilidades probadas: **browser-use** para control interactivo del navegador, **firecrawl** para web scraping y extracción de contenido, y **webapp-testing** para pruebas de UI basadas en Playwright.

## Inicio Rápido

1. Instala el plugin:
   ```bash
   npx skillstore add @openclaw-browser-automation
   ```
2. Usa **browser-use** para navegar e interactuar con una página:
   ```
   browser-use open https://dashboard.example.com
   browser-use state
   browser-use click 5
   browser-use screenshot
   ```
3. Usa **firecrawl** para extraer contenido de página como markdown estructurado:
   ```
   firecrawl scrape https://example.com/data
   ```
4. Usa **webapp-testing** para ejecutar una prueba visual de Playwright:
   ```
   python scripts/with_server.py --url http://localhost:3000 -- pytest test_ui.py
   ```

## Ejemplo de Flujo de Trabajo Completo

**Inicio de Sesión → Extraer Datos de Tabla → Captura de Evidencia → Exportar**

1. Abre tu panel de control objetivo con **browser-use**
2. Completa el formulario de inicio de sesión y envía las credenciales
3. Navega a la página de la tabla de datos
4. Usa **firecrawl** para hacer scraping de la tabla en JSON/CSV limpio
5. Toma una captura de pantalla con **browser-use** para el registro de auditoría
6. Valida el resultado con aserciones de **webapp-testing**

## Habilidades Clave

- **browser-use** — Navega URLs, haz clic en elementos, completa formularios, escribe texto, toma capturas de pantalla, extrae datos de páginas renderizadas. Mantiene sesiones de navegador persistentes entre comandos.
- **firecrawl** — Hace scraping de cualquier URL en markdown limpio optimizado para contexto LLM. Maneja renderizado JavaScript, evita bloqueos comunes, soporta crawling y mapeo de sitios.
- **webapp-testing** — Conjunto de herramientas basado en Playwright para verificar funcionalidad frontend, depurar comportamiento de UI, capturar capturas de pantalla del navegador y ver registros de consola.

## Seguridad y Limitaciones

- **Solo sitios autorizados** — Solo automatiza sitios web en los que tienes permiso explícito para acceder
- **Captcha/2FA fallback** — Cuando aparecen CAPTCHA, 2FA o desafíos anti-bot, el flujo de trabajo se pausa para intervención humana. No intentes evitar medidas de seguridad.
- **Cambios en estructura de página** — Si los selectores se rompen debido a actualizaciones del sitio, vuelve a ejecutar `browser-use state` para refrescar los índices de elementos
- **Rate limiting** — Respeta los límites de tasa del sitio objetivo; agrega retrasos entre solicitudes al hacer scraping

## Consejos

- Combina con **openclaw-automation-healthcheck** para paneles de monitoreo automatizados
- Usa `browser-use screenshot` en pasos clave para crear registros de auditoría visual
- Para extracción a gran escala, prefiere **firecrawl** sobre browser-use ya que maneja el renderizado JavaScript del lado del servidor