Ressources · Intégration n8n

Nœud SearXNG n8nConfigurer SearXNG dans n8n.

Le nœud SearXNG n8n donne à un agent IA un métamoteur que tu héberges toi-même. C'est un sous-nœud : pas d'entrée principale, il ne tourne jamais seul et se raccorde à un agent par un port d'outil. Quatre paramètres facultatifs cadrent la recherche, et la version livrée aujourd'hui est la version 1.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud SearXNG n8n ?

SearXNG interroge plusieurs moteurs de recherche à la fois et ne piste pas celui qui cherche. Le nœud expose cette instance à un agent IA sous forme d'outil appelable : c'est le modèle qui rédige la requête, le nœud la lance sur ton instance et renvoie les résultats en JSON pour que le modèle les lise. Rien ne se règle requête par requête, seulement les quatre options qui encadrent toutes les recherches.

Trois usages reviennent tout le temps. Un agent de recherche qui répond sur l'actualité de la semaine plutôt que sur ce qu'il a appris à l'entraînement : le modèle reçoit un outil de recherche, décide lui-même quand s'en servir, et l'option Number of Results fixe la quantité de matière qu'il aura à digérer. Une veille programmée qui lit la presse, la résume et dépose le digest là où l'équipe regarde déjà, un canal Slack ou un onglet Google Sheets. Et une veille cadrée par langue, où Language reste fixé sur un seul code à deux lettres pour qu'une revue du marché français ne dérive pas vers des sources anglophones.

Le nœud est un sous-nœud, c'est-à-dire un petit nœud qui se greffe sur un nœud plus gros au lieu de vivre dans le flux principal. Il se branche sur le port d'outil d'un nœud racine : AI Agent, AI Agent Tool ou MCP Server Trigger. Posé seul sur le canevas, il ne fait rien, et n8n refuse de l'exécuter.

Quand vaut-il mieux passer par autre chose ? Si le workflow lance toujours la même requête et qu'aucun modèle n'intervient, l'agent coûte pour rien : tu paies un modèle pour réécrire une chaîne que tu connais déjà. L'intérêt du nœud, c'est la décision, pas la recherche. Confie-le à un agent qui doit établir s'il a besoin de chercher, et avec quels mots.

Deux limites à connaître avant de construire. Le nœud attend des résultats en JSON, un format que la configuration SearXNG par défaut ne sert pas : une instance sortie de sa boîte ne répond rien d'exploitable tant que ses réglages n'ont pas bougé. Et l'instance doit être joignable depuis n8n sur le même réseau, ce qui exclut une installation sur un poste local si n8n tourne ailleurs. Pour le reste, la qualité des résultats dépend de la santé et des moteurs de ton instance, pas du nœud. Si le modèle de l'agent reste flou, l'Avis n8n reprend le sujet de zéro.

Connexion

Comment connecter SearXNG à n8n ?

  1. 01

    Faire tourner une instance

    Le nœud parle à un service SearXNG que tu fais tourner, pas à une adresse publique entretenue par quelqu'un d'autre. Ce service doit se trouver sur un réseau que ton instance n8n atteint, d'où le réflexe de le poser dans un conteneur voisin. L'emplacement des fichiers dépend du mode d'installation, et la documentation d'administration de SearXNG couvre les différents chemins.

  2. 02

    Activer la sortie JSON

    SearXNG ne sert pas de JSON à l'installation, et le nœud en a besoin. Ouvre le settings.yml de l'instance, cherche la section search.formats et ajoute json à côté de html. Si la section n'existe pas, crée-la. Redémarre le service, puis vérifie qu'une recherche renvoie bien du JSON avant de toucher à n8n.

  3. 03

    Créer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et choisis le credential SearXNG, c'est-à-dire l'identifiant stocké une fois et réutilisé partout. Il ne contient qu'un champ, API URL : l'adresse de l'instance à interroger. Tous les workflows qui en ont besoin pointent alors vers la même entrée, au lieu de répéter l'adresse dans chaque nœud.

Connexions

Où se branche le nœud ?

n8n sépare les nœuds racines, qui vivent dans le flux et reçoivent les items, des sous-nœuds, accrochés aux ports d'un nœud racine et déclenchés seulement quand celui-ci les appelle. SearXNG appartient à la seconde catégorie et n'a qu'un seul port.

Sortie (où il se branche)

  • Toolai_tool
01ToolC'est le port de sortie qui transforme le nœud en outil appelable par un modèle. Le nœud racine annonce l'outil au modèle, le modèle juge si une recherche vaut le coup, et les résultats reviennent nourrir son raisonnement.

C'est le port de sortie qui transforme le nœud en outil appelable par un modèle. Le nœud racine annonce l'outil au modèle, le modèle juge si une recherche vaut le coup, et les résultats reviennent nourrir son raisonnement.

Paramètres clés

  • Required : sans entrée principale et incapable de s'exécuter seul, le nœud reste inerte tant qu'il n'est pas relié au port d'outil d'un nœud racine.
  • AI Agent : l'hôte habituel, un agent qui choisit ses outils au fil de sa réponse.
  • AI Agent Tool : un agent exposé comme outil à un autre agent, pour les montages imbriqués.
  • MCP Server Trigger : publie la recherche vers des clients extérieurs à n8n.
Cas d'usage
un agent de support qui vérifie une documentation publique avant de répondre, avec l'outil de recherche posé à côté du modèle de chat.
Paramètres

Que règles-tu sur le nœud SearXNG ?

Le nœud SearXNG compte 4 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Number of Results

options.numResults

Ce que tu vois dans n8n

Notes & cas d'usage

Plafonne le nombre de résultats rapportés par une recherche. La valeur par défaut est 10, et tout ce que le nœud renvoie finit dans le contexte du modèle : ce réglage est donc un budget autant qu'un filtre, puisque plus de résultats allongent le prompt.

Paramètres clés

  • Number of Results : un nombre ; laissé vide, il reste à 10.
Cas d'usage
un agent qui vérifie un fait n'a besoin que de quelques liens concordants et tourne plus léger avec une valeur basse ; un panorama de marché destiné à une synthèse rédigée gagne à ratisser plus large.
02

Search Page Number

options.pageNumber

Ce que tu vois dans n8n

Notes & cas d'usage

Désigne la page de résultats que le nœud va chercher. Le compteur démarre à 1, la première page, et l'avancer saute ce qui précède au lieu de s'y ajouter. Aucune boucle de pagination n'est intégrée : une deuxième page suppose un deuxième appel.

Paramètres clés

  • Search Page Number : un nombre, 1 par défaut.
Cas d'usage
quand la première page d'une requête large est trustée par les trois mêmes sites, un second outil SearXNG réglé sur la page 2 apporte à l'agent ce que le haut du classement ne montrait pas.
03

Language

options.language

Ce que tu vois dans n8n

Notes & cas d'usage

Filtre les résultats par langue avec un code à deux lettres, du type de ceux de la norme ISO 639 : en pour l'anglais, es pour l'espagnol, fr pour le français. La valeur par défaut est en, ce qu'on oublie facilement quand l'agent, lui, répond dans une autre langue.

Paramètres clés

  • Language : une chaîne contenant le code à deux lettres, en par défaut. La page de syntaxe de recherche SearXNG liste ce qu'accepte une instance.
Cas d'usage
une veille concurrentielle sur le marché français, où des résultats anglophones feraient dérailler la synthèse.
04

Safe Search

options.safesearch

Ce que tu vois dans n8n

Notes & cas d'usage

Demande aux moteurs qui le gèrent de filtrer les contenus explicites. Ceux qui ne connaissent pas l'option l'ignorent : c'est une préférence transmise, pas une garantie appliquée par le nœud lui-même.

Paramètres clés

  • Safe Search : trois choix, 0 (None), 1 (Moderate) et 2 (Strict). Par défaut, None.
Cas d'usage
un agent dont les réponses s'affichent dans un chat ouvert au public est plus tranquille sur Strict, puisque personne ne relit un résultat de recherche avant que le modèle le cite.
Besoin d'aide

Besoin d'aide pour automatiser SearXNG avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui suivent

01Le nœud SearXNG n8n est-il inclus dans n8n ?
Oui. Il fait partie du paquet IA livré avec n8n : rien à installer, aucun surcoût côté n8n, sur n8n Cloud comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Les coûts sont ailleurs. L'instance SearXNG tourne sur une infrastructure que tu fournis, et le fournisseur du modèle branché à l'agent facture ses propres appels d'API selon ses conditions. n8n n'ajoute rien à cette facture, et le nœud lui-même ne consomme aucun crédit particulier, que le workflow tourne sur le cloud de n8n ou sur ton propre serveur.
02Quels credentials faut-il pour connecter SearXNG ?
Un credential avec un seul champ, API URL, l'adresse de l'instance SearXNG à interroger. Aucun sélecteur d'authentification sur le nœud, aucune clé à faire tourner, puisque le nœud atteint un service que tu contrôles. Deux conditions comptent plus que le credential lui-même : l'instance doit être joignable depuis n8n sur le même réseau, et elle doit servir du JSON, ce qui suppose d'ajouter json à la section search.formats de son settings.yml. Une configuration SearXNG par défaut ne le fait pas, et c'est la cause d'échec la plus fréquente au premier essai.
03Quelles sont les limites du nœud SearXNG ?
Il cherche, et c'est tout son périmètre : quatre options, pas de crawl, pas de récupération de page, aucune lecture du contenu des liens trouvés. Les résultats reviennent sous forme de liste que le modèle lit, et récupérer le texte complet d'une page relève d'un autre nœud. La version présente au catalogue est la version 1 ; un workflow ancien peut afficher moins d'options. La qualité des réponses ne dépend pas du nœud non plus, mais des moteurs interrogés par ton instance et de son état du jour.
04Que faut-il brancher au minimum pour que la recherche fonctionne ?
Un nœud racine et un modèle de chat, au strict minimum. SearXNG se raccorde au port d'outil d'un AI Agent, d'un AI Agent Tool ou d'un MCP Server Trigger, et ce nœud racine réclame son propre sous-nœud de modèle de chat, avec le credential du fournisseur : sans lui, rien ne raisonne et rien ne décide de chercher. Commence avec un agent, un modèle et ce seul outil. La mémoire et l'output parser occupent d'autres ports, à ajouter plus tard, une fois que tu vois ce que l'agent fait d'un résultat.
05n8n ou Make pour ce type de recherche ?
Ça dépend de l'endroit où les données ont le droit de vivre. SearXNG existe justement pour que les requêtes restent sur une instance que tu exploites, et l'argument ne tient de bout en bout que si la plateforme d'automatisation tourne à côté. n8n s'auto-héberge en Docker ou en npm, donc le workflow et le moteur partagent un réseau privé. Make est hébergé, sans option d'auto-hébergement, et facture à l'opération, ce qui change le calcul sur un agent qui lance plusieurs recherches par réponse. Les deux dessinent les workflows visuellement : le choix se joue sur l'hébergement, la maîtrise des données et le modèle de coût.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.