Intégration n8n

Scavio fournit un nœud communautaire officiel vérifié par n8n : n8n-nodes-scavio. Intégrez-le dans n'importe quel workflow n8n pour effectuer des recherches en temps réel sur Google, Amazon, Walmart, YouTube et Reddit sans écrire de nœuds HTTP ni gérer des en-têtes d'authentification personnalisés. Le nœud est également usableAsTool, vous pouvez donc le connecter directement à un nœud AI Agent de n8n.

Statut vérifié

• Package sur npm : n8n-nodes-scavio
• Approuvé par l'équipe n8n et expédié comme nœud communautaire vérifié dans le prochain lot de versions n8n
• Code source : github.com/scavio-ai/n8n-nodes-scavio
• Licence : MIT

Prérequis

1. n8n version 1.0 ou ultérieure (cloud ou auto-hébergé).
2. Une clé API Scavio depuis dashboard.scavio.dev.

Installation (n8n Cloud et auto-hébergé)

Dans n8n, ouvrez Paramètres → Nœuds communautaires → Installer et entrez le nom du package :

n8n-nodes-scavio

Cliquez sur Installer. n8n téléchargera la dernière version vérifiée depuis npm et enregistrera le nœud Scavio dans votre éditeur de workflow. Aucun redémarrage nécessaire sur n8n Cloud ; l'auto-hébergé peut nécessiter un rechargement.

Installation (manuel / Docker)

Pour les instances auto-hébergées qui préfèrent épingler le package directement :

# Dans votre conteneur ou hôte n8n
npm install n8n-nodes-scavio

# Ensuite, redémarrez n8n pour que le nœud soit chargé
n8n start

Pour les déploiements Docker, montez un volume qui inclut le package installé ou étendez l'image n8n et exécutez npm install n8n-nodes-scavio dans le cadre de la construction.

Configurer les identifiants

1. Dans n8n, ouvrez Identifiants → Nouveau et sélectionnez Scavio API.
2. Collez votre clé API Scavio dans le champ API Key. La clé est stockée de manière cryptée par n8n.
3. Cliquez sur Test. Le test d'identifiant appelle GET /api/v1/usage sur l'API Scavio (un point de terminaison gratuit), donc vous obtenez un retour instantané que la clé est valide sans consommer de crédits.

Utiliser le nœud Scavio

1. Ajoutez un nouveau nœud à votre workflow et recherchez Scavio.
2. Choisissez une Ressource :
   • Google — recherche SERP organique.
   • Amazon — recherche de produits et détail de produit par ASIN sur 12 places de marché.
   • Walmart — recherche de produits et détail de produit avec filtres de livraison et de prix.
   • YouTube — recherche de vidéos et métadonnées.
   • Reddit — recherche de publications et arbre complet de publication + commentaires par ID.
   • Account — vérifier l'utilisation de l'API et les crédits restants.
3. Choisissez une Opération pour cette ressource (par exemple Search, Get Product, Get Post).
4. Remplissez les paramètres de l'opération (chaîne de requête, pays, ASIN, ID de publication, etc.).
5. Exécutez le nœud. La sortie est un JSON structuré que vos nœuds en aval peuvent lire directement.

Utiliser comme outil dans les nœuds AI Agent de n8n

Le nœud Scavio est enregistré avec usableAsTool: true, donc les nœuds AI Agent de n8n peuvent l'appeler comme outil dans un raisonnement en plusieurs étapes. Connectez le nœud Scavio à l'entrée d'outil de l'agent et l'agent appellera Scavio: Google Search, Scavio: Amazon Search Products, etc. selon les besoins pendant une exécution.

Opérations disponibles

Exemples de workflows

Quelques cas d'utilisation courants où le nœud Scavio s'intègre parfaitement :

• Qualification de leads — Webhook entrant → Scavio (Google · site:linkedin.com/company COMPANY) → Évaluation LLM → Écriture CRM.
• Alertes de baisse de prix Amazon — Cron → Scavio (Amazon · Get Product par ASIN) → Comparaison avec le prix précédent → Alerte Slack. Un exemple de workflow fonctionnel est fourni dans le dépôt sous workflows/amazon-price-drop.json.
• Surveillance des sentiments sur Reddit — Cron → Scavio (Reddit · Search Posts) → Résumé LLM → Email de synthèse quotidien.
• Automatisation de contenu localisé — Cron quotidien → Scavio (Google + Reddit) pour un contexte local en temps réel → LLM compose des publications → Google Sheet pour approbation client.
• Bots WhatsApp / Slack fondés — Déclencheur sur message → Scavio (Google) pour une réponse en temps réel fondée → LLM compose la réponse → Réponse dans le canal.

Mettre à jour le nœud

n8n surveille npm pour les nouvelles versions des nœuds vérifiés et les propage automatiquement après une rapide re-vérification. Pour forcer une mise à jour manuelle sur n8n auto-hébergé :

npm install n8n-nodes-scavio@latest
n8n start

Dépannage

• Le test d'identifiant échoue : vérifiez que la clé API est la clé complète préfixée sk_live_ depuis dashboard.scavio.dev et que votre réseau peut atteindre https://api.scavio.dev.
• Le nœud n'apparaît pas dans l'éditeur après l'installation : sur l'auto-hébergé, redémarrez le processus n8n pour qu'il réenregistre les nœuds communautaires.
• Erreurs 429 / limite de débit : consultez la documentation sur les limites de débit et la référence des erreurs pour les conseils de réessai.

Ressources

• n8n-nodes-scavio sur npm
• Source sur GitHub
• Guide d'installation des nœuds communautaires n8n
• Démarrage rapide de l'API Scavio
• Référence de l'API Google Search