Ricerca web negli AI Agent di n8n con la SERP API di SerpCrypto

Perché usare il nodo HTTP Request invece di un nodo personalizzato?

La documentazione di n8n dice che il nodo HTTP Request può funzionare come nodo normale o essere collegato a un AI agent per usarlo come tool. Questo copre un'API REST come SerpCrypto, che richiede una sola richiesta GET con un header e qualche query parameter. Non c'è un nostro community node da installare o tenere aggiornato, e la credenziale resta nell'archivio credenziali criptato di n8n.

Il nodo AI Agent richiede un chat model e almeno un tool sub-node. Da n8n 1.82.0 ogni AI Agent funziona come Tools Agent, quindi è l'agent a decidere da solo quando chiamare il tool di ricerca.

Come faccio a salvare la chiave API?

Crea una credenziale Header Auth. La documentazione sulle credenziali di n8n descrive due campi, il Name dell'header e il suo Value, e precisa che un bearer token è header auth con il nome Authorization e il valore Bearer <token>. Metti Authorization in Name e Bearer più la tua chiave SerpCrypto in Value.

n8n elenca anche un generico tipo Bearer auth; entrambi inviano lo stesso header. Assegna a n8n una chiave API dedicata, così puoi vedere il suo utilizzo separatamente dagli altri tuoi script e revocarla da sola se serve. Chiavi API che puoi creare e revocare in qualsiasi momento dalla tua dashboard.

Come fa il modello a compilare la query di ricerca?

Lascia che sia il modello a definire q. Accanto a un campo parameter idoneo, n8n mostra un pulsante a stella che affida il valore al modello. Puoi anche scrivere tu stesso l'espressione $fromAI(), che richiede una key, una description, un tipo e un valore predefinito; la description dice al modello cosa inserire. n8n documenta che $fromAI() funziona solo con i tool collegati al nodo AI Agent.

Tieni gl e hl fissi se il tuo agent serve un solo mercato. Lascia che sia il modello a impostarli anche loro se gli utenti chiedono di paesi diversi, e descrivi i codici attesi, come gb o de.

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

Perché attivare Optimize Response?

Una pagina intera di risultati in JSON è lunga, e tutto ciò che il tool restituisce finisce nel contesto del modello. Optimize Response è un'opzione solo per i tool del nodo HTTP Request che riduce i dati passati al modello; n8n segnala che può ridurre i costi. Con il tipo di risposta JSON, imposta Field Containing Data su organic_results e seleziona solo title, link e snippet.

L'agent legge così una decina di voci brevi per ricerca invece di ogni blocco della pagina. Se il tuo agent risponde a domande locali, punta Field Containing Data su local_results in un secondo tool.

Come faccio a usare la stessa API in un workflow normale?

Senza l'agent, usa il nodo HTTP Request come nodo normale con un q fisso, per esempio in un workflow con Schedule Trigger che controlla una keyword ogni mattina. Poi aggiungi un nodo Split Out con Field to Split Out impostato su organic_results: trasforma la lista in un elemento per risultato, pronto per un foglio di calcolo o un nodo database.

Ogni esecuzione è una ricerca per keyword, quindi 50 keyword al giorno consumano circa 1.500 crediti al mese. Il pacchetto da 25.000 ricerche crediti (18,75 USD) copre più di dieci volte quella cifra, e I crediti di ricerca prepagati non scadono mai: le ricerche non utilizzate restano sul tuo account finché non le usi.

Come faccio a testare la richiesta fuori da n8n?

Esegui la stessa richiesta in un terminale. Se funziona lì, qualsiasi problema in n8n deriva dalle impostazioni del nodo; se fallisce, il corpo dell'errore indica la causa, come elencato nella pagina degli errori. Gli errori non vengono mai addebitati.

# 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}'