Recursos · Integración n8n

Integración Phantombuster n8nAutomatiza Phantombuster con n8n.

Un agente que termina y deja el resultado esperando dentro de Phantombuster sirve de poco. La integración Phantombuster n8n cierra ese hueco con un solo nodo: 5 operaciones sobre un único recurso, Agent, y ningún disparador propio. Otro punto de partida arranca el flujo, n8n encola el agente y recoge lo que produjo.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué resuelve la integración Phantombuster n8n?

La integración Phantombuster n8n conecta los agentes que ya montaste en Phantombuster, esos scripts que mucha gente llama phantoms, con un flujo de trabajo que sigue funcionando cuando ellos terminan. El nodo habla con la API de Phantombuster y expone 5 operaciones sobre un único recurso, Agent: lanzar uno, leerlo, listarlos todos, recoger la salida del último paso o eliminarlo.

Primer caso, la recogida nocturna. Un Schedule Trigger, el nodo de n8n que arranca un flujo cada cierto intervalo, dispara de madrugada, agent.launch encola el agente y un segundo paso con agent.getOutput deja las filas en Google Sheets. Nadie abre la consola de Phantombuster para pulsar un botón.

Segundo caso, el aviso con contexto. El flujo cuenta cuántas filas llegaron, envía el resumen por Gmail a quien lleva la prospección y crea las fichas que superan el filtro en HubSpot. Así el equipo se entera del lote sin revisar nada a mano.

Tercer caso, varios flujos que comparten el mismo agente. Max Instance Count solo lanza el agente si el número de instancias en marcha queda por debajo del valor que fijas. Junto a agent.getAll, que lista los agentes de la organización, tienes un inventario al día sin entrar en la interfaz.

El nodo HTTP Request toma el relevo cuando la operación que necesitas no está entre las 5 de esta lista. Llama a cualquier endpoint de la API de Phantombuster y reutiliza el mismo credential, es decir, la credencial que guardas una sola vez en n8n, mediante la autenticación predefinida.

Dos límites conviene tenerlos claros antes de montar nada. Phantombuster no tiene nodo trigger en n8n, así que ningún flujo arranca porque un agente acabe de terminar: programas la comprobación o haces que algo de tu sistema llame a un Webhook de n8n, una URL que un servicio externo invoca. Y el nodo cubre solo el recurso Agent, de modo que la gestión fina de containers queda para HTTP Request. Si vienes de cero con la plataforma, la Reseña n8n explica dónde brilla y dónde cuesta, y el Curso n8n recorre estas piezas en orden.

Conexión

¿Cómo se conecta Phantombuster con n8n?

  1. 01

    Genera la clave API en Phantombuster

    Entra en Workspace settings dentro de tu cuenta de Phantombuster, abre Third party API keys y pulsa Add API Key. La clave pertenece al workspace, no a una persona: alcanza los agentes de ese workspace y ninguno más. Cópiala en cuanto aparezca, porque desde esa misma pantalla la revocas si algún día un flujo la deja donde no debe.

  2. 02

    Guarda el credential en n8n

    En n8n abre el menú Credentials y crea un credential PhantomBuster. Solo hay un método de autenticación disponible, la clave API, y un campo que rellenar: API Key. Al guardarlo queda reutilizable: cada nodo Phantombuster de cualquier flujo lo encuentra en su lista desplegable, y cambiar la clave más adelante es una sola edición en lugar de un repaso a todos los flujos.

  3. 03

    Elige el agente dentro del nodo

    Coloca el nodo Phantombuster en el flujo, selecciona el credential y fija el recurso Agent junto con la operación. Casi todas las operaciones muestran una lista Agent Name or ID que el nodo rellena consultando tu cuenta. Si el identificador viene de un nodo anterior, cambia el campo a expresión, la sintaxis de n8n que lee un valor del item entrante, del estilo {{ $json.agentId }}.

Acciones

Lo que sabe hacer el nodo de Phantombuster

El nodo Phantombuster expone 5 operaciones en 1 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoGetGet ManyDeleteGet OutputLaunch
Agent✓✓✓✓✓

Agent

5 operaciones
01

Delete an agent

agent.delete

Lo que ves en n8n

Notas y casos de uso

Quita un agente de la organización a partir de su identificador. El borrado cuenta del lado de Phantombuster y el agente deja de figurar en las listas que el nodo carga para las demás operaciones.

Parámetros clave

  • Agent Name or ID: se escoge en la lista que el nodo rellena con los agentes de tu organización, o se escribe como expresión del tipo {{ $json.agentId }} cuando el identificador viaja con el item.
Casos de uso
la limpieza posterior a una campaña de pruebas, cuando un flujo creó agentes desechables y la lista ya no hay quien la lea.
02

Get an agent

agent.get

Lo que ves en n8n

Notas y casos de uso

Lee un agente y devuelve lo que Phantombuster guarda sobre él, desde el nombre hasta su configuración actual. Viene bien justo antes de un lanzamiento, para confirmar que el objetivo sigue existiendo.

Parámetros clave

  • Agent ID: aquí es un campo de texto, no una lista desplegable, así que el valor se escribe a mano o se arma con una expresión como {{ $json.id }} desde el nodo anterior.
Casos de uso
un control previo en un flujo que recibe identificadores de agentes desde una hoja de cálculo y debe saltarse las filas que apuntan a uno que ya no responde.
03

Get many agents

agent.getAll

Lo que ves en n8n

Notas y casos de uso

Lista los agentes de la organización del usuario conectado. Cada agente sale como un item independiente, algo cómodo cuando el resto del flujo recorre esa lista uno por uno.

Parámetros clave

  • Return All: activado, n8n encadena las páginas de la API y trae todos los agentes de la organización.
  • Limit: el tope que se aplica mientras Return All siga desactivado, de forma que el flujo solo ve los primeros agentes.
Casos de uso
un inventario que cae cada lunes en un archivo compartido, para que el equipo sepa qué agentes existen sin entrar en Phantombuster.
04

Get the output of an agent

agent.getOutput

Lo que ves en n8n

Notas y casos de uso

Recoge lo que produjo el container más reciente de un agente. Un container es una ejecución, así que esta operación relee el resultado de un paso encolado antes.

Parámetros clave

  • Agent Name or ID: el agente cuya última ejecución quieres leer.
  • Resolve Data: desactivado, la salida llega como cadena de texto; activado, n8n resuelve los datos y el nodo siguiente recibe campos aprovechables.
  • Prev Container ID: devuelve la salida del container posterior al que indicas, para no releer la misma ejecución.
Casos de uso
un segundo flujo que pasa al final del día y coloca los perfiles que reunió el agente.
05

Add an agent to the launch queue

agent.launch

Lo que ves en n8n

Notas y casos de uso

Encola un agente para que se ejecute. Phantombuster responde con el identificador del container recién creado, que un nodo posterior usa para buscar la salida.

Parámetros clave

  • Agent Name or ID: el agente que se encola, de la lista o por expresión.
  • Arguments y Arguments (JSON): el argumento del agente, campo a campo o en JSON, que su script lee con buster.argument.
  • Bonus Argument: un valor de un solo uso que se fusiona con el argumento original para este lanzamiento.
  • Max Instance Count: lanza el agente solo si las instancias en marcha quedan por debajo del número indicado.
Casos de uso
un flujo que pasa el término de un formulario como bonus argument y relanza el agente sobre otro objetivo.
Necesitas ayuda

¿Necesitas ayuda para automatizar Phantombuster con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Phantombuster y n8n, las dudas más frecuentes

01¿La integración Phantombuster n8n es gratuita?
Sí por el lado de n8n. El nodo de Phantombuster viene incluido con n8n, así que no hay nada que instalar ni coste adicional, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, de modo que puedes montarlo en Cloud y llevarlo más adelante a tu propio servidor sin tocar el nodo. Lo que cueste tu cuenta de Phantombuster es otro asunto, depende del plan que tengas contratado allí y esta página no entra en ello.
02¿Qué credenciales hacen falta para conectar Phantombuster?
Una clave API, y es el único método de autenticación que admite el credential. La creas dentro de tu cuenta de Phantombuster, en Workspace settings, sección Third party API keys, con el botón Add API Key. En n8n el credential pide un solo campo, API Key. Una vez guardado queda reutilizable en todos los flujos: vive en el menú Credentials y el nodo lo ofrece en su lista desplegable. Ningún flujo almacena la clave en sí, por lo que cambiarla consiste en editar un credential y no en repasar cada nodo que habla con Phantombuster.
03¿Qué límites tiene el nodo de Phantombuster en n8n?
El nodo cubre un recurso, Agent, con 5 operaciones: eliminar, leer, listar, recoger la salida y lanzar. Lo que quede fuera de esa lista no está en el nodo. Ahí entra HTTP Request, que llama a cualquier endpoint de la API de Phantombuster reutilizando el mismo credential mediante la autenticación predefinida, así que la clave sigue en un único sitio. Hay dos comportamientos que conviene prever. Get many agents devuelve solo los primeros resultados mientras Return All siga desactivado. Y get output lee el container más reciente de un agente, de modo que un flujo que lanza y lee seguido puede llegar demasiado pronto.
04¿Puede Phantombuster disparar un flujo de n8n en tiempo real?
No, porque Phantombuster no tiene nodo trigger en n8n. Un flujo que lo use arranca siempre desde otro sitio: un Schedule Trigger que corre cada cierto intervalo, un Webhook de n8n, que es una URL a la que llama un servicio externo, o el trigger de otra herramienta que ya tengas montada. El montaje habitual son dos flujos. El primero encola el agente según la programación. El segundo pasa más tarde, llama a get output y reparte el resultado. Separarlos evita además dejar una ejecución esperando mientras el agente avanza en su cola.
05¿n8n o Make para Phantombuster?
Depende de dónde quieras que viva la automatización. Make lo aloja Make, sin opción de autoalojamiento, y factura por operación, algo cómodo para un equipo que no quiere tocar infraestructura. n8n corre en n8n Cloud o en tu propio servidor con Docker o npm, así que los datos que salen de tus agentes se quedan donde tú decidas, y un bucle largo sobre una lista de perfiles no pesa igual en la factura. Los dos ofrecen un editor visual. La decisión va por alojamiento, control de los datos y modelo de coste, no por quién tiene más nodos.