Base de Conhecimento

HTML no n8n: extrair dados de páginas

  • html no n8n, n8n, automação, extrair dados, seletor css, web scraping
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: HTML no n8n: extrair dados de páginas

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:

  1. HTTP Request, com o método GET e o endereço da página;
  2. HTML, com a operação Extract HTML Content;
  3. 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.

Esta resposta lhe foi útil?

Artigos Relacionados