HTML no n8n: extrair dados de páginas
Entenda as três operações do nó HTML do n8n, configure o Extract HTML Content depois do HTTP Request e saiba como montar e-mails e tabelas em HTML.
Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o tutorial: HTML no n8n: extrair dados de páginas Arte: Eleven Host
O html no n8n é o nó HTML: ele lê o HTML que chega de outro nó, extrai textos, links e atributos com seletores CSS, monta trechos de HTML com dados do fluxo e converte dados em tabela.
Atualizado em 15/11/2026. Em 15/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026.
O que é o nó HTML
O nó HTML tem três operações, com estes nomes na interface:
- Generate HTML Template: monta HTML a partir de um modelo, com expressões do n8n;
- Extract HTML Content: tira dados de um HTML usando seletores CSS;
- Convert to HTML Table: transforma os itens recebidos em uma tabela HTML.
Segundo a documentação do n8n, o nó HTML está disponível desde a versão 0.213.0 e substituiu o nó HTML Extract. Quem encontrar tutoriais antigos com o nome HTML Extract está diante do nó anterior; no n8n atual, a extração é a operação Extract HTML Content do nó HTML. A página do nó mantém um link para a documentação do HTML Extract, para quem usa uma versão mais antiga.
Para quem serve
O nó HTML interessa a quem já roda o n8n na própria VPS e quer tirar dados de páginas da web, como títulos, preços, links e imagens, ou montar HTML para um e-mail ou um relatório. Se a VPS ainda não existe, veja o que é um servidor VPS e como escolher um plano.
Do plano de entrada ao maior, os preços de VPS estão na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
O fluxo: HTTP Request e depois HTML
O nó HTML não vai até a internet. Primeiro, um nó HTTP Request busca a página; depois, o nó HTML trabalha sobre o conteúdo que o HTTP Request entregou. O fluxo básico tem esta ordem:
- HTTP Request, com o método GET e o endereço da página;
- HTML, com a operação Extract HTML Content;
- opcionalmente, Split Out, para tratar cada item extraído separadamente.
O nó HTML só lê o HTML que chega até ele; quem baixa a página é o HTTP Request.
Configurar o Extract HTML Content
Em Source Data, escolha de onde vem o HTML. A opção JSON pede o campo JSON Property, que deve ter o nome da propriedade onde o HTTP Request deixou o HTML. Esse nome depende da configuração do HTTP Request. No exemplo do blog oficial do n8n, de 31/05/2023, o HTTP Request usa o método GET com resposta em formato String, e a propriedade de saída se chama data. Na sua instância, abra a saída do HTTP Request e confira o nome do campo antes de preencher.
A opção Binary pede o campo Input Binary Field. Segundo a documentação, nas duas opções a entrada pode conter uma string ou um array de strings.
Em Extraction Values, cada linha descreve um dado a extrair:
- Key: o nome da chave na saída;
- CSS Selector: o seletor que localiza o elemento na página;
- Return Value: o que devolver do elemento;
- Attribute: o nome do atributo, quando o Return Value for Attribute.
O Return Value tem quatro escolhas:
- Attribute: devolve o valor de um atributo, como class, de um elemento;
- HTML: devolve o HTML contido no elemento;
- Text: devolve o conteúdo de texto do elemento;
- Value: devolve o valor de um input, select ou textarea.
Com Text, aparece o campo Skip Selectors, uma lista de seletores, separados por vírgula, a ignorar. Esse campo só aparece com Return Value igual a Text e com o nó na versão 1.2; em fluxos antigos, com o nó em versão anterior, ele pode não aparecer.
Return Array e as opções de texto
O Return Array define como os valores saem. Ligado, o n8n devolve vários valores como um array; desligado, devolve tudo como uma única string.
Em Options há duas escolhas. Trim Values controla se os espaços e as quebras de linha do início e do fim dos valores são removidos. Clean Up Text, quando ligada, também remove espaços e quebras de linha do início e do fim e condensa espaços repetidos em um só.
Um exemplo de seletor CSS
O blog oficial do n8n usa o seletor .row > li para pegar os itens de uma lista, com Return Value igual a HTML e Return Array ligado, seguido de um Split Out para tratar um item por vez.
Um exemplo montado para ilustrar, para conferir na sua instância: numa página de produtos em que cada título é um <h2 class="titulo">, a linha de Extraction Values teria Key igual a titulo, CSS Selector igual a h2.titulo e Return Value igual a Text. Para pegar o endereço de um link, o seletor seria a.produto, com Return Value igual a Attribute e Attribute igual a href.
Os nomes de classe e a estrutura mudam de site para site. Para descobrir o seletor certo, clique com o botão direito no elemento no navegador, escolha a opção de inspecionar e observe a tag e as classes.
Páginas montadas por JavaScript
Algumas páginas trazem o conteúdo vazio e o preenchem no navegador, com JavaScript. Como o HTTP Request recebe o HTML da resposta e o nó HTML trabalha sobre esse HTML, o dado que só aparece depois do JavaScript pode não estar lá. O nó HTML também não faz login nem navega pela página.
Uma conferência prática: abra o código-fonte da página no navegador e procure o texto que você quer extrair. Se ele estiver no código-fonte, o texto provavelmente chega também ao HTTP Request; confira na saída dele. Se não estiver, há dois caminhos possíveis. O primeiro é abrir as ferramentas do desenvolvedor do navegador, na aba de rede, achar a chamada de API que a página faz e repetir essa chamada no HTTP Request. O segundo é procurar um JSON embutido numa tag script da própria página e extrair esse trecho.
Generate HTML Template
A operação Generate HTML Template tem o campo HTML Template. Segundo a documentação, ele aceita HTML padrão, CSS dentro de <style>, JavaScript dentro de <script> e expressões entre {{ }}, que podem usar os métodos e as variáveis embutidos do n8n. A documentação também avisa que o n8n não executa o JavaScript do template.
Um exemplo de uso: o corpo de um e-mail com a lista de itens extraídos na etapa anterior. O HTML do corpo fica no template, e as expressões entre {{ }} trazem os valores de cada execução. Esse uso é só um exemplo para ilustrar. Envie um teste para você mesmo antes de usar com clientes. O artigo Google Calendar no n8n: criar e ler eventos mostra outra integração do n8n.
Cuidado com XSS no template
A documentação alerta que gerar HTML pode introduzir XSS (injeção de código em páginas) e classifica isso como um risco de segurança. O aviso pede cuidado com entradas não confiáveis, e a página do nó indica o material da OWASP sobre o tema.
Na prática, texto que veio de uma página raspada ou de um formulário público é entrada não confiável. Recomendamos não colocar esse texto, sem revisão, dentro de um template que será aberto em navegador.
Convert to HTML Table
A operação Convert to HTML Table pega a entrada de outro nó e a transforma em tabela. Ela não tem parâmetros, apenas Options:
- Capitalize Headers: controla a capitalização dos cabeçalhos;
- Custom Styling: permite aplicar estilo próprio à tabela;
- Caption: define a legenda da tabela;
- Table Attributes: atributos aplicados ao elemento table;
- Header Attributes: atributos aplicados aos cabeçalhos th;
- Row Attributes: atributos aplicados às linhas tr;
- Cell Attributes: atributos aplicados às células td.
Um exemplo de uso é um relatório semanal: um fluxo reúne os dados, o Convert to HTML Table monta a tabela e um nó de e-mail a envia no corpo da mensagem. O artigo Windmill na VPS: automações e scripts da equipe apresenta outra ferramenta de automação para quem quer comparar caminhos.
Boas práticas ao raspar páginas
O blog oficial do n8n lembra que alguns sites proíbem a coleta automática nos termos de uso, e que a violação dos termos pode levar a bloqueios e até a ação judicial. O mesmo texto orienta a ler os termos de uso, a política de privacidade e o arquivo robots.txt antes de raspar, descreve o robots.txt como uma orientação de cortesia e diz que os termos de uso têm prioridade sobre ele. Também orienta a espaçar as requisições para não sobrecarregar o servidor do site.
Recomendamos seguir esse caminho: ler os termos do site, consultar o robots.txt, buscar só o que o fluxo precisa e usar um intervalo entre as requisições, em vez de disparar muitas de uma vez. Recomendamos também evitar a coleta de dados pessoais sem uma base clara para isso.
Onde conferir os nomes dos campos
A página do nó HTML fica em docs.n8n.io, na seção de core nodes, e traz os campos e as opções do nó.
Valores e descrições de cada plano ficam na página da loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
O nó HTML baixa a página sozinho?
Não. Quem baixa a página é o HTTP Request. O nó HTML trabalha sobre o HTML que recebe.
Qual é a diferença entre HTML Extract e o nó HTML?
O HTML Extract é o nome do nó antigo. Segundo a documentação, o nó HTML está disponível desde a versão 0.213.0 e o substituiu; a extração agora é a operação Extract HTML Content.
O que preencho em JSON Property?
O nome do campo onde o HTTP Request deixou o HTML. Confira na saída do HTTP Request, porque esse nome depende da configuração do nó.
O n8n executa o JavaScript do template?
Não. A documentação informa que o n8n não executa o JavaScript do Generate HTML Template.