Integrazione n8n

Scavio fornisce un nodo ufficiale della comunità verificato da n8n: n8n-nodes-scavio. Inseriscilo in qualsiasi flusso di lavoro n8n per eseguire ricerche in tempo reale su Google, Amazon, Walmart, YouTube e Reddit senza scrivere nodi HTTP o mantenere intestazioni di autenticazione personalizzate. Il nodo è anche usableAsTool, quindi puoi collegarlo direttamente a un nodo AI Agent di n8n.

Stato di verifica

• Pacchetto su npm: n8n-nodes-scavio
• Approvato dal team n8n e distribuito come nodo della comunità verificato nel prossimo lotto di release di n8n
• Codice sorgente: github.com/scavio-ai/n8n-nodes-scavio
• Licenza: MIT

Prerequisiti

1. Versione n8n 1.0 o successiva (cloud o self-hosted).
2. Una chiave API Scavio da dashboard.scavio.dev.

Installazione (n8n Cloud e self-hosted)

All'interno di n8n, apri Impostazioni → Nodi della comunità → Installa e inserisci il nome del pacchetto:

n8n-nodes-scavio

Fai clic su Installa. n8n scaricherà l'ultima versione verificata da npm e registrerà il nodo Scavio nel tuo editor di flussi di lavoro. Nessun riavvio richiesto su n8n Cloud; per self-hosted potrebbe essere necessario un ricaricamento.

Installazione (manuale / Docker)

Per istanze self-hosted che preferiscono fissare il pacchetto direttamente:

# All'interno del tuo contenitore o host n8n
npm install n8n-nodes-scavio

# Quindi riavvia n8n in modo che il nodo venga caricato
n8n start

Per deploy Docker, monta un volume che includa il pacchetto installato o estendi l'immagine n8n ed esegui npm install n8n-nodes-scavio come parte della build.

Configura le credenziali

1. In n8n, apri Credenziali → Nuovo e scegli Scavio API.
2. Incolla la tua chiave API Scavio nel campo Chiave API. La chiave viene memorizzata crittografata da n8n.
3. Fai clic su Test. Il test delle credenziali chiama GET /api/v1/usage sull'API Scavio (un endpoint gratuito), quindi ottieni un feedback immediato che la chiave è valida senza consumare crediti.

Usa il nodo Scavio

1. Aggiungi un nuovo nodo al tuo flusso di lavoro e cerca Scavio.
2. Scegli una Risorsa:
   • Google — ricerca organica SERP.
   • Amazon — ricerca prodotti e dettaglio prodotto per ASIN in 12 marketplace.
   • Walmart — ricerca prodotti e dettaglio prodotto con filtri di evasione e prezzo.
   • YouTube — ricerca video e metadati.
   • Reddit — ricerca post e albero completo di post + commenti per id.
   • Account — controlla l'utilizzo dell'API e i crediti rimanenti.
3. Scegli un'Operazione per quella risorsa (es. Search, Get Product, Get Post).
4. Compila i parametri dell'operazione (stringa di ricerca, paese, ASIN, id post, ecc.).
5. Esegui il nodo. L'output è un JSON strutturato che i nodi successivi possono leggere direttamente.

Usa come strumento all'interno dei nodi AI Agent di n8n

Il nodo Scavio è registrato con usableAsTool: true, quindi i nodi AI Agent di n8n possono chiamarlo come strumento all'interno del ragionamento multi-step. Collega il nodo Scavio all'input dello strumento dell'agente e l'agente chiamerà Scavio: Google Search, Scavio: Amazon Search Products, ecc. secondo necessità durante l'esecuzione.

Operazioni disponibili

Flussi di lavoro di esempio

Schemi comuni in cui il nodo Scavio si inserisce perfettamente:

• Qualificazione lead — Webhook in entrata → Scavio (Google · site:linkedin.com/company AZIENDA) → valutazione LLM → scrittura CRM.
• Avvisi di calo prezzo Amazon — Cron → Scavio (Amazon · Get Product per ASIN) → confronto con prezzo precedente → avviso Slack. Un flusso di lavoro di esempio funzionante è incluso nel repo come workflows/amazon-price-drop.json.
• Monitoraggio sentiment Reddit — Cron → Scavio (Reddit · Search Posts) → riepilogo LLM → email di riepilogo giornaliera.
• Automazione contenuti localizzati — Cron giornaliero → Scavio (Google + Reddit) per contesto locale in tempo reale → LLM compone post → Foglio Google per approvazione cliente.
• Bot WhatsApp / Slack basati su fatti — Trigger su messaggio → Scavio (Google) per ancoraggio della risposta in tempo reale → LLM compone risposta → risposta nel canale.

Aggiornamento del nodo

n8n monitora npm per nuove versioni dei nodi verificati e le propaga automaticamente dopo una breve revisione. Per forzare un aggiornamento manuale su n8n self-hosted:

npm install n8n-nodes-scavio@latest
n8n start

Risoluzione dei problemi

• Il test delle credenziali fallisce: conferma che la chiave API sia la chiave completa con prefisso sk_live_ da dashboard.scavio.dev e che la tua rete possa raggiungere https://api.scavio.dev.
• Il nodo non appare nell'editor dopo l'installazione: su self-hosted, riavvia il processo n8n in modo che registri nuovamente i nodi della comunità.
• Errori 429 / limiti di velocità: consulta la documentazione sui limiti di velocità e il riferimento agli errori per indicazioni sui tentativi.

Risorse

• n8n-nodes-scavio su npm
• Codice sorgente su GitHub
• Guida all'installazione dei nodi della comunità n8n
• Guida rapida API Scavio
• Riferimento API Google Search