OpenClaw Automação de Navegador

## Visão Geral

Automatize tarefas repetitivas do navegador em sites autorizados — navegue por páginas, extraia dados estruturados, preencha formulários, capture capturas de tela como evidência e execute testes de regressão visual. Construído sobre três habilidades comprovadas: **browser-use** para controle interativo do navegador, **firecrawl** para web scraping e extração de conteúdo, e **webapp-testing** para testes de UI baseados em Playwright.

## Início Rápido

1. Instale o plugin:
   ```bash
   npx skillstore add @openclaw-browser-automation
   ```
2. Use **browser-use** para navegar e interagir com uma página:
   ```
   browser-use open https://dashboard.example.com
   browser-use state
   browser-use click 5
   browser-use screenshot
   ```
3. Use **firecrawl** para extrair o conteúdo da página como markdown estruturado:
   ```
   firecrawl scrape https://example.com/data
   ```
4. Use **webapp-testing** para executar um teste visual do Playwright:
   ```
   python scripts/with_server.py --url http://localhost:3000 -- pytest test_ui.py
   ```

## Exemplo de Fluxo de Trabalho Completo

**Login → Extrair Dados da Tabela → Evidência de Captura de Tela → Exportar**

1. Abra seu painel de destino com **browser-use**
2. Preencha o formulário de login e envie as credenciais
3. Navegue para a página da tabela de dados
4. Use **firecrawl** para extrair a tabela para JSON/CSV limpo
5. Capture uma captura de tela com **browser-use** para trilha de auditoria
6. Valide a saída com asserções **webapp-testing**

## Habilidades Principais

- **browser-use** — Navegue por URLs, clique em elementos, preencha formulários, digite texto, capture capturas de tela, extraia dados de páginas renderizadas. Mantém sessões persistentes do navegador entre comandos.
- **firecrawl** — Extraia qualquer URL em markdown limpo otimizado para contexto LLM. Lida com renderização JavaScript, contorna bloqueios comuns, suporta rastreamento e mapeamento de sites.
- **webapp-testing** — Conjunto de ferramentas baseado em Playwright para verificar funcionalidade frontend, depurar comportamento de UI, capturar capturas de tela do navegador e visualizar logs do console.

## Segurança e Limitações

- **Somente sites autorizados** — Automatize apenas sites que você tem permissão explícita para acessar
- **Fallback de Captcha/2FA** — Quando desafios de CAPTCHA, 2FA ou anti-bot aparecerem, o fluxo de trabalho pausa para intervenção humana. Não tente contornar medidas de segurança.
- **Mudanças na estrutura da página** — Se os seletores quebrarem devido a atualizações do site, reexecute `browser-use state` para atualizar os índices dos elementos
- **Limitação de taxa** — Respeite os limites de taxa do site de destino; adicione atrasos entre as requisições ao extrair dados

## Dicas

- Combine com **openclaw-automation-healthcheck** para painéis de monitoramento automatizados
- Use `browser-use screenshot` em etapas-chave para criar trilhas de auditoria visuais
- Para extração em larga escala, prefira **firecrawl** ao invés de browser-use, pois ele lida com renderização JavaScript no lado do servidor