Versione: 1.0 | Ideale per professionisti e proprietari di blog
Obiettivo dell’Agente Analista Web
Questa prima versione dell’agente intelligente ha come scopo aiutare blogger e piccoli business a monitorare e migliorare le performance del proprio sito web/blog attraverso l’integrazione automatica con Google Analytics 4.
L’agente può:
- 📊 Analizzare dati di traffico, comportamento utenti, engagement e contenuti.
- 💡 Offrire consigli personalizzati per ottimizzare contenuti, migliorare le metriche e risolvere problemi come bounce rate alto o poco coinvolgimento.
- 🧠 Capire le richieste in linguaggio naturale grazie all’integrazione con modelli AI.
- 🤖 Fornire un’interfaccia conversazionale (chatbot) per interrogare i dati.
⚙️ Tutto questo viene orchestrato da due flussi in n8n:
Agente_Analista_Web_Blog.json: il cervello e l’interfaccia dell’agente.MCP_Analista_web_Blog.json: il motore dati, che raccoglie le informazioni da Google Analytics.
🧭 FASE 1: Configurare l’Agente Principale (Agente_Analista_Web_Blog.json)
🔰 PRIMA SCELTA FONDAMENTALE: Interfaccia Interna o Esterna?
Quando configuri questo sistema, devi decidere come vuoi interagire con l’agente:
| Opzione | Descrizione | Quando usarla |
|---|---|---|
| ✅ Chat Interna n8n (consigliata per iniziare) | Funziona direttamente dentro n8n. Chat semplice, nessuna configurazione esterna. | Per testare e usare subito l’assistente |
| 🧩 Webhook per Chat Esterna | Permette di collegare Telegram, WhatsApp, siti web, Bubble, ecc. | Quando vuoi integrarlo nel tuo ecosistema (sito o app) |
✳️ Nota importante: nel file JSON troverai due nodi webhook non collegati vicino all’agente. Questi servono esattamente per creare un’interfaccia personalizzata esterna (come un bot, un’app, o un modulo web). Puoi usarli se desideri sviluppare una chat esterna che comunichi con n8n.
Per ora puoi lasciarli così, oppure iniziare dalla chat interna e integrarli in seguito.
📥 Importazione Workflow
- Vai in n8n, clicca su “Import”, carica il file
Agente_Analista_Web_Blog.json. - Apri il flusso importato per procedere alla configurazione dei singoli nodi.
🧩 NODI DETTAGLIATI – COSA FANNO E COME CONFIGURARLI
🔹 When chat message received – Chat interna n8n
Cosa fa:
Questo nodo riceve il messaggio digitato da te nell’interfaccia chat di n8n (visibile nel pannello Chat). È il punto di inizio della conversazione con l’agente.
Come si configura:
- ✅ Non devi modificare nulla. È già attivo e funzionante.
- ⚠️ Assicurati che sia collegato al nodo
AI Agent(lo è già nel file importato).
🔹 AI Agent – L’agente conversazionale
Cosa fa:
Elabora le tue domande e comandi. Usa l’AI per comprendere cosa vuoi sapere, e decide come rispondere: analizza dati, interroga Google Analytics e fornisce risposte utili.
Come si configura:
- ✅ Il nodo è già configurato per funzionare.
- ⚙️ Usa il campo
text: {{$json.body.message}}per ricevere la tua domanda dalla chat. - 📌 Se modifichi il prompt o vuoi aggiungere istruzioni personalizzate, puoi farlo nel campo
text.
Collegamenti Importanti:
- È connesso a:
OpenAI Chat Model(per generare risposte AI)Simple Memory(per ricordare la conversazione)MCP Client(per interfacciarsi con i dati di Google Analytics)
🔹 OpenAI Chat Model – Motore AI
Cosa fa:
Genera risposte in linguaggio naturale, capisce le domande e propone soluzioni.
Come si configura:
- Vai su Credentials > OpenAI, crea una nuova credenziale con la tua API key.
- Ritorna nel nodo e collega la tua credenziale nel campo
openAiApi.
Modello predefinito usato: gpt-4o-mini – ottimo per analisi e conversazioni efficienti.
🔹 Simple Memory – Memoria conversazionale
Cosa fa:
Mantiene memoria delle ultime 20 interazioni, così l’agente capisce il contesto (es: domande follow-up).
Come si configura:
- ✅ Nessuna configurazione necessaria.
- ⚠️ Non cambiare il
sessionKey, serve a distinguere utenti diversi.
🔹 MCP Client – Collegamento al motore dati
Cosa fa:
Questo nodo è l’interfaccia che collega l’agente al modulo secondario MCP_Analista_web_Blog. Quando fai una domanda che richiede dati reali (es: “Qual è il contenuto più visto?”), passa la richiesta al workflow MCP.
Come si configura:
- ✅ Nessuna modifica necessaria.
- L’indirizzo
https://primary-production-8941.up.railway.app/mcp/...è già preimpostato per connettere al secondo flusso.
🔹 Webhook e Respond to Webhook – (interfaccia esterna, opzionale)
Cosa fanno:
Permettono di collegare il sistema a strumenti esterni come un chatbot su Telegram, WhatsApp o sito web.
Come si configurano (opzionale):
- ⚙️ Copia il
Webhook URLdal nodo e collegalo al tuo frontend o servizio esterno. - Usa
Respond to Webhookper inviare la risposta dell’agente.
Per principianti: puoi ignorare questi nodi inizialmente.
🧭 FASE 2: Configurare il Motore Dati (MCP_Analista_web_Blog.json)
📥 Importazione
- Torna in n8n, clicca su Import.
- Carica il file
MCP_Analista_web_Blog.json.
🔧 Nodo Principale: MCP Server Trigger
Cosa fa:
Riceve richieste dall’agente e attiva uno o più nodi di analisi (Google Analytics).
Come si configura:
- ✅ Nessuna modifica necessaria.
- Funziona in automatico con il collegamento al
MCP Client.
📊 Nodi Google Analytics: Analisi Specifiche per Blog
Per ciascun nodo:
- ⚙️ Verifica che la proprietà GA4 (
propertyId) corrisponda al tuo sito. - 🔐 Assicurati di avere la credenziale Google Analytics OAuth2 collegata.
✅ Configura la credenziale:
- Vai su Credentials > Google Analytics OAuth2.
- Crea la connessione con il tuo account Google Analytics.
- Collega questa credenziale a tutti i nodi con il campo
credentials.googleAnalyticsOAuth2.
🧩 Elenco Nodi con Spiegazione
| Nodo | Cosa Analizza | Quando è Utile |
|---|---|---|
| traffico_attivo_temporale | Numero utenti attivi negli ultimi 1, 7, 28 giorni | Misura la crescita e attività generale |
| performance_sessioni | Sessioni, durata media, canale e dispositivo | Per valutare la qualità della navigazione |
| origine_traffico | Sorgenti di traffico (social, search, direct, ecc.) | Capire da dove arrivano gli utenti |
| contenuti_visualizzati_panoramica | Pagine viste, bounce rate, scroll | Scopri quali pagine interessano di più |
| coinvolgimento_eventi | Click, scroll, eventi su pagine | Capisci quanto gli utenti interagiscono |
| nuovi_vs_ritorno | Utenti nuovi rispetto a quelli di ritorno | Misura la fidelizzazione |
| traffico_geografico | Città, regioni e paesi di provenienza | Ottimizza contenuti per zone geografiche |
| browser_dispositivi | Browser, sistemi e dispositivi usati | Ottimizza l’esperienza utente |
| scroll_contenuti | Quanto scorrono i tuoi contenuti | Vedi se gli utenti leggono fino in fondo |
| Comportamento_per_giorno_della_settimana | Quando gli utenti interagiscono di più | Per scegliere i giorni migliori per pubblicare |
🛠️ Come modificare ogni nodo:
- Apri il nodo.
- Sotto Property ID, clicca sull’elenco a tendina oppure inserisci manualmente il tuo ID GA4.
- Lascia inalterati metrics e dimensions, sono già ottimizzati per blog.
- Collega la tua credenziale Google Analytics dal campo “Credentials”.
✅ Fine configurazione
Ora hai:
- 💬 Un assistente AI conversazionale attivo in n8n.
- 🔗 Un modulo secondario che fornisce dati reali da Google Analytics.
- 💡 Analisi pronte per migliorare contenuti, engagement e performance del tuo blog.
