Cómo integrar Python con n8n para evitar duplicación de lógica

Cómo combinar Python + n8n sin duplicar trabajo

Tiempo estimado de lectura: 4 min

Introducción

Cómo combinar Python + n8n sin duplicar trabajo empieza por una decisión simple: n8n orquesta, Python procesa. Si lo inviertes, acabarás con canvas ilegible o con scripts monolíticos imposibles de testear. Aquí tienes la guía práctica para separar responsabilidades, comunicar ambos mundos sin fricción y evitar los errores que consumen tiempo.

Resumen rápido (lectores con prisa)

Qué es: Integración entre n8n (orquestación) y Python (procesamiento).

Cuándo usarlo: Usa n8n para flujos, triggers y estado; usa Python para transformaciones pesadas, dependencias y testing.

Por qué importa: Evita lógica duplicada, facilita testing y escalado independiente.

Cómo funciona: Dos patrones: nodo Code para tareas pequeñas; microservicio HTTP (por ejemplo con FastAPI) para lógica compleja y reutilizable.

Cómo combinar Python + n8n sin duplicar trabajo: regla y ejemplos

La regla es directa: n8n gestiona estado, conexiones y flujo; Python hace la transformación y la lógica compleja.

Si tu función necesita dependencias pip, CPU/ram o test unitario: ponla en Python.

Patrones de comunicación (2 opciones)

Hay dos patrones sólidos para integrar Python en n8n. Escoge según necesidad.

1) Nodo Code (rápido, limitado)

Útil para arreglos pequeños: regex, formateos, cálculos puntuales. Evita para lógica que requiera paquetes externos.

Ejemplo dentro de n8n (pseudo):

# Python en nodo Code
text = $input.first().json["message"]
urls = re.findall(r'https?://\S+', text)
return [{"urls": urls}]

Limitación: no puedes garantizar dependencias ni buen versionado. Úsalo para tareas menores.

2) Microservicio HTTP (recomendado)

Exponer Python como una API REST (FastAPI) es la arquitectura profesional. n8n usa su nodo HTTP Request para llamar a endpoints.

Ventajas:

Ejemplo mínimo de FastAPI con contrato (Pydantic):

# api.py
from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class LeadInput(BaseModel):
    text: str
    company_size: int

@app.post("/score")
def score(data: LeadInput):
    # Lógica compleja aquí (Pandas, embeddings...)
    score = len(data.text) * (data.company_size / 100)
    return {"score": score, "status": "qualified" if score > 50 else "nurture"}

Docs: FastAPI, Pydantic

En n8n configuras un nodo HTTP Request:

Contratos de datos: la pieza que evita duplicación

Define un contrato claro. Es la única manera de que n8n y Python no reinventen la misma validación.

Si n8n envía datos mal formados, la API debe responder 422 con un payload explicativo. Eso convierte los fallos en alertas, no en comportamiento errático.

Patrones para procesos largos o con archivos grandes

Errores frecuentes y soluciones concretas

Observabilidad y despliegue

FROM python:3.11-slim
WORKDIR /app
COPY . .
RUN pip install -r requirements.txt
CMD ["uvicorn", "api:app", "--host", "0.0.0.0", "--port", "8000"]

Cierre: criterio para elegir ahora mismo

Separar responsabilidades no es esfuerzo extra; es la inversión que evita la deuda técnica. Diseña contratos claros, expón lógica compleja como servicios y deja a n8n dirigir la orquesta. Tus automatizaciones dejarán de ser hacks y pasarán a ser una plataforma sólida.

Para más recursos y experimentos relacionados con automatización y workflows, consulta Dominicode Labs. Es una continuación lógica para explorar plantillas, ejemplos y herramientas prácticas que complementan esta guía.

FAQ