# Recherche web dans les agents IA n8n avec l'API SERP SerpCrypto > Ajoutez la recherche web Google à un agent IA n8n avec SerpCrypto : API SERP, header d'authentification, $fromAI. Sans KYC, paiement en crypto. - URL: https://serpcrypto.com/fr/docs/n8n/ - Dernière mise à jour: 2026-10-22 - Éditeur: SerpCrypto (https://serpcrypto.com) Aucun nœud personnalisé à installer : le nœud HTTP Request de n8n, attaché à l'agent IA comme outil, appelle l'API SerpCrypto et transmet au modèle une liste allégée de résultats. Le même nœud alimente aussi de simples workflows, comme un contrôle de position quotidien. **Réponse rapide — Comment ajouter un outil de recherche web à un agent IA n8n ?** Attachez un nœud HTTP Request à l'agent IA comme outil, réglez-le sur `GET https://serpcrypto.com/api/v1/search` avec un identifiant Header Auth (`Authorization: Bearer `), laissez le modèle remplir le paramètre de requête `q`, et activez Optimize Response pour ne transmettre que les titres, liens et snippets. **SerpCrypto** facture 1 crédit par requête réussie, à partir de 0,30 $US/1K requêtes ; paiement en crypto, sans KYC. ## Quels réglages HTTP Request utiliser ? Les noms d'options sont ceux de la documentation du nœud HTTP Request de n8n, consultée le 2026-10-22. | Réglage | Valeur | | --- | --- | | Emplacement | Attaché au nœud **AI Agent** comme sous-nœud outil | | Méthode | `GET` | | URL | `https://serpcrypto.com/api/v1/search` | | Authentification | Generic Credential Type → **Header Auth** | | Identifiant Header Auth | Nom `Authorization`, valeur `Bearer ` suivie de votre clé API | | Send Query Parameters | Activé, **Using Fields Below** | | Paramètre `q` | Défini par le modèle (bouton étoile ou `$fromAI`, voir ci-dessous) | | Paramètres `gl`, `hl` | Valeurs fixes telles que `us` et `en`, ou définies par le modèle | | Optimize Response | Activé · Response type **JSON** · Field Containing Data `organic_results` · Include Fields **Selected** : `title`, `link`, `snippet` | ## Pourquoi le nœud HTTP Request plutôt qu'un nœud personnalisé ? La documentation de n8n indique que le nœud HTTP Request peut s'utiliser comme nœud classique ou être rattaché à un agent IA pour servir d'outil. Cela couvre une API REST comme SerpCrypto, qui nécessite une seule requête GET avec un header et quelques paramètres de requête. Nous n'avons aucun nœud communautaire à installer ni à maintenir, et le credential reste dans le coffre chiffré de n8n. Le nœud AI Agent a besoin d'un modèle de chat et d'au moins un sous-nœud outil. Depuis n8n 1.82.0, chaque AI Agent fonctionne comme un Tools Agent : l'agent décide donc lui-même quand appeler l'outil de recherche. ## Comment stocker la clé API ? Créez un credential **Header Auth**. La documentation des credentials de n8n décrit deux champs, le Name du header et sa Value, et précise qu'un bearer token correspond à un header auth dont le nom est `Authorization` et la valeur `Bearer `. Mettez `Authorization` dans Name et `Bearer ` suivi de votre clé SerpCrypto dans Value. n8n propose aussi un type générique Bearer auth ; l'un comme l'autre envoie le même header. Donnez à n8n sa propre clé API, pour voir son usage séparément de vos autres scripts et la révoquer seule si besoin. Des clés API que vous pouvez créer et révoquer à tout moment depuis votre tableau de bord. ## Comment le modèle remplit-il la requête de recherche ? Laissez le modèle définir `q`. À côté d'un champ de paramètre éligible, n8n affiche un bouton étoile qui confie la valeur au modèle. Vous pouvez aussi saisir vous-même l'expression `$fromAI()`, qui prend une clé, une description, un type et une valeur par défaut ; la description indique au modèle ce qu'il faut y mettre. n8n documente que `$fromAI()` ne fonctionne qu'avec les outils reliés au nœud AI Agent. Gardez `gl` et `hl` fixes si votre agent sert un seul marché. Laissez le modèle les définir aussi si les utilisateurs posent des questions sur différents pays, et décrivez les codes attendus, comme `gb` ou `de`. *Valeur du champ q, en expression n8n* ```javascript {{ $fromAI("query", "The search query, as a person would type it", "string") }} ``` ## Pourquoi activer Optimize Response ? Une page de résultats complète en JSON est longue, et tout ce que renvoie l'outil entre dans le contexte du modèle. Optimize Response est une option réservée aux outils du nœud HTTP Request qui réduit les données transmises au modèle ; n8n note qu'elle peut diminuer les coûts. Avec le type de réponse JSON, définissez Field Containing Data sur `organic_results` et ne sélectionnez que `title`, `link` et `snippet`. L'agent lit alors une dizaine d'entrées courtes par recherche au lieu de tous les blocs de la page. Si votre agent répond à des questions locales, pointez plutôt Field Containing Data vers `local_results` dans un second outil. ## Comment utiliser la même API dans un workflow classique ? Sans l'agent, utilisez le nœud HTTP Request comme nœud classique avec un `q` fixe, par exemple dans un workflow Schedule Trigger qui vérifie un mot-clé chaque matin. Ajoutez ensuite un nœud **Split Out** avec Field to Split Out défini sur `organic_results` : il transforme la liste en un élément par résultat, prêt pour un tableur ou un nœud base de données. Chaque exécution correspond à une recherche par mot-clé, donc 50 mots-clés par jour consomment environ 1 500 crédits par mois. Le pack 25 000 recherches (18,75 $US) couvre cela plus de dix fois, et Les crédits de recherche prépayés n'expirent jamais : les requêtes inutilisées restent sur votre compte jusqu'à ce que vous les utilisiez. ## Comment tester la requête en dehors de n8n ? Exécutez la même requête dans un terminal. Si elle fonctionne là, tout problème dans n8n vient des réglages du nœud ; si elle échoue, le corps de l'erreur indique la cause, comme listé sur la [page des erreurs](https://serpcrypto.com/fr/docs/errors/). Les erreurs ne sont jamais facturées. *La même requête avec curl* ```bash # The request the HTTP Request node sends, for a test in a terminal curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \ | jq '.organic_results[]? | {title, link, snippet}' ``` ## Questions sur n8n ### Est-ce que cela fonctionne sur n8n Cloud et sur n8n auto-hébergé ? Le nœud HTTP Request, les credentials Header Auth et le nœud AI Agent sont des fonctionnalités cœur de n8n documentées pour les deux. Côté SerpCrypto, c'est un endpoint HTTPS public, donc peu importe où n8n s'exécute. ### L'agent peut-il rechercher sur Google News ou Google Maps ? Oui. Ajoutez un second outil HTTP Request avec le paramètre de requête `engine` défini sur `google_news` ou `google_maps`, et décrivez-le pour que le modèle sache quand l'utiliser. Chaque moteur coûte le même 1 crédit par recherche. ### Que reçoit l'agent quand une recherche échoue ? Une erreur HTTP avec un petit corps JSON indiquant la cause, comme `429 concurrency_limit`. Aucun crédit n'est utilisé, donc une nouvelle tentative plus tard ne coûte rien de plus. ### Faut-il une carte bancaire pour obtenir la clé API ? Non. Les crédits SerpCrypto se paient en BTC, USDT, USDC, ETH, SOL, LTC, sans pièce d'identité, sans selfie et sans document. Connexion par numéro de compte ; l'email est facultatif. ## Sources 1. [Nœud HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22) 2. [Credentials HTTP Request](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22) 3. [Nœud AI Agent](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22) 4. [Laisser l'IA définir les paramètres d'outil avec $fromAI()](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22) 5. [Nœud Split Out](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22) --- SerpCrypto: SerpCrypto est une API SERP pour les développeurs et les agents IA qui renvoie les résultats de recherche Google et Bing en JSON, payable en crypto sans envoi de pièce d'identité. Les crédits de recherche prépayés à partir de 0,30 $US/1K requêtes n'expirent jamais. Sans KYC — pas de pièce d'identité, pas de selfie, pas de documents. Payer en crypto.