¿Cómo instalar Claix en tu n8n? Fácil en 3 minutos

¿Por qué instalar el nodo nativo de Claix en n8n?

Antes tenías que montar un nodo HTTP Request genérico: multipart/form-data, cabecera x-api-key, schema_id y el binario a mano. El nodo comunitario n8n-nodes-claix lo hace nativo: aparece en el panel de nodos con icono propio, credenciales seguras y tres operaciones listas (PDF, documento Word y Excel/CSV → JSON). Está alineado con la documentación pública de Claix y el OpenAPI en https://www.claix.dev/openapi.yaml.

Requisitos previos

• Instancia n8n con Community nodes habilitados (Cloud, self-hosted o Docker).
• Cuenta en Claix con al menos un schema creado (PDF, documento o Excel → JSON).
• API key desde el dashboard de Claix (https://www.claix.dev).
• Paquete publicado en npm: n8n-nodes-claix — https://www.npmjs.com/package/n8n-nodes-claix

Paso 1: Instalar el nodo comunitario (1 minuto)

En tu instancia n8n abre Settings → Community nodes → Install. Escribe exactamente el nombre del paquete:

• Nombre del paquete: n8n-nodes-claix
• Pulsa Install y acepta la instalación del community node.
• Espera a que n8n descargue el paquete desde npm y reinicie los nodos si te lo pide.

Documentación oficial de n8n sobre community nodes: https://docs.n8n.io/integrations/community-nodes/installation/. Ficha del paquete en npm: https://www.npmjs.com/package/n8n-nodes-claix

Paso 2: Crear la credencial Claix API (1 minuto)

Ve a Credentials → Add credential → busca Claix API. Pega tu API key del dashboard de Claix. El nodo envía la clave como cabecera x-api-key, tal como indica la documentación en https://www.claix.dev/documentation.

• Display name: el que quieras (ej. Claix producción).
• API Key: tu clave secreta del panel de Claix.
• Guarda la credencial; n8n la cifra y la reutiliza en todos los workflows.

Paso 3: Primer workflow en 60 segundos

3.1 Trigger con archivo binario

Usa IMAP Email (adjunto), Webhook, Google Drive o S3. n8n debe recibir el archivo como Binary Data; por defecto la propiedad se llama data.

3.2 Nodo Claix

• Añade el nodo Claix desde el buscador (categoría transform).
• Selecciona la credencial Claix API creada antes.
• Operation: Extraer PDF a JSON, Extraer Documento a JSON o Extraer Excel a JSON.
• Schema ID: UUID del schema que creaste en el dashboard de Claix.
• Input Binary Field: data (o el nombre de tu propiedad binaria).

3.3 Destino

Conecta PostgreSQL, Supabase, Airtable o Slack. El JSON de salida ya respeta tu schema (strings, numbers, arrays). Arrastra las claves en el siguiente nodo sin Code node ni Regex.

Operaciones y endpoints (referencia rápida)

Todos los endpoints envían multipart/form-data con file y schema_id. Detalle completo en https://www.claix.dev/documentation y especificación OpenAPI en https://www.claix.dev/openapi.yaml.

Instalación local (desarrolladores)

Si contribuyes o pruebas antes de publicar en npm:

• Clona el repo y entra en la carpeta n8n-nodes-claix.
• npm install && npm run build
• npm link en el paquete y npm link n8n-nodes-claix en el directorio custom de n8n.
• Reinicia n8n y verifica que el nodo Claix aparece en el panel.

Solución de problemas frecuentes

• El nodo no aparece: confirma que Community nodes está activo y que instalaste n8n-nodes-claix (no otro nombre).
• Error 401/403: revisa la API key en Credentials → Claix API.
• Error 400 schema: el schema_id debe ser un UUID válido del dashboard de Claix.
• Sin binario: el nodo anterior debe exponer Binary Data en la propiedad indicada (por defecto data).
• Actualizar versión: en Community nodes, desinstala e instala de nuevo, o actualiza desde npm si tu instancia lo permite.

Enlaces útiles

• Paquete npm n8n-nodes-claix: https://www.npmjs.com/package/n8n-nodes-claix
• Documentación API Claix: https://www.claix.dev/documentation
• OpenAPI: https://www.claix.dev/openapi.yaml
• Instalar community nodes (n8n): https://docs.n8n.io/integrations/community-nodes/installation/
• Guía PDF → JSON en n8n: /blog/pdf-a-json-n8n-ia-api
• Guía Word → JSON en n8n: /blog/doc-a-json-n8n-ia-api

Conclusión

En tres minutos tienes Claix dentro de n8n sin HTTP Request genérico: instala n8n-nodes-claix, configura la credencial, elige operación y schema_id, y enruta el JSON tipado al resto del flujo. Es la forma más rápida de pasar de documentos caóticos a datos listos para tu base de datos o CRM.