L'API e il server MCP: collegare Vurto ai tuoi strumenti
Cosa permettono l'API REST e il server MCP di Vurto (piano Business): automatizzare report e collegare Vurto a Claude, Cursor, ChatGPT.
L'API REST e il server MCP (Model Context Protocol) di Vurto, disponibili a partire dal piano Business, permettono di collegare i tuoi dati di visibilità IA ai tuoi strumenti e di automatizzare il recupero dei report, senza passare dall'interfaccia web di Vurto.
Cosa espone l'API REST
L'API REST offre un accesso programmatico ai dati che normalmente consulti nelle dashboard: punteggi di visibilità per brand, categoria e parola chiave, risultati per motore IA, tabella dei concorrenti e delle fonti citate, così come i risultati dello scoring semantico delle tue schede prodotto. L'interesse principale è far uscire questi dati dall'interfaccia per integrarli altrove — una dashboard interna, uno strumento di reporting già esistente, un data warehouse — senza reinserimento manuale.
Due strumenti complementari, non concorrenti
L'API REST e il server MCP non si sostituiscono a vicenda: rispondono a due modi diversi di lavorare con i dati. L'API è adatta quando sai precisamente quali dati recuperare, con quale frequenza e in quale formato — un uso strutturato e ripetibile, generalmente impostato una volta da una persona tecnica e poi utilizzato automaticamente in seguito. Il server MCP è adatto quando la domanda non è ancora formulata in anticipo: scopri nel corso di una conversazione con il tuo assistente IA di avere bisogno di un dato o di un elemento di contesto sulla tua visibilità, senza aver previsto questa domanda in precedenza. Un team può benissimo usare entrambi in parallelo: l'API per i report ricorrenti, l'MCP per le esigenze puntuali che emergono nel flusso di lavoro.
Cosa offre il server MCP
Il server MCP risponde a un'esigenza diversa: permette a un assistente IA compatibile (Claude, Cursor, ChatGPT) di interrogare direttamente i tuoi dati Vurto in linguaggio naturale, nel contesto di una conversazione, anziché scrivere codice contro l'API. In pratica, questo permette di porre una domanda sulla tua visibilità o sui tuoi concorrenti direttamente nello strumento che già usi ogni giorno, senza aprire Vurto né scrivere una query.
Collegare Vurto ai tuoi strumenti
Il collegamento avviene configurando il server MCP di Vurto come fonte di dati nell'assistente compatibile utilizzato — Claude, Cursor o ChatGPT a seconda delle integrazioni supportate. Una volta collegato, l'assistente può recuperare le informazioni rilevanti dai tuoi progetti Vurto (punteggio di visibilità di un brand, ultima analisi di una categoria, concorrenti identificati su un prompt) nel momento in cui ne hai bisogno, nel flusso del tuo lavoro, anziché cambiando strumento.
Casi d'uso concreti
L'automazione dei report è il caso d'uso più diretto: un'estrazione periodica dei punteggi di visibilità tramite API per alimentare un report interno o un punto cliente ricorrente, senza dover esportare manualmente i dati ogni settimana. Per un'agenzia che segue più progetti clienti, questo permette di costruire un reporting consolidato su misura, con una propria formattazione, anziché attenersi al formato della dashboard agenzia. Il server MCP, invece, serve maggiormente a un uso puntuale ed esplorativo: interrogare lo stato della propria visibilità durante il lavoro, senza interrompere una sessione in un altro strumento.
Un esempio concreto di automazione
Immagina un team marketing che produce un punto interno ogni lunedì mattina sulla visibilità IA di tre brand monitorati. Senza API, questo presuppone aprire Vurto, navigare in ogni dashboard, esportare o ricopiare i numeri a mano in una presentazione. Con l'API REST, uno script pianificato il lunedì alle 8 può recuperare automaticamente il punteggio di visibilità medio, la sua ripartizione per motore e i principali concorrenti di ogni brand, e alimentare direttamente il documento di reporting usato in riunione. Il guadagno non è solo il tempo risparmiato: è anche la certezza che il numero presentato corrisponda davvero all'ultima ondata di analisi, senza scarti dovuti a un'esportazione dimenticata.
Prima di iniziare
L'API e il server MCP richiedono un piano Business o superiore — non sono disponibili sui piani Standard e Pro. Se il tuo utilizzo principale resta la consultazione occasionale delle dashboard, l'accesso web è più che sufficiente; l'interesse dell'API e dell'MCP cresce con la frequenza con cui hai bisogno di report automatizzati o con il numero di progetti da consolidare, il che ne fa uno strumento particolarmente rilevante in modalità agenzia. Vedi la pagina piani e crediti per i dettagli sull'idoneità. Una volta attivata l'automazione, si integra naturalmente in un workflow settimanale di monitoraggio GEO, sostituendo le esportazioni manuali con un recupero automatico degli indicatori monitorati nelle tue dashboard.
Gestire gli accessi
Come per qualsiasi accesso programmatico a dati di monitoraggio, limita la diffusione delle credenziali API alle persone che ne hanno realmente bisogno, e revoca l'accesso non appena un progetto di integrazione termina. Questo vale in particolare in modalità agenzia, dove più clienti e collaboratori possono essere coinvolti negli stessi dati esposti tramite l'API.