[Blog y guías](https://openscreenshot.app/es/blog/) · Desarrolladores y agentes

# Haz capturas de sitios web desde la línea de comandos

Usa la CLI de OpenScreenShot para guardar capturas PNG con un viewport fijo, de página completa o como salida binaria a stdout.

Por [OpenScreenShot](https://github.com/pghqdev/OpenScreenShot)

La CLI de OpenScreenShot captura una página web como PNG con un navegador compatible con Chrome instalado en tu equipo. Es un paquete aparte de la extensión del navegador. Con Node.js, pnpm y Chrome instalados, ejecuta:

```
pnpm dlx openscreenshot shot https://example.com --out screenshot.png --full
```

El comando inicia un navegador headless aparte, navega a la URL, escribe la imagen y cierra el navegador. No se conecta a las pestañas ni al perfil con sesión iniciada de tu navegador habitual.

## Define el viewport de forma explícita

Para una captura del viewport, omite `--full`. El ancho por defecto es de 1280 píxeles y el alto, de 800 píxeles. Define ambos cuando un diseño necesita un tamaño concreto:

```
pnpm dlx openscreenshot shot https://example.com --out desktop.png --width 1440 --height 900
pnpm dlx openscreenshot shot https://example.com --out narrow.png --width 390 --height 844
```

El ancho acepta enteros de 200 a 3840; el alto acepta enteros de 200 a 2160. Un viewport estrecho prueba el diseño responsive a ese ancho. No emula la entrada táctil, la proporción de píxeles del dispositivo ni el navegador móvil de un teléfono: la CLI usa un user agent de escritorio.

Añade `--full` para capturar más allá del viewport. La captura de página completa del navegador headless es distinta de la implementación de la extensión, que desplaza y une; no des por hecho que todas las páginas dinámicas se verán igual en ambas.

## Guarda un archivo o escribe a stdout

Sin `--out`, el comando escribe `screenshot.png` en el directorio actual. Usa un nombre de archivo explícito para que los artefactos sean fáciles de identificar. Crea el directorio de salida antes de ejecutar el comando.

`--out -` escribe los bytes PNG a stdout:

```
pnpm dlx openscreenshot shot https://example.com --out - > screenshot.png
```

Usa una redirección segura para datos binarios. La CLI siempre produce PNG; llamar a la salida `capture.jpg` o `capture.pdf` no la convierte. Para imágenes anotadas o salida PDF, usa el [editor de la extensión](https://openscreenshot.app/es/docs/#export).

## Oculta los datos antes de guardar

Tres opciones tapan los datos con recuadros negros en la página antes de la captura, así que los píxeles sin ocultar nunca llegan al PNG. Repite cada opción para añadir más objetivos:

```
pnpm dlx openscreenshot shot https://example.com --out safe.png \
  --redact "#account-menu" --redact-pattern email,secret --redact-rect 0,0,200,40
```

`--redact` tapa cada elemento que coincide con un selector CSS, con todos sus hijos. `--redact-pattern` tapa el texto y los valores de formulario que coinciden con `email`, `phone` (de 9 a 15 dígitos) o `secret` (formatos habituales de claves de API y tokens, y hashes largos). `--redact-rect x,y,w,h` tapa un rectángulo en píxeles de la imagen de salida; úsala para canvas, imágenes e iframes de otro origen.

La captura falla con el código de salida 1 y no escribe ningún archivo si un selector no coincide con nada, un rectángulo queda fuera de la imagen o la página mueve un objetivo durante la captura. Los patrones pueden pasar por alto texto dividido entre varios elementos o dibujado en una imagen, así que revisa el PNG antes de compartirlo.

## Resuelve los fallos más comunes

Si no se encuentra Chrome, instálalo o define `CHROME_PATH` con el ejecutable del navegador. Por ejemplo, en un sistema Linux con Chromium instalado en esa ruta:

```
CHROME_PATH=/usr/bin/chromium pnpm dlx openscreenshot shot https://example.com --out screenshot.png
```

La navegación espera a `networkidle2` con un tiempo límite de 30 segundos. El comando actual no tiene opciones de espera personalizada, espera por selector, cookies ni inicio de sesión. Una captura correcta tampoco demuestra que la aplicación cargara bien: revisa el PNG en busca de páginas de error, estados de carga y recursos que faltan.

El código de salida 0 indica que el comando de captura terminó, 1 indica un fallo de captura y 2 indica un uso no válido o argumentos validados. Usa esos códigos al encadenar comandos y luego revisa la propia imagen.

Para artefactos repetibles, lee [la guía de capturas en CI](https://openscreenshot.app/es/blog/screenshots-for-ci/). Para un flujo dirigido por un agente, consulta [la guía de configuración de MCP](https://openscreenshot.app/es/blog/screenshot-mcp-server/). El [código fuente de la CLI](https://github.com/pghqdev/OpenScreenShot/tree/main/mcp/src) es la referencia de las opciones disponibles.

## Sigue leyendo

[Lee la documentación](https://openscreenshot.app/es/docs/), [explora todas las guías](https://openscreenshot.app/es/blog/) u [obtén ayuda con una captura](https://openscreenshot.app/es/support/).

---

Canonical page: https://openscreenshot.app/es/blog/screenshot-cli/