# Captura de site

> Capture uma página da web na largura de um celular: as seções em imagens na ordem da página, a página inteira, o mapa das seções e os números exatos.

Source: https://nodaro.ai/pt-BR/docs/nodes/automate/site-capture

O nó **Captura de site** abre uma página da web como um celular a mostra e fotografa cada uma das suas seções principais: o destaque, os recursos, os preços, as avaliações. O nó rola a página inteira primeiro, então as seções que aparecem durante a rolagem também são capturadas. As capturas saem na ordem da página, no formato de cartões de celular, prontas para aparecer na tela de um vídeo. O nó também retorna a página inteira em uma imagem, um mapa das seções e os números exatos que a página escreve, como preços, contagens e avaliações.

## Quando usar
- Mostrar uma página de produto real em um vídeo, por exemplo como cartões sobre um clipe de alguém falando.
- Descrever ou animar cada seção de uma página, uma execução por captura.
- Transformar uma página em uma apresentação de slides ou em uma colagem.
- Levar os preços e os números exatos de uma página para um roteiro, em vez de copiá-los de uma captura de tela.

## Início rápido
### Adicione o nó
Pressione Tab no canvas e escolha **Automatizar › Coleta de conteúdo › Captura de site**.

### Informe a página
Digite o endereço da página em **Página**, como você digita no navegador. O `https://` é opcional. Ou deixe **Página** em branco e conecte à entrada **URL da página** um nó cujo texto tenha o endereço.

### Execute
Clique em **Executar**. Uma captura costuma levar menos de um minuto e, no máximo, alguns minutos. O nó mostra o tempo decorrido durante a execução, e você pode interromper a execução. As capturas aparecem no nó.

### Use as capturas
Conecte a saída **Capturas** ao próximo nó. Defina a conexão como **Cada item** para executar esse nó uma vez por captura, ou como **Conjunto** para entregar todas as capturas a ele.

## Configurações
| Configuração | Padrão | O que faz |
| --- | --- | --- |
| **Página** | Em branco | A página a capturar. Quando está em branco, o nó usa o primeiro endereço da web do texto conectado à entrada **URL da página**. |
| **Capturas** | 8 | Quantas capturas de seção buscar, de 3 a 8. Uma página com menos seções gera menos. |

## Entradas
| Entrada | Obrigatória | O que conectar |
| --- | --- | --- |
| **URL da página** | Não | Um texto que tenha o endereço da página, como um nó [Texto](https://nodaro.ai/docs/nodes/automate/text). A partir de uma [Lista](https://nodaro.ai/docs/nodes/automate/list) de endereços, o nó é executado uma vez para cada endereço. |

## Saídas
| Saída | O que entrega |
| --- | --- |
| **Capturas** | As capturas das seções, na ordem da página. Uma conexão comum entrega a primeira. Uma conexão **Cada item** executa o próximo nó uma vez por captura, e uma conexão **Conjunto** entrega todas. A imagem da página inteira nunca é uma das capturas. |
| **JSON** | A captura inteira: a imagem da página inteira, as capturas, o mapa das seções da página com o seu texto, os números exatos da página (`facts`) e eventuais avisos. Use [Extrair campo](https://nodaro.ai/docs/nodes/automate/extract-field) para pegar uma parte dela, como `facts`. |

A saída JSON tem esta forma, resumida:

```json
{
"finalUrl": "https://www.example.com/",
"title": "Example: the product",
"fullPage": { "url": "https://…/full.jpg", "width": 412, "height": 6420 },
"stills": [{ "index": 0, "label": "Ship faster", "category": "hero", "url": "https://…/0.png" }],
"sections": [{ "order": 0, "label": "Ship faster", "category": "hero", "text": "…", "stillIndex": 0 }],
"facts": ["$12 per month", "4.8/5", "10,000 teams"],
"warnings": []
}
```

O `category` de uma seção é `hero`, `feature`, `pricing`, `proof`, `faq`, `cta` ou `other`.

## Créditos
Cada captura custa 11 créditos, qualquer que seja o número de capturas de seção.

- **Uma captura que falha é reembolsada:** uma página que bloqueia a visita, uma página sem nada, uma página que não pode ser acessada ou uma captura que fica sem tempo.
- **Algumas páginas são recusadas antes de qualquer cobrança:** a página de um site que pede para visitantes automáticos ficarem de fora (robots.txt), ou um endereço que não existe.

Em uma instalação auto-hospedada, a Captura de site precisa da chave de coleta da web descrita em [Chaves de provedores](https://nodaro.ai/docs/self-hosting/provider-keys), ou de uma [conexão com o Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect). Uma instalação também pode desativar a captura; o nó então não é oferecido.

## Dicas
- **Copie os números exatos.** Pegue os preços e os números da página em `facts`, na saída JSON, para que um roteiro nunca os leia errado em uma imagem.
- **Escolha as capturas que você precisa.** Cada captura tem um `category`, então dá para ficar só com o destaque e os preços.
- **As capturas ficam na sua biblioteca.** Elas não aparecem no seletor de mídia até você salvar uma.

## Solução de problemas
| Problema | Causa e solução |
| --- | --- |
| A captura falha com uma mensagem "blocked". | O site mostra uma página de verificação para visitantes automáticos ou os recusa. Para esse site, envie suas próprias capturas de tela. |
| Menos capturas do que o valor de **Capturas**. | A página tem menos seções, uma seção saiu em branco ou o título de uma seção nunca apareceu na tela. Essas seções são puladas, e os `warnings` da saída JSON as indicam. |
| Uma captura mostra um aviso de cookies ou de aplicativo. | O nó esconde os avisos de cookies que reconhece. Um aviso próprio do site pode continuar. Escolha outra captura ou recorte-a em um nó seguinte. |

## Pela API
`POST /v1/site-capture` executa a mesma captura por código, com `{ "url": "…", "maxStills": 8 }`. A resposta chega na hora com um `jobId`; leia a captura do job concluído com `GET /v1/jobs/:id`. Veja [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes) e [Jobs](https://nodaro.ai/docs/developers/api/jobs).

## Perguntas frequentes

### O que o nó Captura de site retorna?

Até 8 capturas das seções da página, como o destaque, os recursos e os preços, na ordem da página, cada uma no formato de um cartão de celular. Ele também retorna a página inteira em uma imagem, um mapa das seções da página e os números exatos que a página escreve, como preços e avaliações.

### Quantos créditos custa a Captura de site?

Cada captura custa 11 créditos, qualquer que seja o número de capturas de seção. Uma captura que falha, por exemplo porque a página bloqueia visitas automáticas, é reembolsada.

### Por que recebi menos capturas do que pedi?

Capturas é um limite máximo. Uma página com menos seções gera menos capturas, e uma captura que sai em branco é pulada. Os warnings da saída JSON dizem quais seções foram puladas.

### Dá para capturar várias páginas em uma execução?

Sim. Coloque os endereços em um nó Lista e conecte-o à entrada URL da página. O nó é executado uma vez para cada endereço.

### Por que a captura falhou em alguns sites?

Alguns sites bloqueiam visitas automáticas com uma página de verificação ou respondem com um erro. O nó falha com esse motivo e reembolsa os créditos. Para esses sites, envie suas próprias capturas de tela.