n8n

​

Introdução ao Firecrawl e ao n8n

​

Por que usar o Firecrawl com o n8n?

• Extraem dados de qualquer site de forma confiável
• Conectam dados extraídos a outras ferramentas de negócios
• São executados conforme agendamentos ou acionados por eventos
• Escalam de tarefas simples a pipelines complexos

​

Etapa 1: Crie sua conta no Firecrawl

​

Cadastre-se no Firecrawl

1. Acesse firecrawl.dev no navegador
2. Clique no botão “Começar” ou “Cadastre-se”
3. Crie uma conta usando seu endereço de e-mail ou login do GitHub
4. Verifique seu e-mail, se solicitado

​

Obtenha sua chave de API

1. Acesse o painel do Firecrawl
2. Vá até a página de chaves de API
3. Clique em “Create New API Key”
4. Dê à chave um nome descritivo, como “Integração n8n”
5. Copie a chave de API gerada e salve-a em um local seguro

​

Etapa 2: Configure o n8n

​

Escolha sua versão do n8n

• Não requer instalação
• Plano Free disponível
• Infraestrutura gerenciada
• Atualizações automáticas

• Controle total sobre os dados
• Execute em seus próprios servidores
• Requer a instalação do Docker
• Ideal para usuários avançados com requisitos específicos de segurança

​

Opção A: n8n Cloud (Recomendado para iniciantes)

1. Acesse n8n.cloud
2. Clique em “Começar grátis” ou “Cadastre-se”
3. Cadastre-se com seu endereço de e-mail ou conta do GitHub
4. Conclua o processo de verificação
5. Você será direcionado ao painel do n8n

​

Opção B: Auto-hospedado com Docker

• Docker Desktop instalado no computador
• Conhecimento básico de linha de comando/terminal

1. Abra o terminal ou prompt de comando
2. Crie um volume do Docker para persistir os dados do seu fluxo de trabalho:

docker volume create n8n_data

3. Execute o contêiner Docker do n8n:

docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n

4. Aguarde o n8n iniciar. Você verá uma saída indicando que o servidor está em execução
5. Abra o navegador e acesse http://localhost:5678
6. Crie sua conta do n8n registrando-se com um e-mail

​

Entendendo a interface do n8n

• Fluxos de trabalho: suas automações salvas aparecem aqui
• Execuções: histórico das execuções dos fluxos de trabalho
• Credenciais: chaves de API e tokens de autenticação armazenados
• Configuração: configuração da conta e do espaço de trabalho

​

O Canvas do Fluxo de Trabalho

• Canvas: A área principal onde você posiciona e conecta nós
• Botão Adicionar Nó (+): Clique nele para adicionar novos nós ao fluxo de trabalho
• Painel de Nós: Abre ao clicar em ”+” e exibe todos os nós disponíveis
• Executar Fluxo de Trabalho: Executa manualmente o fluxo de trabalho para testes
• Salvar: Salva a configuração do fluxo de trabalho

​

Etapa 3: Instale e configure o nó do Firecrawl

​

Adicione o nó do Firecrawl ao seu fluxo de trabalho

1. No canvas do seu novo fluxo de trabalho, clique no botão ”+” no centro
2. O painel de seleção de nós será aberto no lado direito
3. Na caixa de busca na parte superior, digite “Firecrawl”
4. O nó do Firecrawl aparecerá nos resultados da busca

5. Clique em “Instalar” ao lado do nó do Firecrawl
6. Aguarde a conclusão da instalação (isso leva alguns segundos)
7. Após a instalação, clique no nó do Firecrawl para adicioná-lo ao canvas

​

Conecte sua chave de API do Firecrawl

1. Clique na caixa do nó do Firecrawl para abrir o painel de configuração à direita
2. Na parte superior, você verá um menu suspenso “Credencial para conectar”
3. Como esta é a primeira vez que você faz isso, clique em “Criar nova credencial”

4. Uma janela de configuração da credencial será aberta
5. Insira um nome para essa credencial (por exemplo, “Minha conta do Firecrawl”)
6. Cole sua chave de API do Firecrawl no campo “Chave de API”
7. Clique em “Salvar” na parte inferior

​

Teste a conexão

1. Com o nó Firecrawl ainda selecionado, veja o painel de configuração
2. Defina Resource como “Scraping” e Operation como “Scrape URL”
3. No campo “URL”, insira: https://firecrawl.dev
4. Por enquanto, mantenha as outras configurações nos valores padrão
5. Clique no botão “Execute step”

​

Etapa 4: Crie seu bot do Telegram

​

Crie um bot com o BotFather

1. Abra o Telegram no celular ou computador
2. Pesquise por “@BotFather” (o bot oficial do Telegram)
3. Inicie uma conversa com o BotFather clicando em “Iniciar”
4. Envie o comando /newbot para criar um novo bot
5. O BotFather pedirá que você escolha um nome para o bot (esse é o nome de exibição que os usuários verão)
6. Insira um nome como “Meu Bot Firecrawl”
7. Em seguida, escolha um nome de usuário para o bot. Ele deve terminar com “bot” (por exemplo, “my_firecrawl_updates_bot”)
8. Se o nome de usuário estiver disponível, o BotFather criará o bot e enviará uma mensagem com o token do bot

​

Encontre seu ID de chat

1. Abra o navegador e acesse esta URL (substitua YOUR_BOT_TOKEN pelo token do seu bot):
   https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
   
2. Mantenha esta aba do navegador aberta
3. No Telegram, pesquise o nome de usuário do bot que você acabou de criar
4. Inicie uma conversa com o bot clicando em “Iniciar”
5. Envie qualquer mensagem para o bot (por exemplo, “olá”)
6. Volte à aba do navegador e atualize a página
7. Procure o campo "chat":{"id": na resposta JSON
8. O número ao lado de "id": é seu ID de chat (por exemplo, 123456789)
9. Salve esse ID de chat para usar mais tarde

​

Etapa 5: Crie fluxos de trabalho práticos com o Telegram

​

Exemplo 1: Resumo diário das atualizações do produto Firecrawl

• Faz scraping do blog de atualizações de produto do Firecrawl diariamente às 9h
• Usa IA para gerar um resumo do conteúdo
• Envia o resumo para seu Telegram

1. Crie um novo fluxo de trabalho no n8n
2. Adicione um nó Schedule Trigger:
   • Clique no botão ”+” no canvas
   • Busque por “Schedule Trigger”
   • Configure: todos os dias às 9h

3. Adicione o nó Firecrawl:
   • Clique em ”+” ao lado de Schedule Trigger
   • Busque e adicione “Firecrawl”
   • Selecione sua credencial do Firecrawl
   • Configure:
     • Resource: Scraping
     • Operation: Scrape URL
     • URL: https://www.firecrawl.dev/blog/category/product-updates
     • Scrape Options: adicione Formats e selecione “Summary”

4. Adicione o nó Telegram:
   • Clique em ”+” ao lado de Firecrawl
   • Busque por “Telegram”
   • Clique em “Send a text message” para adicioná-lo ao canvas
5. Configure as credenciais do Telegram:
   • Clique no nó Telegram para abrir a configuração
   • No menu suspenso “Credencial para conexão”, clique em “Criar Nova Credencial”
   • Cole o token do bot fornecido pelo BotFather
   • Clique em “Salvar”

6. Configure a mensagem do Telegram:
   • Operation: Send Message
   • Chat ID: insira seu ID de chat
   • Text: por enquanto, deixe uma mensagem “hello”
   • Clique em Execute step para testar o envio de uma mensagem e receber o resumo do Firecrawl.

• Agora que você tem a estrutura do resumo do Firecrawl, adicione-o ao texto da mensagem arrastando o campo summary (dentro de data) do resultado do nó Firecrawl.

7. Teste o fluxo de trabalho:
   • Clique em “Executar Fluxo de Trabalho”
   • Verifique no Telegram se recebeu a mensagem de resumo

8. Ative o fluxo de trabalho alternando o interruptor “Active”

​

Exemplo 2: Busca de notícias sobre IA no Telegram

• Usa um Manual Trigger em vez de Schedule (execução sob demanda)
• Usa a operação Search em vez de Scrape
• Inclui um nó Code para formatar vários resultados

1. Crie um novo fluxo de trabalho e adicione um nó Manual Trigger
2. Adicione um nó Firecrawl com estas configurações:
   • Resource: Map & Search
   • Operation: Search Web
   • Query: ai news
   • Limit: 5

3. Adicione um nó Code para formatar os resultados de busca:
   • Selecione “Run Once for All Items”
   • Cole este código:

const results = $input.all();
let message = "Latest AI News:\n\n";

results.forEach((item) => {
  const webData = item.json.data?.web || [];
  webData.forEach((article, index) => {
    message += `${index + 1}. ${article.title}\n`;
    message += `${article.description}\n`;
    message += `${article.url}\n\n`;
  });
});

return [{ json: { message } }];

4. Atualize o nó Telegram (usando a credencial salva):
   • Text: Arraste o campo message do nó Code

​

Exemplo 3: Resumo de Notícias com IA

• Adicione a configuração das credenciais da OpenAI
• Adicione o nó AI Agent entre Code e Telegram
• O AI Agent analisa e resume todas as notícias de forma inteligente
• O Telegram recebe o resumo gerado por IA em vez da lista bruta de notícias

1. Obtenha sua chave de API da OpenAI:
   • Acesse platform.openai.com/api-keys
   • Faça login ou crie uma conta
   • Clique em “Create new secret key”
   • Dê um nome a ela (por exemplo, “n8n Integration”)
   • Copie a chave de API imediatamente (você não poderá vê-la novamente)

2. Adicione e conecte o nó AI Agent:
   • Clique em ”+” após o nó Code
   • Pesquise por “Basic LLM Chain” ou “AI Agent”
   • Arraste o campo message do nó Code para o campo de prompt de entrada do AI Agent
   • Selecione OpenAI como provedor de LLM

3. Adicione suas credenciais da OpenAI:
   • Clique em “Create New Credential” para a OpenAI
   • Cole sua chave de API da OpenAI
   • Selecione o modelo: gpt-5-mini (mais econômico) ou gpt-5 (mais avançado)
   • Clique em “Save”

4. Adicione o prompt de sistema ao AI Agent:
   • No nó AI Agent, adicione este prompt de sistema:

Você é um analista de notícias sobre IA. Analise os artigos de notícias sobre IA fornecidos e crie um resumo conciso
e perspicaz, destacando os avanços e as tendências mais importantes.
Agrupe os tópicos relacionados e explique por que esses avanços são relevantes.
Mantenha o resumo em tom de conversa e envolvente, com cerca de 3 a 4 parágrafos.

5. Atualize o nó Telegram e teste:
   • Atualize o nó Telegram:
     • Texto: Arraste o resultado do AI Agent (o resumo gerado)
     • Remova o mapeamento antigo da mensagem do nó Code
   • Clique em “Executar fluxo de trabalho” para testar
   • A IA analisará todos os artigos de notícias e criará um resumo
   • Verifique o Telegram para conferir o resumo gerado pela IA

​

Entendendo as operações do Firecrawl

​

Fazer scraping de URL

• Faz scraping de uma única URL
• Retorna Markdown limpo, HTML ou resumos gerados por IA
• Retorna dados estruturados com o formato JSON e um prompt ou schema
• Pode fazer capturas de tela e extrair links

• Extração de artigos
• Monitoramento de páginas de produtos
• Scraping de posts de blog
• Geração de resumos de páginas

​

Interact

• Execute Interaction: executa um prompt ou código em uma página coletada, usando o scrapeId da saída do Scrape URL (data.metadata.scrapeId)
• Stop Interaction: encerra a sessão de interação desse scrapeId
• Get Interact Context: retorna instruções de uso para agentes de IA que chamam essas operações como ferramentas

{
  "profile": {
    "name": "my-profile",
    "saveChanges": true
  }
}

​

Pesquisar na web

• Pesquisa na web, em notícias ou imagens
• Retorna títulos, descrições e URLs
• Opcionalmente, faz scraping do conteúdo completo dos resultados

• Automação de pesquisa
• Monitoramento de notícias
• Descoberta de tendências
• Encontrar conteúdo relevante

​

Rastrear site

• Segue links automaticamente
• Faz scraping de várias páginas em um único job
• Pode filtrar URLs por padrões
• Retorna o ID da tarefa de rastreamento; adicione um segundo nó Firecrawl com Get Crawl Status para ler as páginas extraídas

• Extração completa de documentação
• Arquivamento de sites
• Coleta de dados de várias páginas

​

Mapear site

• Descobre links de um site
• Retorna uma lista limpa de URLs
• Rápido e leve

• Descoberta de URLs
• Geração de sitemap
• Planejamento de rastreamentos maiores

​

Raspagem em Lote de URLs

• Processa uma lista de URLs de uma só vez, com as mesmas opções de scraping para cada uma
• É mais eficiente do que usar loops
• Retorna um ID do job de lote; adicione Get Batch Scrape Status para ler todos os resultados de uma vez

• Processamento de listas de URLs
• Coleta de dados em massa
• Projetos de raspagem em grande escala

​

Agente

• Aceita um prompt descrevendo os dados de que você precisa, além de URLs opcionais e um schema JSON
• O agente de IA navega e extrai informações de forma autônoma
• Disponível como Extract Data With AI Agent (aguarda os resultados) e Start AI Agent Job (Async) (retorna um ID do job imediatamente)
• Use Get Agent Status para consultar os resultados ao usar a operação async

• Coleta complexa de dados em várias páginas, guiada por um prompt
• Extrair informações quando você não conhece a estrutura exata da página
• Tarefas de pesquisa que exigem navegar por várias páginas

• Extract Data With AI Agent inicia o job e aguarda o resultado em uma única etapa, a opção mais simples para a maioria dos casos de uso. O parâmetro Max Wait Time define por quanto tempo o nó continua consultando antes de atingir o tempo limite (padrão: 300 segundos; máximo: 600 segundos). Se a tarefa do agente demorar mais do que isso, o nó retorna o status timeout com o jobId, mesmo que o job ainda possa ser concluído no Firecrawl. Passe esse ID para Get Agent Status ou use a operação async para jobs que possam passar de 10 minutos.
• Start AI Agent Job (Async) retorna um ID do job imediatamente. Adicione um segundo nó Firecrawl com a operação Get Agent Status para recuperar os resultados quando o job for concluído.

​

Extrair dados estruturados (legado)

​

Browser Sandbox

• Criar sessão do navegador: inicia uma nova sessão do navegador e retorna o seu id
• Executar código no navegador: executa código Node (Playwright), Python ou Bash na sessão, usando o id da etapa Criar como Session ID
• Obter várias sessões do navegador: lista sessões ativas ou encerradas
• Excluir sessão do navegador: encerra uma sessão quando você terminar
• Obter contexto do navegador: retorna instruções de uso e sessões ativas para agentes de IA que chamam essas operações como ferramentas

• Fluxos de trabalho de navegador em várias etapas que exigem manter o estado entre páginas
• Navegação dinâmica em páginas, quando o número de etapas não é conhecido antecipadamente
• Fluxos de trabalho que usam perfis persistentes do navegador para preservar cookies e localStorage entre execuções

​

Conta

​

Modelos e exemplos de fluxos de trabalho

​

Modelos em destaque

​

Como importar modelos

1. Clique em um link de modelo de fluxo de trabalho
2. Na página do modelo, clique no botão “Importar modelo para a instância auto-hospedada em localhost:5678”
3. O fluxo de trabalho será aberto na sua instância do n8n
4. Configure as credenciais de cada nó
5. Personalize as configurações para seu caso de uso
6. Ative o fluxo de trabalho

​

Boas práticas

​

Testes e depuração

• Sempre teste os fluxos de trabalho manualmente antes de ativar os agendamentos
• Use o botão “Execute Workflow” para testar todo o fluxo
• Verifique os dados de resultado em cada nó para confirmar se estão corretos
• Use a aba “Executions” para revisar execuções anteriores e depurar problemas

​

Tratamento de erros

• Adicione nós Error Trigger para capturar e tratar falhas
• Configure notificações para quando os fluxos de trabalho falharem
• Use a configuração “Continue On Fail” em nós não críticos
• Monitore regularmente a execução dos seus fluxos de trabalho

​

Otimização de desempenho

• Use extração em lote para várias URLs em vez de loops
• Defina limites de taxa adequados para evitar sobrecarregar os sites de destino
• Armazene dados em cache quando possível para reduzir solicitações desnecessárias
• Agende fluxos de trabalho intensivos para horários de menor movimento

​

Segurança

• Nunca exponha chaves de API nas configurações de fluxos de trabalho
• Use o sistema de credenciais do n8n para armazenar a autenticação com segurança
• Tenha cuidado ao compartilhar fluxos de trabalho publicamente
• Respeite os termos de serviço e o robots.txt dos sites-alvo

​

Próximas etapas

​

Explore recursos avançados

• Estude configurações de webhooks para processamento de dados em tempo real
• Experimente a extração com IA usando prompts e schemas
• Crie fluxos de trabalho complexos de várias etapas com lógica de ramificação

​

Participe da comunidade

• Discord do Firecrawl - Obtenha ajuda com o Firecrawl e converse sobre scraping web
• Fórum da Comunidade n8n - Faça perguntas sobre automação de fluxos de trabalho
• Compartilhe seus fluxos de trabalho e aprenda com outras pessoas

​

Caminho de aprendizado recomendado

1. Conclua os fluxos de trabalho de exemplo deste guia
2. Modifique modelos da biblioteca da comunidade
3. Crie um fluxo de trabalho para resolver um problema real no seu trabalho
4. Explore operações avançadas do Firecrawl
5. Contribua com seus próprios modelos para ajudar outras pessoas

​

Recursos adicionais

• Documentação da API do Firecrawl
• Documentação do n8n
• Boas práticas de web scraping