Nó de Código Python (Beta)

Orientação especializada para escrever código Python em nós de Código do n8n.

Guia Detalhado

Leia o guia detalhado antes de executar esta funcionalidade. Ele contém o procedimento completo e o material de referência. Trate seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para trabalho focado, carregue as seções relevantes; para trabalho de ponta a ponta, leia o guia completamente.

Limitação Crítica: Sem Bibliotecas Externas

LIMITAÇÃO MAIS IMPORTANTE DO PYTHON: Não é possível importar pacotes externos

O Que NÃO Está Disponível

# ❌ NOT AVAILABLE - Will raise ModuleNotFoundError
import requests  # ❌ No
import pandas  # ❌ No
import numpy  # ❌ No
import scipy  # ❌ No
from bs4 import BeautifulSoup  # ❌ No
import lxml  # ❌ No

O Que ESTÁ Disponível (Biblioteca Padrão)

# ✅ AVAILABLE - Standard library only
import json  # ✅ JSON parsing
import datetime  # ✅ Date/time operations
import re  # ✅ Regular expressions
import base64  # ✅ Base64 encoding/decoding
import hashlib  # ✅ Hashing functions
import urllib.parse  # ✅ URL parsing
import math  # ✅ Math functions
import random  # ✅ Random numbers
import statistics  # ✅ Statistical functions

Soluções Alternativas

Precisa de requisições HTTP?

• ✅ Use o nó HTTP Request antes do nó Code
• ✅ Ou mude para JavaScript e use $helpers.httpRequest()

Precisa de análise de dados (pandas/numpy)?

• ✅ Use o módulo statistics do Python para estatísticas básicas
• ✅ Ou mude para JavaScript para a maioria das operações
• ✅ Cálculos manuais com listas e dicionários

Precisa de web scraping (BeautifulSoup)?

• ✅ Use o nó HTTP Request + nó HTML Extract
• ✅ Ou mude para JavaScript com métodos de regex/string

Veja: STANDARD_LIBRARY.md para referência completa

Quando Usar Python vs JavaScript

Use Python Quando:

• ✅ Você precisa do módulo statistics para operações estatísticas
• ✅ Você se sente significativamente mais confortável com a sintaxe Python
• ✅ Sua lógica se mapeia bem para compreensões de lista
• ✅ Você precisa de funções específicas da biblioteca padrão

Use JavaScript Quando:

• ✅ Você precisa de requisições HTTP ($helpers.httpRequest())
• ✅ Você precisa de datas/horas avançadas (DateTime/Luxon)
• ✅ Você quer melhor integração com o n8n
• ✅ Para 95% dos casos de uso (recomendado)

Considere Outros Nós Quando:

• ❌ Mapeamento simples de campos → Use o nó Set
• ❌ Filtragem básica → Use o nó Filter
• ❌ Condicionais simples → Use o nó IF ou Switch
• ❌ Apenas requisições HTTP → Use o nó HTTP Request

Limitações

• Use esta funcionalidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.