CleanTextLab

Bereinigen Sie unordentlichen Text in Sekunden. Schnelle Browser-Tools für Zeilenumbrüche, Akzente, Listen, Telefonnummern, SMS und mehr. Keine Konten und keine Uploads.

n8n Integration

CleanTextLab in n8n-Workflows ausführen

Verwenden Sie die CleanTextLab API aus n8n-Workflows, um Text im großen Maßstab zu bereinigen, zu formatieren und zu transformieren. Nutzen Sie unsere native Community Node oder die HTTP Request Node.

n8n-Vorlagen ansehen API-Referenz

Gilt für: POST /api/v1/run, POST /api/v1/sanitize, POST /api/v1/sort-dedupe

CORS gilt nur für Browser-Apps; n8n läuft serverseitig und benötigt kein CORS.

HTTP-Request-Node hinzufügen

Nutzen Sie POST mit JSON-Headern und Ihrem API-Schlüssel in den n8n-Credentials.

Sicher authentifizieren

Speichern Sie den Schlüssel in n8n Credentials oder Umgebungsvariablen.

Retries steuern

Aktivieren Sie Retries und Batching, um Limits einzuhalten.

Workflow-Vorschau

Typischer Pfad in n8n: Trigger → CleanTextLab HTTP Request → gemappte Ausgabe. Nutzen Sie das als visuelle Hilfe beim Verbinden der Nodes.

TriggerCleanTextLabAusgabe

CleanTextLab

COMMUNITY NODE

ActionProcess Text

ToolCSV to JSON

DelimiterSemicolon (;)

Input TextExpression

data:{{ $json.text }}

Success

8msOUTPUT

Integrationsmethoden

Wählen Sie die Methode, die am besten zu Ihrer n8n-Umgebung passt.

Methode 1: Community Node (Beste Erfahrung)

Unser dedizierter n8n-Node bietet eine visuelle Benutzeroberfläche für alle 35+ Tools, einschließlich Dropdown-Menüs für Algorithmen, Begrenzer und Konfigurationen.

Über npm installieren

Führen Sie diesen Befehl in Ihrem n8n-Stammverzeichnis aus:

npm install n8n-nodes-cleantextlab

n8n neu starten

Starten Sie Ihre n8n-Instanz neu, um den neuen Node zu laden.

Repository auf GitHub ansehen

CleanTextLab

COMMUNITY NODE

ActionProcess Text

ToolCSV to JSON

DelimiterSemicolon (;)

Input TextExpression

data:{{ $json.text }}

Success

8msOUTPUT

Alternative Methode

Methode 2: Manuelle HTTP-Anfrage (Fallback)

HTTP Request Node Felder

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

Body (in JSON-Body einfügen)

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

Hinweise:

Ohne Credentials ersetzen Sie {{$credentials.cleantextlabApiKey}} durch eine Umgebungsvariable.
Bei mehreren Items: Batching und Retries aktivieren.

Beispiel-Antworten

CleanTextLab liefert Metadaten, damit Sie Schritte in n8n verketten können.

Beispiel: /v1/run

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

Antwort (Beispiel)

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

Beispiel: /v1/sanitize

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

Erweiterte Konfiguration

Einige Tools akzeptieren Konfigurationsoptionen, um ihr Verhalten anzupassen. Übergebe ein config für feingranulare Kontrolle.

CSV mit Semikolon-Trennzeichen

Konvertiert CSV mit Semikolon-Trennzeichen in JSON

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

SHA-512-Hash in Base64

Erzeugt einen SHA-512-Hash im Base64-Format

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

Explizite Base64-Kodierung

Erzwingt die Kodierung (keine Auto-Erkennung)

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

Hex-zu-Text-Konvertierung

Erzwingt das Dekodieren von Hex in lesbaren Text

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

Verfügbare Konfigurationsoptionen

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"

Rate-Limits

n8n empfiehlt zwei Wege, wenn Sie Limits erreichen:

"Retry On Fail" aktivieren und mit Pause neu versuchen.
Workflow-Steuerung (Schleife + Warten) oder Batching nutzen.

CleanTextLab gibt 429 Rate limit exceeded zurück, wenn Sie Ihr Planfenster überschreiten.

Fehlerbehandlung

Nutzen Sie Error-Workflows für Benachrichtigungen und Recovery.

Error-Workflow für Slack/E-Mail konfigurieren.
Status 401: Schlüssel fehlt oder ungültig.
Status 403: Pro für diesen Endpoint erforderlich.
Status 429: reduzieren und erneut versuchen.

Paginierungsvariablen

Variablen im HTTP-Node:

$pageCount (Anzahl der Seiten)
$response (Body/Headers/Status)

CleanTextLab ist single-response, aber das ist wichtig für vorgelagerte APIs.

Empfohlenes Workflow-Muster

Daten abrufen (CRM, Sheets, DB).
In Text umwandeln (z. B. Zeilen mit \n).
/v1/run pro Batch aufrufen.
Ergebnisse auf Datensätze mappen.
Error-Workflow für Alerts und Retries hinzufügen.

Häufig Gestellte Fragen

F: Wie verwende ich CleanTextLab mit n8n?

A: Installieren Sie den HTTP Request-Knoten in n8n, konfigurieren Sie die Header-Authentifizierung (Header Auth) mit Ihrem CleanTextLab API-Schlüssel (von Einstellungen → API-Schlüssel), und senden Sie dann POST-Anfragen an https://cleantextlab.com/api/v1/run mit Ihrem Text im Feld "input" und den gewünschten Transformationen im Array "steps". Wir bieten 5 vorgefertigte Workflow-Vorlagen, damit Sie in weniger als 5 Minuten starten können.

F: Kann ich CSV-Dateien mit Semikolon-Trennzeichen in n8n verarbeiten?

A: Ja! CleanTextLab ist die einzige Text-API, die konfigurierbare Trennzeichen für n8n unterstützt. Verwenden Sie das csv-json-converter-Tool mit einem Konfigurationsobjekt: { "toolSlug": "csv-json-converter", "config": { "delimiter": ";" } }. Dies funktioniert mit Kommas, Semikola, Tabulatoren oder jedem benutzerdefinierten Trennzeichen. Siehe unsere erweiterte CSV-Verarbeitungsvorlage für ein funktionierendes Beispiel.

F: Benötige ich ein CleanTextLab Pro-Konto für n8n-Workflows?

A: Ja, die API erfordert einen Pro-Plan ($5/Monat Einführungspreis), der 5.000 API-Aufrufe pro Tag umfasst. Kostenlose Konten sind auf 10 Aufrufe/Tag zum Testen beschränkt. Pro-Benutzer erhalten auch Zugriff auf den MCP-Server, prioritären Support und alle 35+ Tools mit erweiterten Konfigurationsoptionen.

F: Was unterscheidet CleanTextLab von anderen n8n HTTP-Knoten?

A: Anders als generische HTTP-APIs unterstützt CleanTextLab die Werkzeugkonfiguration (CSV-Trennzeichen, Hash-Algorithmen, Codierungsrichtung) direkt in Ihrem Workflow. Die meisten Text-APIs zwingen Sie zu starren Standardvorgaben, unsere passt sich Ihren Daten an. Darüber hinaus ist die gesamte Verarbeitung deterministisch (keine KI-Halluzinationen) und datenschutzorientiert (kein Datenlogging).

F: Kann ich mehrere Text-Transformationen in einem n8n-Knoten verketten?

A: Absolut! Das ist die Kraft unseres Workflow-Engines. In einem einzigen HTTP Request-Knoten können Sie Leerzeichen trimmen, Duplikate entfernen, zu Großbuchstaben konvertieren und als JSON formatieren, alles in Reihenfolge. Jeder Schritt verarbeitet die Ausgabe des vorherigen Schritts. Beispiel: "steps": ["trim-lines", "dedupe-sort", "title-case-converter"]

F: Sind CleanTextLab n8n-Workflows selbst gehostet?

A: n8n-Workflows werden dort ausgeführt, wo Sie n8n hosten (Cloud, selbst gehostet, Desktop), aber die Text-Verarbeitungs-API-Aufrufe erfolgen auf CleanTextLab-Servern. Der gesamte Netzwerkverkehr verwendet HTTPS und wir protokollieren Ihren verarbeiteten Text nie. Für vollständig offline Verarbeitung nutzen Sie unsere browserbasierten Tools unter cleantextlab.com/tools.

F: Wie behebe ich Fehler "Ungültiger API-Schlüssel" in n8n?

A: Dies bedeutet normalerweise: (1) Der API-Schlüssel wurde nicht korrekt von Einstellungen → API-Schlüssel kopiert, (2) Sie verwenden einen kostenlosen API-Schlüssel (API erfordert Pro), (3) Die Anmeldedaten sind nicht in der Authentifizierungsliste des HTTP Request-Knotens ausgewählt, oder (4) Der Header-Name ist falsch (muss genau "x-api-key" in Kleinbuchstaben sein). Siehe oben unseren Fehlerbehebungsleitfaden für schrittweise Lösungen.

F: Kann ich die CleanTextLab API in Make, Zapier oder anderen Automatisierungsplattformen verwenden?

A: Ja! Die API funktioniert mit jeder Plattform, die HTTP POST-Anfragen mit Header-Authentifizierung unterstützt. Wir bieten spezifische Dokumentation und Vorlagen für n8n, aber der gleiche /api/v1/run Endpoint funktioniert in Make, Zapier, Pipedream oder benutzerdefinierten Scripts. Siehe /docs/api für sprachspezifische Beispiele (cURL, Python, JavaScript).