CleanTextLab
Limpe texto bagunçado instantaneamente. Ferramentas de navegador rápidas para quebras de linha, acentos, listas, JSON e muito mais. Sem contas.
Execute o CleanTextLab dentro de fluxos n8n
Use a API do CleanTextLab em fluxos de trabalho n8n para limpar, formatar e transformar texto em escala. Use nosso nó de comunidade nativo ou o nó HTTP Request.
Aplica-se a: POST /api/v1/run, POST /api/v1/sanitize, POST /api/v1/sort-dedupe
CORS só se aplica a apps no navegador; o n8n roda no servidor e não precisa de CORS.
Adicione o nó HTTP Request
Use POST com cabeçalhos JSON e sua chave nas credenciais do n8n.
Autentique com segurança
Armazene a chave em Credenciais do n8n ou variáveis de ambiente.
Controle de retries
Ative retries e batching para manter os limites.
Preview do fluxo
Caminho típico no n8n: gatilho → HTTP Request do CleanTextLab → saída mapeada. Use como guia visual ao conectar os nós.
Métodos de Integração
Escolha o método que melhor se adapta ao seu ambiente n8n.
Método 1: Nó de Comunidade (Melhor Experiência)
Nosso nó dedicado do n8n fornece uma interface visual para todas as 35+ ferramentas, incluindo menus suspensos para algoritmos, delimitadores e configurações.
Instalar via npm
Execute este comando no diretório raiz do seu n8n:
npm install n8n-nodes-cleantextlabReiniciar n8n
Reinicie sua instância do n8n para carregar o novo nó.
Método Alternativo
Método 2: Solicitação HTTP Manual (Fallback)
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{
"input": "{{$json.text}}",
"steps": ["trim-lines", "collapse-spaces", "lower-case"]
}- Sem credenciais, substitua
{{$credentials.cleantextlabApiKey}}por uma expressão de ambiente. - Se houver vários itens, use batching e retries.
Exemplos de resposta
O CleanTextLab retorna metadados para encadear passos no n8n.
{
"input": " Hello World ",
"steps": ["trim-lines", "collapse-spaces", "upper-case"]
}{
"result": "HELLO WORLD",
"meta": {
"stepsExecuted": 3,
"processingTimeMs": 12
}
}{
"urls": [
"https://example.com?utm_source=twitter&utm_campaign=sale",
"https://shop.example.com?gclid=abc123"
]
}Configuração avançada
Algumas ferramentas aceitam opções de configuração para personalizar o comportamento. Passe um objeto config para controle granular.
CSV com delimitador de ponto e vírgula
Converte CSV delimitado por ponto e vírgula para JSON
={{ {
"input": $json.csvData,
"steps": [
{
"toolSlug": "csv-json-converter",
"config": {
"delimiter": ";",
"hasHeaders": true
}
}
]
} }}Hash SHA-512 em Base64
Gera hash SHA-512 no formato base64
={{ {
"input": $json.password,
"steps": [
{
"toolSlug": "hash-generator",
"config": {
"algorithm": "SHA-512",
"format": "base64"
}
}
]
} }}Codificação Base64 explícita
Força a direção de codificação (sem autodetecção)
={{ {
"input": $json.apiKey,
"steps": [
{
"toolSlug": "base64-encode-decode",
"config": {
"direction": "encode"
}
}
]
} }}Conversão de hex para texto
Força a decodificação de hex para texto legível
={{ {
"input": $json.hexData,
"steps": [
{
"toolSlug": "hex-converter",
"config": {
"direction": "decode"
}
}
]
} }}Opções de configuração disponíveis
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"
Limites de taxa
O n8n recomenda duas abordagens quando você atinge limites:
- Ative "Retry On Fail" para tentar novamente com pausa.
- Use controle no fluxo (loop + espera) ou batching.
O CleanTextLab retorna 429 Rate limit exceeded quando você excede a janela do plano.
Tratamento de erros
Use error workflows para alertas e recuperação.
- Configure um workflow de erro para Slack/email.
- Status
401: chave ausente ou inválida. - Status
403: Pro necessário para o endpoint. - Status
429: reduza a taxa e tente novamente.
Variáveis de paginação
Variáveis do nó HTTP:
$pageCount(quantidade de páginas)$response(corpo/headers/status)
Os endpoints do CleanTextLab são resposta única, mas isso importa ao buscar dados externos.
Padrão recomendado
- Busque registros (CRM, Sheets, DB).
- Converta para texto (por exemplo, linhas com
\n). - Chame
/v1/runpor lote. - Mapeie resultados para os registros.
- Adicione um workflow de erro para alertas e retries.
Perguntas Frequentes
P: Como usar o CleanTextLab com n8n?
R: Instale o nó HTTP Request no n8n, configure a autenticação de cabeçalho (Header Auth) com sua chave API do CleanTextLab (em Configurações → Chaves de API), depois envie solicitações POST para https://cleantextlab.com/api/v1/run com seu texto no campo "input" e as transformações desejadas no array "steps". Fornecemos 5 modelos de fluxo de trabalho prontos para usar para ajudá-lo a começar em menos de 5 minutos.
P: Posso processar arquivos CSV com delimitadores de ponto e vírgula no n8n?
R: Sim! CleanTextLab é a única API de texto que suporta delimitadores configuráveis para n8n. Use a ferramenta csv-json-converter com um objeto de configuração: { "toolSlug": "csv-json-converter", "config": { "delimiter": ";" } }. Funciona com vírgulas, ponto-e-vírgulas, tabulações ou qualquer delimitador customizado. Consulte nosso modelo de processamento avançado de CSV para um exemplo funcional.
P: Preciso de uma conta Pro do CleanTextLab para usar fluxos de trabalho n8n?
R: Sim, a API requer um plano Pro ($5/mês preço de lançamento) que inclui 5.000 chamadas de API por dia. Contas gratuitas são limitadas a 10 chamadas/dia para testes. Usuários Pro também recebem acesso ao servidor MCP, suporte prioritário e todas as 35+ ferramentas com opções de configuração avançada.
P: O que diferencia CleanTextLab de outros nós HTTP de n8n?
R: Diferentemente de APIs HTTP genéricas, o CleanTextLab suporta configuração de ferramentas (delimitadores CSV, algoritmos hash, direção de codificação) diretamente no seu fluxo de trabalho. A maioria das APIs de texto força você a usar padrões rígidos, a nossa se adapta aos seus dados. Além disso, todo o processamento é determinístico (sem alucinações de IA) e focado em privacidade (sem registro de dados).
P: Posso encadear múltiplas transformações de texto em um nó n8n?
R: Absolutamente! Esse é o poder do nosso mecanismo de fluxo de trabalho. Em um único nó HTTP Request, você pode aparar espaços em branco, remover duplicatas, converter para maiúsculas de título e formatar como JSON, tudo em sequência. Cada etapa processa a saída da etapa anterior. Exemplo: "steps": ["trim-lines", "dedupe-sort", "title-case-converter"]
P: Os fluxos de trabalho n8n do CleanTextLab são auto-hospedados?
R: Os fluxos de trabalho n8n são executados onde você hospeda n8n (nuvem, auto-hospedado, desktop), mas as chamadas de API de processamento de texto são feitas nos servidores do CleanTextLab. Todo o tráfego de rede usa HTTPS e nunca registramos o texto processado. Para processamento completamente offline, use nossas ferramentas baseadas em navegador em cleantextlab.com/tools.
P: Como resolver erros "Chave de API inválida" no n8n?
R: Geralmente significa: (1) A chave de API não foi copiada corretamente de Configurações → Chaves de API, (2) Você está usando uma chave de nível gratuito (a API requer Pro), (3) A credencial não está selecionada no menu suspenso Autenticação do nó HTTP Request, ou (4) O nome do cabeçalho está incorreto (deve ser exatamente "x-api-key" em minúsculas). Consulte nosso guia de solução de problemas acima para soluções passo a passo.
P: Posso usar a API do CleanTextLab no Make, Zapier ou outras plataformas de automação?
R: Sim! A API funciona com qualquer plataforma que suporte solicitações HTTP POST com autenticação de cabeçalho. Fornecemos documentação e modelos específicos para n8n, mas o mesmo endpoint /api/v1/run funciona em Make, Zapier, Pipedream ou scripts personalizados. Veja /docs/api para exemplos específicos de linguagem (cURL, Python, JavaScript).