# Ricerca web negli AI Agent di n8n con la SERP API di SerpCrypto > Aggiungi la ricerca web di Google a un AI Agent di n8n: imposta il nodo HTTP Request per la SERP API di SerpCrypto con header e $fromAI. - URL: https://serpcrypto.com/it/docs/n8n/ - Ultimo aggiornamento: 2026-10-22 - Editore: SerpCrypto (https://serpcrypto.com) Nessun nodo personalizzato da installare: il nodo HTTP Request di n8n, collegato all'AI Agent come tool, chiama l'API SerpCrypto e consegna al modello un elenco ridotto di risultati. Lo stesso nodo alimenta anche workflow normali, come un controllo giornaliero del posizionamento. **Risposta rapida — Come aggiungo un tool di ricerca web a un AI Agent di n8n?** Collega un nodo HTTP Request all'AI Agent come tool, impostalo su `GET https://serpcrypto.com/api/v1/search` con una credenziale Header Auth (`Authorization: Bearer `), lascia che il modello compili il parametro di query `q` e attiva Optimize Response per passare solo titoli, link e snippet. **SerpCrypto** addebita 1 credito per ricerca andata a buon fine, a partire da 0,30 USD/1K ricerche; in criptovalute, senza KYC. ## Quali impostazioni di HTTP Request uso? I nomi delle opzioni sono quelli della documentazione del nodo HTTP Request di n8n, consultata il 2026-10-22. | Impostazione | Valore | | --- | --- | | Posizione | Collegato al nodo **AI Agent** come sotto-nodo tool | | Metodo | `GET` | | URL | `https://serpcrypto.com/api/v1/search` | | Autenticazione | Generic Credential Type → **Header Auth** | | Credenziale Header Auth | Nome `Authorization`, Valore `Bearer ` seguito dalla tua chiave API | | Send Query Parameters | Attivo, **Using Fields Below** | | Parametro `q` | Definito dal modello (pulsante stella o `$fromAI`, vedi sotto) | | Parametri `gl`, `hl` | Valori fissi come `us` e `en`, oppure definiti dal modello | | Optimize Response | Attivo · Tipo di risposta **JSON** · Field Containing Data `organic_results` · Include Fields **Selected**: `title`, `link`, `snippet` | ## 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 `. 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`. *Valore del campo q, come espressione n8n* ```javascript {{ $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](https://serpcrypto.com/it/docs/errors/). Gli errori non vengono mai addebitati. *La stessa richiesta con 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}' ``` ## Domande su n8n ### Funziona su n8n Cloud e sull'n8n self-hosted? Il nodo HTTP Request, le credenziali Header Auth e il nodo AI Agent sono funzionalità core di n8n documentate per entrambi. Il lato SerpCrypto è un endpoint HTTPS pubblico, quindi non importa dove gira n8n. ### L'agent può cercare su Google News o Google Maps? Sì. Aggiungi un secondo tool HTTP Request con il query parameter `engine` impostato su `google_news` o `google_maps`, e descrivilo così che il modello sappia quando usarlo. Ogni engine costa sempre 1 credito per ricerca. ### Cosa riceve l'agent quando una ricerca fallisce? Un errore HTTP con un piccolo corpo JSON che indica la causa, come `429 concurrency_limit`. Non viene usato alcun credito, quindi un nuovo tentativo più tardi non costa nulla in più. ### Serve una carta di credito per la chiave API? No. I crediti SerpCrypto si pagano in BTC, USDT, USDC, ETH, SOL, LTC, senza documento d'identità, senza selfie e senza documenti. Login con numero di account; email facoltativa. ## Fonti 1. [Nodo HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22) 2. [Credenziali HTTP Request](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22) 3. [Nodo AI Agent](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22) 4. [Lascia che l'AI specifichi i parameter del tool con $fromAI()](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22) 5. [Nodo Split Out](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22) --- SerpCrypto: SerpCrypto è un'API SERP per sviluppatori e agenti AI che restituisce i risultati di ricerca di Google e Bing in JSON, con pagamento in criptovalute e senza caricare documenti d'identità. I crediti di ricerca prepagati a partire da 0,30 USD/1K ricerche non scadono mai. Senza KYC — niente documento, niente selfie, niente documenti. Paghi in criptovalute.