Recherche web pour les agents AI n8n avec l'outil HTTP Request

Pourquoi le nœud HTTP Request plutôt qu'un nœud personnalisé ?

Parce qu'une seule requête GET avec un header et quatre paramètres de requête suffit à l'API. La documentation de n8n indique que le nœud HTTP Request peut s'exécuter comme nœud classique ou être attaché à un AI agent comme outil, et que certaines options n'existent que sous la forme outil.

Rien de notre côté n'a besoin d'être installé ou mis à jour, et la clé reste dans le coffre de credentials de n8n plutôt que dans le workflow. Donnez à n8n sa propre clé. Créez une clé API par agent, application ou coéquipier et révoquez n'importe laquelle depuis le dashboard sans toucher aux autres.

Comment le modèle rédige-t-il la requête de recherche ?

Via la fonction $fromAI() de n8n, dans la valeur du champ q. Sa forme documentée est $fromAI(key, description, type, defaultValue) : utilisez la clé query, une description comme « What to search for on the web », et le type string. n8n précise que $fromAI() ne fonctionne que dans les outils connectés au nœud AI Agent.

Décrivez aussi l'outil lui-même en mots simples, par exemple « Searches the web and returns sources with their page text; cite the URLs ». L'agent s'appuie sur ce texte pour décider quand effectuer une recherche.

Pourquoi activer Optimize Response ?

Parce que tout ce que renvoie un outil finit dans le contexte du modèle. Optimize Response est une option réservée aux outils qui réduit ce qui est transmis au modèle. Avec le type JSON, réglez Field Containing Data sur results, puis n'incluez que title, url et content.

L'agent ne voit alors qu'une courte liste de sources avec leur texte, et rien d'autre. Limitez la longueur de notre côté avec max_chars, qui tronque chaque page avant qu'elle ne quitte l'API.

Puis-je lancer des recherches planifiées sans agent ?

Oui. Utilisez le nœud HTTP Request comme nœud classique derrière un Schedule Trigger, avec une requête fixe. Ajoutez topic=news et time_range=day pour collecter les articles du jour sur un sujet, puis envoyez les titres et les URLs vers un chat, un tableur ou un email.

Une recherche d'actualités planifiée par jour consomme environ 30 crédits par mois, donc 5 000 requêtes (9,25 $US) couvre de nombreux sujets pendant longtemps. Les crédits de recherche n'ont pas de date d'expiration : ce que vous n'utilisez pas ce mois-ci est toujours là l'année prochaine.

Que reçoit le workflow quand une page est refusée ?

La recherche aboutit quand même. Le résultat refusé conserve son titre et son URL, n'a pas de content, et son content_status indique pourquoi, par exemple blocked_by_robots. Notre lecteur respecte robots.txt : il s'annonce comme LLMWebSearch, suit les règles qu'un site écrit pour lui ou pour tous les robots, et laisse de côté le contenu de toute page qu'il n'est pas autorisé à lire.

Les erreurs HTTP sont différentes : une mauvaise clé renvoie 401, un solde vide 402, trop d'appels 429. Dans un agent, laissez l'outil renvoyer l'erreur pour que le modèle puisse l'expliquer. Dans un workflow planifié, acheminez les erreurs vers une branche qui les journalise. La page des erreurs liste tous les codes.

Comment tester l'appel avant de construire le workflow ?

Lancez la même requête avec curl depuis les recettes curl. Si elle fonctionne dans un terminal et échoue dans n8n, la cause se trouve dans les réglages du nœud. Les suspects habituels sont une valeur de credential sans le préfixe Bearer , ou un champ q vide.