web-screenshot

name	web-screenshot
description	Captures high-quality screenshots of web pages or local HTML files using Puppeteer. Supports responsive viewports, full-page capture, and PDF export.
license	MIT
metadata	{"version":"1.0.0","author":"mapplics","dependencies":["puppeteer"]}

Web Screenshot

Herramienta de captura automatizada basada en Puppeteer (Chrome Headless). Diseñada para funcionar en Docker o nativamente si Node.js está disponible.

🎯 Cuándo Usarlo (Triggers)

Usa este skill cuando el usuario pida:

• "Tomar una captura de pantalla de..."
• "Capturar esta URL"
• "Generar un screenshot de la web"

🚀 Uso

Capturar URL o Archivo

Crea una imagen PNG de una URL pública o un archivo HTML local.

# Uso directo del script
./skills/web-screenshot/bin/snap.sh <input_url_or_file> <output_path> [options]

# Ejemplo
./skills/web-screenshot/bin/snap.sh https://google.com screenshot.png
./skills/web-screenshot/bin/snap.sh docs/output.html docs/preview.png

⚙️ Opciones

No hay flags complejos expuestos en snap.sh actualmente, pero el script subyacente snap.js soporta:

• Detección automática de tamaño de contenido (full page).
• Viewport estándar 1920x1080.
• Espera a networkidle0 para asegurar carga completa.

📦 Docker vs Local

El script bin/snap.sh gestiona automáticamente el entorno:

1. Local: Si node y node_modules existen, usa el host (más rápido).
2. Docker: Si no, usa la imagen web-screenshot:1.0 (aislado, portable).

🛠️ Instalación (Local)

Para habilitar ejecución local (más rápida):

cd skills/web-screenshot
npm install