CleanTextLab

Limpia texto desordenado en segundos. Herramientas rápidas en el navegador para saltos de línea, acentos, listas, números de teléfono, SMS und más. Sin cuentas y sin cargas.

Integración n8n

Ejecuta CleanTextLab dentro de flujos n8n

Use la API de CleanTextLab desde flujos de trabajo de n8n para limpiar, formatear y transformar texto a escala. Use nuestro nodo de comunidad nativo o el nodo HTTP Request.

Ver plantillas n8n Referencia API

Aplica a: POST /api/v1/run, POST /api/v1/sanitize, POST /api/v1/sort-dedupe

CORS solo aplica a apps en el navegador. n8n corre del lado servidor y no requiere CORS.

Agrega el nodo HTTP Request

Usa POST con encabezados JSON y tu clave API en las credenciales de n8n.

Autentica de forma segura

Guarda tu clave en Credenciales de n8n o variables de entorno. Evita hardcodear secretos.

Controla reintentos

Activa los reintentos y el batching para mantenerte dentro de los límites.

Vista previa del flujo

Ruta típica en n8n: disparador → HTTP Request de CleanTextLab → salida mapeada. Úsalo como guía visual al conectar tus nodos.

DisparadorCleanTextLabSalida

CleanTextLab

COMMUNITY NODE

ActionProcess Text

ToolCSV to JSON

DelimiterSemicolon (;)

Input TextExpression

data:{{ $json.text }}

Success

8msOUTPUT

Métodos de Integración

Elija el método que mejor se adapte a su entorno n8n.

Recomendado

Método 1: Nodo de Comunidad (Mejor Experiencia)

Nuestro nodo dedicado de n8n proporciona una interfaz visual para todas las herramientas 35+, incluyendo menús desplegables para algoritmos, delimitadores y configuraciones.

Instalar vía npm

Ejecuta este comando en tu directorio raíz de n8n:

npm install n8n-nodes-cleantextlab

Reiniciar n8n

Reinicia tu instancia de n8n para cargar el nuevo nodo.

Ver Repositorio en GitHub

CleanTextLab

COMMUNITY NODE

ActionProcess Text

ToolCSV to JSON

DelimiterSemicolon (;)

Input TextExpression

data:{{ $json.text }}

Success

8msOUTPUT

Método Alternativo

Método 2: Solicitud HTTP Manual (Alternativa)

Campos del nodo HTTP Request

Method: POST
URL: https://cleantextlab.com/api/v1/run
Authentication: Predefined Credential Type
Credential Type: Header Auth
Send Headers: ON
Headers:
  Content-Type: application/json
Response Format: JSON

Cuerpo (pegar en JSON body)

{
  "input": "{{$json.text}}",
  "steps": ["trim-lines", "collapse-spaces", "lower-case"]
}

Notas:

Si no usas credenciales, reemplaza {{$credentials.cleantextlabApiKey}} con una expresión de entorno.
Si recibes múltiples items, usa batching y reintentos.

Ejemplos de respuesta

CleanTextLab responde con metadatos para encadenar pasos en n8n.

Ejemplo: /v1/run

{
  "input": "  Hello   World  ",
  "steps": ["trim-lines", "collapse-spaces", "upper-case"]
}

Respuesta (ejemplo)

{
  "result": "HELLO WORLD",
  "meta": {
    "stepsExecuted": 3,
    "processingTimeMs": 12
  }
}

Ejemplo: /v1/sanitize

{
  "urls": [
    "https://example.com?utm_source=twitter&utm_campaign=sale",
    "https://shop.example.com?gclid=abc123"
  ]
}

Configuración avanzada

Algunas herramientas aceptan opciones de configuración para personalizar su comportamiento. Pasa un objeto config para un control detallado.

CSV con delimitador de punto y coma

Convierte CSV delimitado por punto y coma a JSON

={{ {
  "input": $json.csvData,
  "steps": [
    {
      "toolSlug": "csv-json-converter",
      "config": {
        "delimiter": ";",
        "hasHeaders": true
      }
    }
  ]
} }}

Hash SHA-512 en Base64

Genera hash SHA-512 en formato base64

={{ {
  "input": $json.password,
  "steps": [
    {
      "toolSlug": "hash-generator",
      "config": {
        "algorithm": "SHA-512",
        "format": "base64"
      }
    }
  ]
} }}

Codificación Base64 explícita

Fuerza la dirección de codificación (sin autodetección)

={{ {
  "input": $json.apiKey,
  "steps": [
    {
      "toolSlug": "base64-encode-decode",
      "config": {
        "direction": "encode"
      }
    }
  ]
} }}

Conversión de hex a texto

Fuerza la decodificación de hex a texto legible

={{ {
  "input": $json.hexData,
  "steps": [
    {
      "toolSlug": "hex-converter",
      "config": {
        "direction": "decode"
      }
    }
  ]
} }}

Opciones de configuración disponibles

csv-json-converter

delimiter: "," | ";" | " "
hasHeaders: true | false

hash-generator

algorithm: "SHA-256" | "SHA-512" | "SHA-1"
format: "hex" | "base64"

base64-encode-decode

direction: "auto" | "encode" | "decode"

hex-converter

direction: "auto" | "encode" | "decode"

Límites de velocidad

n8n recomienda dos enfoques principales cuando alcanzas límites:

Habilita "Retry On Fail" para reintentar con pausa.
Usa control del flujo de trabajo (bucle + espera) o batching para reducir la tasa.

CleanTextLab devuelve 429 Rate limit exceeded cuando superas la ventana del plan.

Manejo de errores

Usa error workflows de n8n para alertas y recuperación.

Configura un flujo de error para notificaciones (Slack/email).
Si el estado es 401: clave inválida o ausente.
Si el estado es 403: necesitas Pro para ese endpoint.
Si el estado es 429: reduce la velocidad y reintenta.

Variables de paginación

Variables del nodo HTTP:

$pageCount (páginas obtenidas)
$response (cuerpo/headers/status)

CleanTextLab es de respuesta única, pero esto importa al traer datos externos.

Patrón recomendado

Obtén registros (CRM, Sheets, DB).
Convierte a texto (por ejemplo, líneas con \n).
Llama a /v1/run por lote.
Mapea resultados a los registros.
Agrega un flujo de error para alertas y reintentos.

Preguntas Frecuentes

P: ¿Cómo uso CleanTextLab con n8n?

R: Instale el nodo HTTP Request en n8n, configure la autenticación de encabezado (Header Auth) con su clave de API de CleanTextLab (desde Ajustes → Claves de API), y luego envíe solicitudes POST a https://cleantextlab.com/api/v1/run con su texto en el campo "input" y las transformaciones deseadas en el array "steps". Ofrecemos 5 plantillas de flujo de trabajo listas para usar para que pueda empezar en menos de 5 minutos.

P: ¿Puedo procesar archivos CSV con delimitadores de punto y coma en n8n?

R: ¡Sí! CleanTextLab es la única API de texto que admite delimitadores configurables para n8n. Use la herramienta csv-json-converter con un objeto de configuración: { "toolSlug": "csv-json-converter", "config": { "delimiter": ";" } }. Esto funciona con comas, puntos y coma, tabulaciones o cualquier delimitador personalizado. Vea nuestra plantilla de procesamiento avanzado de CSV para un ejemplo funcional.

P: ¿Necesito una cuenta Pro de CleanTextLab para usar flujos de trabajo de n8n?

R: Sí, la API requiere un plan Pro ($5/mes precio de lanzamiento) que incluye 5.000 llamadas API por día. Las cuentas gratuitas se limitan a 10 llamadas/día para pruebas. Los usuarios Pro también obtienen acceso al servidor MCP, soporte prioritario y todas las herramientas 35+ con opciones de configuración avanzada.

P: ¿Qué distingue a CleanTextLab de otros nodos HTTP de n8n?

R: A diferencia de las API HTTP genéricas, CleanTextLab admite configuración de herramientas (delimitadores CSV, algoritmos hash, dirección de codificación) directamente en su flujo de trabajo. La mayoría de las API de texto le obligan a usar valores predeterminados rígidos, la nuestra se adapta a sus datos. Además, todo el procesamiento es determinista (sin alucinaciones de IA) y enfocado en privacidad (sin registro de datos).

P: ¿Puedo encadenar múltiples transformaciones de texto en un nodo de n8n?

R: ¡Por supuesto! Ese es el poder de nuestro motor de flujo de trabajo. En un único nodo HTTP Request, puede recortar espacios en blanco, eliminar duplicados, convertir a título mayúscula y formatear como JSON, todo en secuencia. Cada paso procesa la salida del paso anterior. Ejemplo: "steps": ["trim-lines", "dedupe-sort", "title-case-converter"]

P: ¿Se alojan automáticamente los flujos de trabajo de n8n de CleanTextLab?

R: Los flujos de trabajo de n8n se ejecutan donde aloje n8n (nube, autohospedado, escritorio), pero las llamadas API de procesamiento de texto se realizan en los servidores de CleanTextLab. Todo el tráfico de red utiliza HTTPS y nunca registramos el texto procesado. Para procesamiento completamente sin conexión, use nuestras herramientas basadas en navegador en cleantextlab.com/tools.

P: ¿Cómo resuelvo los errores "Clave de API inválida" en n8n?

R: Esto generalmente significa: (1) La clave de API no se copió correctamente desde Ajustes → Claves de API, (2) Está usando una clave de nivel gratuito (la API requiere Pro), (3) La credencial no está seleccionada en la lista desplegable Autenticación del nodo HTTP Request, o (4) El nombre del encabezado es incorrecto (debe ser exactamente "x-api-key" en minúsculas). Consulte nuestra guía de solución de problemas anterior para obtener soluciones paso a paso.

P: ¿Puedo usar la API de CleanTextLab en Make, Zapier u otras plataformas de automatización?

R: ¡Sí! La API funciona con cualquier plataforma que admita solicitudes HTTP POST con autenticación de encabezado. Proporcionamos documentación y plantillas específicas para n8n, pero el mismo endpoint /api/v1/run funciona en Make, Zapier, Pipedream o scripts personalizados. Ver /docs/api para ejemplos específicos del lenguaje (cURL, Python, JavaScript).