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
- Acesse firecrawl.dev no navegador
- Clique no botão “Começar” ou “Cadastre-se”
- Crie uma conta usando seu endereço de e-mail ou login do GitHub
- Verifique seu e-mail, se solicitado
Obtenha sua chave de API
- Acesse o painel do Firecrawl
- Vá até a página de chaves de API
- Clique em “Create New API Key”
- Dê à chave um nome descritivo, como “Integração n8n”
- Copie a chave de API gerada e salve-a em um local seguro

Sua chave de API é como uma senha. Mantenha-a segura e nunca a compartilhe publicamente. Você precisará dela na próxima seção.
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)
- Acesse n8n.cloud
- Clique em “Começar grátis” ou “Cadastre-se”
- Cadastre-se com seu endereço de e-mail ou conta do GitHub
- Conclua o processo de verificação
- 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
- Abra o terminal ou prompt de comando
- Crie um volume do Docker para persistir os dados do seu fluxo de trabalho:
- Execute o contêiner Docker do n8n:

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

A flag
--rm remove automaticamente o contêiner quando você o interrompe, mas seus dados permanecem seguros no volume n8n_data. Para implantações em produção, consulte a documentação de auto-hospedagem do n8n para conhecer opções de configuração mais avançadas.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
- No canvas do seu novo fluxo de trabalho, clique no botão ”+” no centro
- O painel de seleção de nós será aberto no lado direito
- Na caixa de busca na parte superior, digite “Firecrawl”
- O nó do Firecrawl aparecerá nos resultados da busca

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

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

- Uma janela de configuração da credencial será aberta
- Insira um nome para essa credencial (por exemplo, “Minha conta do Firecrawl”)
- Cole sua chave de API do Firecrawl no campo “Chave de API”
- Clique em “Salvar” na parte inferior
Teste a conexão
- Com o nó Firecrawl ainda selecionado, veja o painel de configuração
- No menu suspenso “Resource”, selecione “fazer scraping de uma URL e obter seu conteúdo”
- No campo “URL”, insira:
https://firecrawl.dev - Por enquanto, mantenha as outras configurações nos valores padrão
- Clique no botão “Test step” no canto inferior direito do nó

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

Guarde o token do bot em segurança. Esse token funciona como uma senha e permite que o n8n envie mensagens como seu bot. Nunca o compartilhe publicamente.
Encontre seu ID de chat
- Abra o navegador e acesse esta URL (substitua
YOUR_BOT_TOKENpelo token do seu bot): - Mantenha esta aba do navegador aberta
- No Telegram, pesquise o nome de usuário do bot que você acabou de criar
- Inicie uma conversa com o bot clicando em “Iniciar”
- Envie qualquer mensagem para o bot (por exemplo, “olá”)
- Volte à aba do navegador e atualize a página
- Procure o campo
"chat":{"id":na resposta JSON - O número ao lado de
"id":é seu ID de chat (por exemplo,123456789) - Salve esse ID de chat para usar mais tarde

Seu ID de chat é o identificador exclusivo da sua conversa com o bot. Você o usará para informar ao n8n para onde enviar mensagens.
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
- Crie um novo fluxo de trabalho no n8n
- Adicione um nó Schedule Trigger:
- Clique no botão ”+” no canvas
- Busque por “Schedule Trigger”
- Configure: todos os dias às 9h

- Adicione o nó Firecrawl:
- Clique em ”+” ao lado de Schedule Trigger
- Busque e adicione “Firecrawl”
- Selecione sua credencial do Firecrawl
- Configure:
- Resource: fazer scraping de uma URL e obter seu conteúdo
- URL:
https://www.firecrawl.dev/blog/category/product-updates - Formatos: selecione “Summary”

-
Adicione o nó Telegram:
- Clique em ”+” ao lado de Firecrawl
- Busque por “Telegram”
- Clique em “Send a text message” para adicioná-lo ao canvas
-
Configure as credenciais do Telegram:
- Clique no nó Telegram para abrir a configuração
- No menu suspenso “Credential to connect with”, clique em “Create New Credential”
- Cole o token do bot fornecido pelo BotFather
- Clique em “Save”
- 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
summarydo resultado do nó Firecrawl.
- Teste o fluxo de trabalho:
- Clique em “Execute Workflow”
- Verifique no Telegram se recebeu a mensagem de resumo

- 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
- Crie um novo fluxo de trabalho e adicione um nó Manual Trigger
-
Adicione um nó Firecrawl com estas configurações:
- Resource: pesquisar e, opcionalmente, fazer scraping dos resultados de busca
- Query:
ai news - Limit: 5

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

- Atualize o nó Telegram (usando a credencial salva):
- Text: Arraste o campo
messagedo nó Code
- Text: Arraste o campo
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
- 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)

- 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
messagedo nó Code para o campo de prompt de entrada do AI Agent - Selecione OpenAI como provedor de LLM
- 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”

- Adicione o prompt de sistema ao AI Agent:
- No nó AI Agent, adicione este prompt de sistema:

- 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
- Atualize o nó Telegram:
O AI Agent recebe todos os artigos de notícias formatados e cria um resumo inteligente, facilitando a compreensão rápida de tendências e desenvolvimentos importantes.
Entendendo as operações do Firecrawl
Fazer scraping de uma URL e obter seu conteúdo
- Faz scraping de uma única URL
- Retorna Markdown limpo, HTML ou resumos gerados por IA
- 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
Scrape + Interact com perfis persistentes
profile persistente na etapa Scrape. A etapa Interact precisa apenas do scrapeId da resposta de scraping, além de um prompt ou código. Não adicione profile ao corpo da solicitação do Interact; o Interact herda o perfil do job de scraping.
Para salvar cookies, localStorage e outros estados do navegador, encerre a sessão de interação quando o fluxo de trabalho terminar. Se você precisar apenas ler um perfil existente em uma execução posterior do fluxo de trabalho, defina saveChanges como false na etapa Scrape.
Se a versão instalada do nó Firecrawl n8n não expõe configurações de perfil na operação Scrape, atualize para a versão mais recente do nó Firecrawl n8n. Se sua versão do n8n oferecer suporte a opções personalizadas de solicitação ou corpo para o nó, você poderá passar o mesmo objeto profile nelas:
Pesquisar e, opcionalmente, fazer scraping dos resultados de busca
- 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 um site
- Segue links automaticamente
- Faz scraping de várias páginas em uma única operação
- Pode filtrar URLs por padrões
- Extração completa de documentação
- Arquivamento de sites
- Coleta de dados de várias páginas
Mapeie um site e obtenha URLs
- Descobre todos os 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
Extrair Dados
- Extração de dados com IA
- Retorna dados no formato especificado
- Funciona em várias páginas
- Extração de dados personalizada
- Criação de bancos de dados
- Coleta de informações estruturadas
Extração em lote
- Processa várias URLs de uma só vez
- É mais eficiente do que usar loops
- Retorna todos os resultados de uma vez
- Processar listas de URLs
- Coleta de dados em massa
- Projetos de scraping em grande escala
Agente
- Aceita um prompt que descreve os dados necessários
- O agente de IA navega e extrai informações de forma autônoma
- Disponível nos modos Sync (aguarda os resultados) e Async (retorna um ID do job imediatamente)
- Use Get Agent Status para consultar os resultados ao usar o modo Async
- Coleta complexa de dados em várias páginas, orientada por um prompt
- Extração de informações quando você não conhece a estrutura exata da página
- Tarefas de pesquisa que exigem navegar por várias páginas
- Agent (Sync) 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 controla por quanto tempo o nó consulta o status antes de atingir o tempo limite (padrão: 300 segundos; máximo: 600 segundos). Se o job do agente demorar mais do que isso, o nó retornará um status de tempo limite, embora o job ainda possa ser concluído no Firecrawl. Para jobs que podem ultrapassar 10 minutos, use o modo Async.
- Agent (Async) retorna um ID do job imediatamente. Adicione um segundo nó do Firecrawl com a operação Get Agent Status para recuperar os resultados quando o job for concluído.
Browser Sandbox
- Criar sessão do navegador — inicia uma nova sessão do navegador e retorna um
sessionId - Executar código no navegador — executa código JavaScript, Python ou bash na sessão (usando o
sessionIdda etapa Criar) - Listar sessões do navegador — lista sessões ativas ou encerradas
- Excluir sessão do navegador — encerra uma sessão quando você terminar
- 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
sessionId da etapa Criar para cada etapa subsequente de Executar ou Excluir. Use o nó Loop Over Items do n8n para iterar por uma lista dinâmica de páginas, chamando Executar para cada uma na mesma sessão.
Para mais detalhes sobre o Browser Sandbox, consulte a documentação do Browser Sandbox.
Modelos e exemplos de fluxos de trabalho
Modelos em destaque
Tutorial completo do n8n
Crie um chatbot de IA com acesso à web usando Firecrawl e n8n
8 fluxos de trabalho para produção
Modelos prontos para uso para geração de leads, monitoramento de preços e muito mais
Pipeline de RAG com Supabase pgvector
Faça scraping de páginas, gere embeddings e armazene-os no Supabase pgvector para RAG
Enriquecimento de leads com IA
Faça scraping de sites de empresas e extraia dados comerciais estruturados
Pipeline de RAG com Pinecone
Faça scraping de páginas, gere embeddings e armazene-os no Pinecone para RAG
Fluxos de trabalho da comunidade n8n
Explore centenas de fluxos de trabalho que usam Firecrawl
Integração oficial do n8n
Consulte a documentação da integração oficial
Como importar modelos
- Clique em um link de modelo de fluxo de trabalho
- Na página do modelo, clique no botão “Importar modelo para a instância auto-hospedada em localhost:5678”
- O fluxo de trabalho será aberto na sua instância do n8n
- Configure as credenciais de cada nó
- Personalize as configurações para seu caso de uso
- 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
- Conclua os fluxos de trabalho de exemplo deste guia
- Modifique modelos da biblioteca da comunidade
- Crie um fluxo de trabalho para resolver um problema real no seu trabalho
- Explore operações avançadas do Firecrawl
- Contribua com seus próprios modelos para ajudar outras pessoas
Precisa de ajuda? Se você estiver com dificuldades ou tiver dúvidas, as comunidades do Firecrawl e do n8n são ativas e prestativas. Não hesite em pedir orientação enquanto cria suas automações.

