---
name: mcp-browser-automation
description: Navigate, inspect, and validate web interfaces with Playwright MCP, including iframe-heavy pages, downloads, and session reuse. Use when the agent must reproduce UI flows, verify post-fix behavior, or inspect browser-side failures.
---

# MCP Browser Automation

Questo skill guida l'agente nell'uso di `playwright-node` per testare applicazioni web, soprattutto quando serve una prova visiva o funzionale dopo modifiche a codice, dati o configurazioni.

## Workflow Ottimizzato

1. **Navigazione**: Inizia con `browser_session` `action: "navigate"` verso l'URL target.
2. **Ispezione Visiva**: Usa `browser_session` con `action: "screenshot"` o `action: "annotate"` prima di interagire.
3. **Interazione Precisa**: Preferisci `browser_session` `action: "click_by_id"` o `browser_interact` con selettori CSS robusti.
4. **Verifica**: Controlla sempre `browser_session` con `action: "get_console_logs"` e `action: "get_network_errors"`.

## Pagine Legacy E Tab In Iframe

Su applicazioni legacy il contenuto operativo puo vivere in iframe invece che nel DOM principale.

### Strategia Consigliata

1. Apri la pagina contenitore con `browser_session` `action: "navigate"`.
2. Se il DOM sembra incompleto, usa `browser_session` `action: "list_frames"`.
3. Seleziona il frame operativo con `browser_session` `action: "select_frame"`.
4. Solo dopo la selezione del frame usa gli altri tool interattivi.
5. Se cambi tab o pagina, ricontrolla il frame attivo.

## Sinergie e Best Practices

* Dopo modifiche via `mcp-database-expert` o `mcp-coldfusion-developer`, usa Playwright per la validazione finale.
* Se l'applicazione genera PDF o Excel, usa `browser_session` `action: "read_downloaded_file"` per una verifica veloce del contenuto scaricato.
* Usa `browser_session` con `action: "export_state"` e `action: "load_state"` per evitare login ripetitivi.

## Carica Riferimenti Solo Se Servono

* [references/test-patterns.md](references/test-patterns.md) per pattern comuni di login, tab, form e verifica di report scaricati.

## Risoluzione Problemi

* Se un elemento non si trova, usa `browser_session` `action: "get_dom"` per una vista testuale semplificata.
* Se un elemento e visibile ma assente nel DOM, verifica se il contenuto e dentro un iframe.
* Se la navigazione e bloccata, controlla la variabile `ALLOWED_URLS`.