DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-plugin-browser-qa

d

dsh-plugin-browser-qa

Manifest valid

QA con navegador real para DeepSeek Harness: abre URLs en Chrome/Edge via CDP, hace clic, escribe, captura pantalla, consola y red para diagnosticar bugs visuales y de comportamiento.

hasBundlePatch

dsh-plugin-browser-qa — QA con navegador real para DeepSeek Harness

Plugin MCP local que abre URLs reales en Chrome o Edge y le da al agente herramientas de QA: navegar, hacer clic, escribir, esperar elementos, capturas de pantalla, consola y red. Sin Playwright, sin navegadores descargados y sin dependencias externas: usa Chrome DevTools Protocol (CDP) sobre WebSocket.

English · Cómo funciona · MIT

Herramientas (10)

ToolQué hace
mcp__browser__openAbre una URL (lista blanca) y espera la carga.
mcp__browser__clickClic por selector CSS o por texto visible.
mcp__browser__typeEscribe en un input/textarea/contenteditable; opcional enviar formulario.
mcp__browser__waitEspera milisegundos o hasta que aparezca un selector.
mcp__browser__screenshotCaptura el viewport, la página completa o un elemento; devuelve la imagen dentro del resultado.
mcp__browser__consoleLogs y errores de consola capturados (filtrable por nivel/texto).
mcp__browser__networkRequests con método, URL, status, MIME y fallos (filtrable).
mcp__browser__readTexto visible de la página o de un selector.
mcp__browser__statusEstado del navegador, pestaña, lista blanca y modo.
mcp__browser__closeCierra la pestaña (y el navegador con shutdown:true).

Instalación

Desde DSH → Settings → Plugins: instala github:thegabopacheco-sudo/dsh-plugin-browser-qa y permite el script de instalación cuando DSH lo pida.

Por CLI (perfiles que no administra la app):

dsh plugin --profile <perfil> add github:thegabopacheco-sudo/dsh-plugin-browser-qa

El postinstall copia el runtime a <DSH_HOME>\plugins\browser-qa.

Requisitos: Windows 10/11, Node ≥ 20 (lo aporta el harness) y Chrome o Edge instalado. El plugin lanza el navegador solo (headless por defecto).

Configuración

VariableUso
DSH_BROWSER_ALLOWED_DOMAINSLista blanca separada por comas (default: localhost,127.0.0.1,wendigocio.com,.wendigocio.com).
DSH_BROWSER_ALLOW_ALL1 desactiva la lista blanca (solo para entornos de confianza).
DSH_BROWSER_HEADLESS0 abre el navegador con ventana (default headless).
DSH_BROWSER_PORTPuerto de depuración CDP (default 9333).
DSH_BROWSER_PATHRuta explícita a chrome.exe / msedge.exe.
DSH_BROWSER_MODEread-only deshabilita click y type.
DSH_BROWSER_SKIP_POSTINSTALL1 omite el despliegue del postinstall.

Datos locales: capturas en <DSH_HOME>\cache\browser-qa\shots, auditoría en <DSH_HOME>\cache\browser-qa\audit.jsonl.

Seguridad

  • Lista blanca de dominios en open (configurable).
  • Read-only opcional: sin clic ni escritura.
  • Auditoría de navegación, clics y escritura.
  • Rate limit de 120 acciones por minuto.
  • Las instrucciones del modelo prohíben credenciales reales, compras, envíos o borrados sin confirmación.
  • No lee el perfil del usuario: usa un user-data-dir aislado en el cache.

Uso típico

  1. «Abre http://localhost:3000/owner, tómame una captura y dime qué se ve.»
  2. «Haz clic en el botón Guardar y comprueba si aparece el mensaje.»
  3. «Revisa la consola y la red después de cargar: ¿qué requests fallaron?»
  4. «Escribe prueba en el buscador, envía y captura el resultado.»

Solución de problemas

  • “Install scripts need your permission”: aprueba el postinstall. Si el cartel vuelve en bucle, revisa <perfil>\pnpm-workspace.yaml: los valores de allowBuilds deben ser true (no el placeholder set this to true or false).
  • No encuentra navegador: instala Chrome/Edge o define DSH_BROWSER_PATH.
  • No aparecen las tools: verifica <DSH_HOME>\plugins\browser-qa\server.mjs y la fila mcp-browser-qa; reinicia DSH si hace falta.
  • Dominio bloqueado: agrégalo a DSH_BROWSER_ALLOWED_DOMAINS.

Desarrollo

npm install
npm run build:bundle
cd test; npm install; node connect-test.mjs

Licencia

MIT © thegabopacheco-sudo

Comments

Loading…