firestore

Your complete Cloud Firestore toolkit for n8n. Go beyond simple CRUD with powerful search operations, wildcard queries, and real-time triggers featuring built-in data validation. Handles native data types like Timestamps and GeoPoints seamlessly.

Package Information

Downloads: 2 weekly / 74 monthly
Latest Version: 1.6.1
Author: SauloEdu

Available Nodes

Cloud Firestore Connection icon
Cloud Firestore Connection
Interact with Google Cloud Firestore (and Storage)
Cloud Firestore icon
Cloud Firestore
Starts a workflow based on Firestore events

Documentation

🔥 n8n Firebase (Firestore & Storage) Node

NPM Version
NPM Downloads
License: MIT

🚀 Seu toolkit completo Firebase para n8n

  • CRUD avançado e queries dinâmicas no Cloud Firestore
  • Upload de arquivos binários direto para o Firebase Storage
  • Triggers em tempo real com filtros inteligentes
  • Tratamento nativo de tipos de dados e serialização JSON

Tudo em um único pacote usando apenas uma credencial de Service Account.

✨ Core Features

🔹 1. Action Node (Firestore & Storage)

Gerencie tanto banco de dados quanto arquivos em um único node.

📂 Firestore (Database):

  • Create: Criação de documentos (ID automático ou customizado).
  • Read: Leitura de documentos com suporte a Timestamps, GeoPoints e References.
  • Update: Atualização parcial de campos.
  • Delete: Exclusão permanente.
  • Advanced Search: Queries complexas com UI dinâmica (Strings, Números, Booleans, Datas, Referências etc.).

🗂️ Firebase Storage (Files):

  • Upload File: Upload binário direto do n8n.
    • Geração automática de Download Token (UUID).
    • Retorna a URL pública oficial firebasestorage.googleapis.com.

🔹 2. Real-Time Trigger Node (Firestore)

  • On Document Created: dispara ao criar um documento.
  • On Document Modified: dispara ao alterar um documento específico.
  • On Collection Modified: dispara quando qualquer documento da coleção é alterado.

🔹 3. Advanced Features (Diferenciais)

  • ⚡ Wildcard Collection Group Search: busque em todos os sub-collections (parentCollection/{}/subCollectionName).
  • 🛡️ Trigger Filtering: evite ruídos! Adicione filtros nos triggers para rodar o fluxo só se o documento atender às condições.
  • 🔄 Error Handling Inteligente: detecta erros de índice (FAILED_PRECONDITION) e mostra a URL de criação automática no próprio n8n.
  • 📐 Native Data Type Handling: converte tipos Firestore para JSON legível (Timestamp → ISO, GeoPoint → {lat, lon}, DocumentReference → string path).
  • 🔗 Nested Path Support: suporte a dot notation (user.address.city) em filtros e triggers.

⚙️ Instalação

Requisito: além do @google-cloud/firestore, este node requer @google-cloud/storage. A instalação via npm cuida disso automaticamente.

✅ 1. Instalação via n8n Community (Recomendada)

  1. Acesse sua instância do n8n.
  2. Vá em Settings > Community Nodes.
  3. Clique em Install a community node.
  4. Informe o nome do pacote:

Discussion