[Blog e guias](https://openscreenshot.app/pt-br/blog/) · Desenvolvedores e agentes

# Faça capturas de sites pela linha de comando

Use a CLI do OpenScreenShot para salvar capturas PNG com área de visualização fixa, captura de página inteira ou saída binária no stdout.

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

A CLI do OpenScreenShot captura uma página web como PNG usando um navegador compatível com Chrome instalado localmente. Ela é um pacote separado da extensão de navegador. Com Node.js, pnpm e Chrome instalados, execute:

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

O comando inicia um navegador headless separado, navega até a URL, grava a imagem e fecha o navegador. Ele não se conecta às abas nem ao perfil conectado do seu navegador do dia a dia.

## Defina a área de visualização explicitamente

Para uma captura da área de visualização, omita `--full`. A largura padrão é 1280 pixels e a altura padrão é 800 pixels. Defina as duas quando um layout precisar de um tamanho específico:

```
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
```

A largura aceita inteiros de 200 a 3840; a altura aceita inteiros de 200 a 2160. Uma área de visualização estreita testa o layout responsivo nessa largura. Ela não emula a entrada por toque, a proporção de pixels do dispositivo nem o navegador móvel de um celular: a CLI usa um user agent de desktop.

Adicione `--full` para capturar além da área de visualização. A captura de página inteira do navegador headless é diferente da implementação de rolar e juntar da extensão; não presuma que todas as páginas dinâmicas vão ficar idênticas nas duas.

## Salve um arquivo ou grave no stdout

Sem `--out`, o comando grava `screenshot.png` no diretório atual. Use um nome de arquivo explícito para identificar os artefatos com facilidade. Crie o diretório de saída pai antes de executar o comando.

`--out -` grava os bytes do PNG no stdout:

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

Use um redirecionamento seguro para dados binários. A CLI sempre gera PNG; dar o nome `capture.jpg` ou `capture.pdf` à saída não a converte. Para imagens anotadas ou saída em PDF, use o [editor da extensão](https://openscreenshot.app/pt-br/docs/#export).

## Oculte dados antes de salvar

Três flags cobrem dados com tarjas pretas na página antes da captura, então os pixels sem ocultação nunca chegam ao PNG. Repita cada flag para mais alvos:

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

`--redact` cobre cada elemento que corresponde a um seletor CSS, com todos os seus filhos. `--redact-pattern` cobre textos e valores de formulário que correspondem a `email`, `phone` (de 9 a 15 dígitos) ou `secret` (formatos comuns de chaves de API e tokens, e hashes longos). `--redact-rect x,y,w,h` cobre um retângulo em pixels da imagem de saída; use-o para canvas, imagens e iframes de outra origem.

A captura falha com o código de saída 1 e não grava nenhum arquivo se um seletor não corresponder a nada, se um retângulo ficar fora da imagem ou se a página mover um alvo durante a captura. Os padrões podem deixar passar textos divididos entre elementos ou desenhados em uma imagem, então confira o PNG antes de compartilhá-lo.

## Resolva falhas comuns

Se o Chrome não for encontrado, instale-o ou defina `CHROME_PATH` com o executável do navegador. Por exemplo, em um sistema Linux com o Chromium instalado neste caminho:

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

A navegação espera por `networkidle2` com um tempo limite de 30 segundos. O comando atual não tem opções personalizadas de espera, espera por seletor, cookie ou login. Uma captura bem-sucedida também não prova que o aplicativo carregou corretamente: inspecione o PNG em busca de páginas de erro, estados de carregamento e recursos ausentes.

O código de saída 0 indica que o comando de captura terminou, 1 indica uma falha na captura e 2 indica uso inválido ou argumentos inválidos na validação. Use esses códigos ao encadear comandos e depois revise a própria imagem.

Para artefatos repetíveis, leia [o guia de capturas em CI](https://openscreenshot.app/pt-br/blog/screenshots-for-ci/). Para um fluxo conduzido por agentes, veja [o guia de configuração do MCP](https://openscreenshot.app/pt-br/blog/screenshot-mcp-server/). O [código-fonte da CLI](https://github.com/pghqdev/OpenScreenShot/tree/main/mcp/src) é a referência para as flags disponíveis.

## Continue

[Leia a documentação](https://openscreenshot.app/pt-br/docs/), [veja todos os guias](https://openscreenshot.app/pt-br/blog/) ou [obtenha ajuda com uma captura](https://openscreenshot.app/pt-br/support/).

---

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