Il server MCP di Ranktracker è ora attivo

Introduzione

Il server MCP di Ranktracker è ufficialmente attivo.

Ora puoi collegare direttamente al tuo account Ranktracker gli assistenti AI e gli strumenti di sviluppo supportati, tra cui ChatGPT, Claude, Cursor e altri client che supportano il Model Context Protocol.

Una volta effettuata la connessione, potrai porre domande sulle tue prestazioni SEO utilizzando il linguaggio naturale.

Ad esempio:

• Quali delle mie parole chiave monitorate hanno registrato il calo maggiore questa settimana?
• Mostrami le parole chiave attualmente posizionate tra l’11ª e la 20ª posizione.
• Quali parole chiave hanno guadagnato visibilità negli ultimi 30 giorni?
• Riassumi l'andamento dei backlink per il mio sito web.
• Quali problemi tecnici sono stati rilevati nell’ultimo audit del mio sito web?
• Quali delle mie parole chiave monitorate compaiono nella panoramica AI?
• Mostrami i backlink individuati più di recente.
• Qual è lo stato del mio ultimo rapporto SEO?

L'assistente AI seleziona lo strumento Ranktracker appropriato, recupera in modo sicuro i dati dell'account pertinenti e li utilizza per rispondere alla tua domanda.

Non è necessario esportare manualmente un file CSV, passare da un report all’altro o creare un’integrazione personalizzata prima di poter iniziare ad analizzare i propri dati.

L’accesso a MCP è incluso in tutti i piani di Ranktracker.

Leggi la documentazione completa all'indirizzo:

https://developers.ranktracker.com/mcp

Che cos'è il Model Context Protocol?

Il Model Context Protocol, comunemente noto come MCP, fornisce un metodo standard che consente alle applicazioni di intelligenza artificiale di connettersi a strumenti esterni e fonti di dati.

Normalmente, un modello di IA ha accesso solo alle informazioni contenute nella propria conversazione e alle conoscenze generali a sua disposizione. Non è in grado di visualizzare automaticamente i progetti, le parole chiave, i report o gli audit presenti nel tuo account Ranktracker.

Una connessione MCP cambia questa situazione.

Una volta autorizzato Ranktracker, il client di IA può individuare una raccolta definita di strumenti Ranktracker. Quando si pone una domanda pertinente, il client può scegliere lo strumento corretto, fornire gli identificatori dell’account richiesti e recuperare i dati necessari per rispondere.

Invece di navigare manualmente tra le diverse sezioni di Ranktracker, puoi porre la domanda in modo colloquiale.

Ad esempio, quando chiedi:

Quali parole chiave di example.com hanno perso più posizioni questo mese?

L'assistente può:

1. Trova il dominio monitorato pertinente.
2. Recupera le sue parole chiave monitorate.
3. Esamina la cronologia del posizionamento.
4. Confronta le posizioni attuali con quelle precedenti.
5. Riassumi le perdite più significative.

Il server MCP di Ranktracker gestisce la connessione tra l’assistente AI e il tuo account.

Collega Ranktracker a ChatGPT, Claude e Cursor

Il server MCP di Ranktracker è un server remoto ospitato che funziona con client che supportano connessioni MCP HTTP Streamable.

Può essere collegato a:

• ChatGPT
• Claude Desktop
• Claude Code
• Cursor
• MCP Inspector
• Altri client MCP compatibili
• Agenti IA interni e strumenti per sviluppatori

Il server è disponibile tramite un endpoint ospitato:

https://api.ranktracker.com/mcp

Non è necessario scaricare o ospitare un server Ranktracker separato.

Per la maggior parte degli strumenti di IA interattivi, OAuth è il metodo di connessione consigliato. È sufficiente aggiungere l’URL del server Ranktracker al client, autorizzare l’accesso tramite il browser e la connessione verrà creata automaticamente.

Non è richiesto alcun codice personalizzato

Uno dei maggiori vantaggi di MCP è che non è necessario realizzare l’integrazione autonomamente.

Con un'integrazione API tradizionale, uno sviluppatore di solito deve:

• Leggi la documentazione dell'API
• Crea richieste per singoli endpoint
• Gestisci l'autenticazione
• Elabora la risposta
• Memorizza o visualizza i dati
• Crea un'interfaccia per l'utente

Il server MCP di Ranktracker presenta strumenti chiaramente definiti direttamente al client di IA.

L'assistente individua automaticamente tali strumenti e decide quali utilizzare in base alla richiesta dell'utente.

Ciò significa che un utente può collegarsi a Ranktracker e iniziare a porre domande senza scrivere codice o creare un'applicazione di reporting separata.

Gli sviluppatori possono comunque utilizzare l’API REST di Ranktracker per sistemi completamente automatizzati, flussi di dati programmati e applicazioni personalizzate. L’MCP è progettato per i casi in cui una persona o un agente di IA sta esplorando attivamente i dati.

A quali dati di Ranktracker possono accedere gli assistenti IA?

La versione iniziale di Ranktracker MCP offre 14 strumenti.

Tredici strumenti sono di sola lettura. Un ulteriore strumento è in grado di generare in modo sicuro una nuova esecuzione di un report esistente.

Gli strumenti disponibili coprono siti web monitorati, parole chiave, posizionamenti, concorrenti, ricerca di parole chiave, backlink, report e audit dei siti web.

Domini monitorati

Il tuo assistente può elencare i domini disponibili nel tuo account Ranktracker e recuperare la configurazione di un progetto specifico.

Questo costituisce il punto di partenza per la maggior parte delle conversazioni, poiché le risorse di Ranktracker sono collegate tramite identificatori di progetto univoci.

Ecco alcuni esempi di domande:

• Elenca tutti i siti web nel mio account Ranktracker.
• Trova il mio progetto per example.com.
• Mostrami la configurazione di monitoraggio per questo dominio.
• Quali limiti di monitoraggio sono configurati per questo progetto?

L'assistente può visualizzare solo i domini appartenenti all'account Ranktracker che lo ha autorizzato.

Parole chiave monitorate e posizionamenti attuali

Il tuo assistente può recuperare le parole chiave monitorate per un dominio insieme ai loro ultimi risultati di posizionamento.

Ciò consente di chiedere:

• Quali sono le mie parole chiave con il posizionamento più alto?
• Quali parole chiave sono attualmente posizionate nella prima pagina?
• Mostrami le parole chiave che si posizionano tra l'11ª e la 20ª posizione.
• Quali parole chiave monitorate non rientrano nella Top 100?
• Quali parole chiave sono attualmente in pausa?
• Mostrami le prime 50 parole chiave per questo dominio.

I dati relativi alle parole chiave sono ordinati per impostazione predefinita in base alla migliore posizione organica, consentendo all’assistente di identificare rapidamente i posizionamenti attuali più forti.

Andamento storico dei posizionamenti

Il server MCP può recuperare la cronologia giornaliera dei posizionamenti per una singola parola chiave monitorata.

Ciò include:

• Posizione organica
• Posizione assoluta nella SERP
• Posizione nel local pack
• Possesso delle funzionalità SERP
• Visibilità nella panoramica AI
• Cronologia del posizionamento in un intervallo di date selezionato

L'intervallo di date predefinito copre il mese precedente, ma il cliente può richiedere date di inizio e fine specifiche.

È possibile porre domande del tipo:

• Come si è comportata questa parola chiave negli ultimi 30 giorni?
• Quando questa parola chiave è entrata nella Top 10?
• Abbiamo perso il nostro featured snippet?
• La nostra posizione nel local pack è migliorata?
• Questo dominio è incluso nell'attuale panoramica AI?
• Qual è stata la posizione migliore della parola chiave questo mese?

Ciò semplifica l’analisi delle variazioni di posizionamento senza dover aprire e confrontare manualmente i singoli grafici.

Dati sulla concorrenza

L'assistente può elencare i siti web della concorrenza configurati per un dominio monitorato.

Ecco alcuni esempi di domande:

• Quali concorrenti vengono monitorati per questo progetto?
• Elenca i concorrenti associati a example.com.
• Stiamo monitorando competitor.com?
• Riassumi il panorama competitivo di questo sito web.

Il server MCP recupera solo i concorrenti già configurati nell'account Ranktracker. Non aggiunge automaticamente nuovi concorrenti né modifica le impostazioni del progetto.

Ricerca con Keyword Finder

L'assistente può recuperare le sessioni di ricerca esistenti di Keyword Finder dal tuo account.

Ciò ti consente di individuare e discutere le ricerche già completate.

Potresti chiedere:

• Mostra le mie ultime sessioni di ricerca per parole chiave.
• Quali progetti di ricerca per parole chiave sono disponibili?
• Trova la sessione di ricerca creata per la nostra nuova categoria di prodotti.
• Riassumi la ricerca per parole chiave disponibile nel mio account.

La connessione MCP non avvia nuove ricerche a pagamento sulle parole chiave. Si limita a leggere le sessioni di ricerca esistenti, contribuendo a impedire che un client AI consumi le quote a tua insaputa.

Monitoraggio dei backlink

Gli strumenti MCP di Ranktracker possono recuperare informazioni sui backlink per un dominio monitorato.

I dati disponibili sui backlink includono:

• URL di origine
• URL di destinazione
• Testo di ancoraggio
• Stato dofollow
• Punteggio spam
• Classifiche del dominio e della pagina
• Data della prima visualizzazione
• Data dell'ultimo avvistamento

Ciò significa che puoi chiedere:

• Mostrami gli ultimi backlink individuati per il mio sito web.
• Quali nuovi backlink sono dofollow?
• Ci sono link sospetti con punteggi di spam elevati?
• Quali pagine hanno ricevuto i link più recenti?
• Qual è il testo di ancoraggio utilizzato più frequentemente?
• Mostra i backlink più forti individuati di recente.

I backlink vengono visualizzati a partire dai più recenti, rendendo la connessione particolarmente utile per esaminare le recenti attività di link building.

Andamento del profilo dei backlink

Oltre ai singoli link, l’assistente è in grado di recuperare riepiloghi storici del profilo dei backlink.

Questi riepiloghi possono includere:

• Classifica del dominio
• Backlink totali
• Nuovi backlink
• Backlink persi
• Domini di provenienza
• Istantanee storiche del profilo

Esempi di domande includono:

• Riassumi la crescita dei nostri backlink di questo mese.
• Abbiamo guadagnato o perso domini di riferimento?
• Quando si è verificato il calo più significativo dei backlink?
• Il nostro profilo complessivo di backlink è in crescita?
• Confronta l'istantanea più recente dei backlink con quella precedente.

Ciò consente all'assistente AI di spiegare l'andamento anziché limitarsi a fornire un semplice elenco di link.

Riepiloghi di monitoraggio

L'assistente è in grado di recuperare un riepilogo di monitoraggio combinato per un dominio che copre aree quali:

• Monitoraggio delle parole chiave
• Monitoraggio dei backlink
• Monitoraggio dell'audit del sito web

Questo può essere utilizzato per richiedere una panoramica concisa di un sito web senza dover controllare singolarmente ogni strumento di Ranktracker.

Ad esempio:

Forniscimi un riepilogo di monitoraggio SEO per example.com.

Il cliente può recuperare i dati di monitoraggio disponibili e trasformarli in un elenco chiaro di modifiche, rischi e aree che richiedono attenzione.

Report SEO

Il tuo assistente può elencare i report già configurati nel tuo account Ranktracker.

Può inoltre recuperare informazioni su un report specifico, tra cui:

• Pianificazione dei report
• Destinatari
• Ultima esecuzione
• Cronologia delle esecuzioni recenti
• Stato attuale del report
• URL del file del report completato

Puoi chiedere:

• Elenca i miei report SEO configurati.
• Quando è stato generato l'ultimo rapporto per il cliente?
• Il report di questa settimana è stato completato con successo?
• Mostrami l'ultimo rapporto disponibile.
• Quali destinatari sono configurati per questo report?
• Qual è la pianificazione attuale del report?

Ciò può risultare particolarmente utile per le agenzie che gestiscono più report ricorrenti per i propri clienti.

Esegui un report esistente

Il server MCP include un'azione di scrittura attentamente controllata: run_report.

Ciò consente a un assistente AI di generare una nuova esecuzione di un report che avete già configurato in Ranktracker.

L'azione è volutamente limitata.

Essa:

• Non crea un nuovo rapporto
• Non invia il report via e-mail ai destinatari
• Non acquista dati aggiuntivi
• Non aggiunge parole chiave
• Non modifica i progetti monitorati
• Non consuma crediti per il monitoraggio delle parole chiave
• Non è possibile eseguire ripetutamente lo stesso report all'interno di un unico periodo di rendicontazione

Il report generato appare all'interno di Ranktracker e lo strumento può restituirne lo stato e il file al termine dell'esecuzione.

Ciò offre agli utenti un'azione utile senza consentire a un cliente AI di apportare modifiche estese o costose all'account.

Audit dei siti web

L'assistente è in grado di elencare gli audit del sito web associati a un dominio e di recuperare i risultati di un audit specifico.

Le informazioni disponibili sull’audit includono:

• Stato dell'audit
• Avanzamento della scansione
• Statistiche di scansione
• Punteggi di audit
• Avvisi
• Controlli SEO tecnici
• Stato SSL
• Stato HTTP/2
• Controlli della Sitemap
• Controlli del file robots.txt
• Informazioni sull'indicizzazione

Potresti chiedere:

• Quali sono stati i principali problemi riscontrati nell'ultimo audit del nostro sito web?
• L'audit ha individuato eventuali problemi di indicizzazione?
• Il sito web utilizza HTTP/2?
• Sono stati riscontrati problemi relativi alla Sitemap o al file robots.txt?
• Riassumi gli avvisi tecnici con la massima priorità.
• L'ultimo audit è stato completato?
• Confronta il numero di avvisi con quello dell'audit precedente.

Ciò offre ai team SEO un modo più rapido per comprendere i risultati degli audit tecnici e trasformarli in azioni prioritarie.

Porre domande su diversi strumenti di Ranktracker

Il vero valore di un'integrazione con l'intelligenza artificiale non si limita al recupero di un campo alla volta.

Un assistente può richiamare diversi strumenti durante la stessa conversazione e combinare i risultati in una risposta più completa.

Ad esempio, potresti chiedere:

Prepara un riepilogo SEO settimanale per example.com.

A seconda della richiesta e delle informazioni disponibili, l’assistente potrebbe esaminare:

• Posizioni attuali delle parole chiave
• Movimenti recenti nel posizionamento
• Visibilità della panoramica AI
• Backlink nuovi e persi
• Andamento del profilo dei backlink
• Stato più recente dell'audit del sito web
• Concorrenti configurati
• Disponibilità dei report

Può quindi presentare i risultati sotto forma di riepilogo gestionale, aggiornamento per il cliente, elenco di priorità o piano d’azione tecnico.

È possibile proseguire la conversazione con domande di approfondimento quali:

• Quale calo di posizionamento dovremmo analizzare per primo?
• Mostrami le parole chiave correlate.
• Trasforma questo in un riepilogo di facile comprensione per il cliente.
• Distinguere i risultati immediati dalle problematiche a lungo termine.
• Quale avviso tecnico potrebbe avere il maggiore impatto sul SEO?

Invece di esportare e riformattare ripetutamente i dati, l'analisi può avvenire direttamente all'interno della conversazione.

Come collegare Ranktracker con OAuth

OAuth è l'opzione consigliata per ChatGPT, Claude, Cursor e altri client interattivi.

La procedura di configurazione generale è la seguente:

1. Apri le impostazioni MCP o del connettore nel tuo client AI.
2. Aggiungi l'endpoint MCP di Ranktracker: https://api.ranktracker.com/mcp
3. Lascia vuoto il campo dell'autenticazione manuale.
4. Consenti al client di individuare il flusso OAuth di Ranktracker.
5. Accedi a Ranktracker nella finestra del browser.
6. Controlla le autorizzazioni richieste.
7. Approva la connessione.
8. Torna al client AI e verifica che gli strumenti di Ranktracker siano disponibili.

Solo un amministratore dell’account Ranktracker può approvare una connessione, poiché il client collegato può accedere ai dati dell’intero account autorizzato.

Collegamento di ChatGPT

In ChatGPT:

1. Apri Impostazioni.
2. Apri " Connettori".
3. Seleziona " Aggiungi connettore personalizzato".
4. Incolla l'URL del server MCP di Ranktracker.
5. Completa la procedura di autorizzazione del browser.

Non è richiesta alcuna intestazione di autenticazione manuale quando si utilizza OAuth.

Collegamento a Claude Code

Gli utenti di Claude Code possono aggiungere Ranktracker tramite:

La schermata di consenso del browser si apre quando è richiesta l'autenticazione.

Collegamento a Claude Desktop o Cursor

Claude Desktop e Cursor possono utilizzare la seguente configurazione del server:

Dopo aver salvato la configurazione, connettersi al server e autorizzare l'accesso tramite la schermata di consenso del browser di Ranktracker.

La posizione esatta del file di configurazione dipende dal client. Le istruzioni complete specifiche per ciascun client sono disponibili nella documentazione di Ranktracker MCP.

Autorizzazioni MCP e sicurezza dell’account

La schermata di consenso OAuth mostra quale applicazione sta richiedendo l’accesso, quale account Ranktracker verrà collegato e quali autorizzazioni vengono richieste.

Gli ambiti di autorizzazione disponibili sono:

• mcp:read — legge progetti, parole chiave, posizionamenti, concorrenti, backlink, audit e report
• mcp:write — genera una nuova esecuzione di un report esistente

I token di accesso OAuth hanno una durata di un'ora e vengono aggiornati automaticamente dal client collegato. La connessione rimane attiva fino a quando non viene revocata.

Il client può accedere solo alle informazioni appartenenti all’account Ranktracker che ha approvato la connessione.

La maggior parte delle azioni MCP disponibili sono di sola lettura. Le azioni che potrebbero consumare crediti a pagamento o apportare modifiche significative al tracciamento sono state deliberatamente escluse.

Un client AI non può utilizzare il server MCP per:

• Aggiungi nuovi domini monitorati
• Aggiungi o rimuovi parole chiave
• Acquista dati aggiuntivi
• Avvia una nuova ricerca con Keyword Finder
• Aggiorna le classifiche delle parole chiave
• Modifica le frequenze di monitoraggio
• Elimina i progetti
• Modifica i concorrenti
• Invia i report via e-mail ai destinatari

Queste restrizioni consentono agli utenti di analizzare le proprie informazioni SEO senza concedere a un assistente IA il controllo illimitato sul proprio account Ranktracker.

OAuth o token MCP?

La maggior parte degli utenti dovrebbe connettersi tramite OAuth.

OAuth non richiede di copiare, salvare o incollare un token permanente. Il client IA apre Ranktracker nel browser, richiede l’approvazione e gestisce automaticamente le credenziali di accesso temporanee.

È disponibile anche un token MCP dedicato per:

• Pipeline CI
• Script
• Agenti interni
• Ambienti automatizzati
• Clienti che non supportano OAuth

I token MCP iniziano con:

tkn_mcp_usr_...

Sono distinti dalle normali chiavi API REST di Ranktracker e funzionano solo con l'endpoint MCP.

Una chiave API REST che inizia con tkn_usr_... non funzionerà come credenziale MCP. Allo stesso modo, un token MCP non può essere utilizzato con gli endpoint dell'API REST di Ranktracker.

Mantenere separate le credenziali significa che un token MCP può essere revocato senza influire sulle integrazioni API esistenti di un'organizzazione.

Ranktracker MCP rispetto all’API REST di Ranktracker

Il server MCP e l’API REST si collegano agli stessi dati dell’account Ranktracker, ma sono progettati per flussi di lavoro diversi.

Ranktracker MCP	API REST di Ranktracker
Progettato per assistenti e agenti basati sull'intelligenza artificiale	Progettato per applicazioni e sistemi di backend
Supporta l'esplorazione dei dati conversazionali	Utilizza endpoint programmatici fissi
L'IA seleziona lo strumento appropriato	Uno sviluppatore seleziona e chiama ciascun endpoint
Principalmente in sola lettura	Supporta operazioni più ampie di creazione, lettura, aggiornamento ed eliminazione
Ideale quando una persona o un agente pone delle domande	Ideale per il trasferimento dei dati pianificato e automatizzato
Utilizza OAuth o un token MCP dedicato	Utilizza una chiave API REST

Utilizza l’MCP quando desideri esplorare, spiegare o riassumere i tuoi dati SEO attraverso una conversazione basata sull’intelligenza artificiale.

Utilizza l’API REST quando devi creare una dashboard, gestire un data warehouse, sincronizzare sistemi o eseguire un’integrazione pianificata.

Molti team utilizzeranno entrambi: l’MCP per l’analisi conversazionale e l’API REST per l’automazione strutturata.

Progettato per gestire account SEO di grandi dimensioni

Le tabelle delle parole chiave e dei backlink possono contenere una quantità significativa di dati.

Per impostazione predefinita, Ranktracker MCP restituisce dati JSON strutturati e leggibili. Per insiemi di risultati più grandi, gli utenti possono abilitare il formato di risposta TOON opzionale aggiungendo:

?format=toon

all'endpoint MCP.

TOON restituisce le stesse informazioni di base in un formato tabellare più compatto. Secondo la documentazione di Ranktracker, ciò può ridurre l’utilizzo dei token di circa il 40%–60% per set di dati di grandi dimensioni.

L'endpoint standard è:

https://api.ranktracker.com/mcp

L'endpoint ottimizzato per i token è:

https://api.ranktracker.com/mcp?format=toon

La maggior parte degli utenti può mantenere la connessione sul formato JSON standard. L’opzione compatta è utile soprattutto per set di dati più grandi relativi a parole chiave e backlink.

Limiti di frequenza

L'endpoint MCP di Ranktracker ha limiti distinti rispetto all'API REST:

• 200 richieste al minuto per ogni credenziale MCP
• 300 richieste al minuto per ogni indirizzo IP

Le richieste che superano il limite restituiscono una risposta HTTP 429 e devono essere riprovate dopo un certo intervallo di tempo.

Questi limiti sono sufficienti per le normali interazioni e contribuiscono a proteggere gli account e l’infrastruttura da un numero eccessivo di richieste automatizzate.

L'accesso a MCP è incluso in ogni piano Ranktracker

Il server MCP di Ranktracker è disponibile in tutti i piani di abbonamento a Ranktracker.

Ciò significa che i clienti dei piani Launch, Growth, Scale e Authority possono collegare i client AI supportati ai dati presenti nel proprio account.

La quantità di dati disponibili dipenderà dai progetti, dalle parole chiave, dai backlink, dagli audit e dai report già disponibili nell’ambito dell’abbonamento esistente dell’account e delle relative quote.

Non è richiesto alcun abbonamento MCP separato per iniziare a collegare il proprio account Ranktracker a un client AI supportato.

Inizia a utilizzare Ranktracker con il tuo assistente AI

Il server MCP di Ranktracker offre un nuovo modo di lavorare con i dati SEO.

Invece di passare da una schermata all’altra, scaricare fogli di calcolo e preparare manualmente i riepiloghi, puoi collegare il tuo assistente AI e porre domande dirette sul tuo account.

Puoi analizzare:

• Parole chiave monitorate
• Variazioni di posizionamento
• Visibilità della panoramica AI
• Concorrenti
• Ricerca delle parole chiave
• Backlink nuovi e persi
• Tendenze del profilo dei backlink
• Audit del sito web
• Report programmati

La connessione è veloce da configurare, funziona con i principali client MCP ed è progettata con autorizzazioni controllate che impediscono modifiche costose o dannose all’account.

Collega il tuo client IA preferito e consulta le istruzioni complete per la configurazione all'indirizzo:

https://developers.ranktracker.com/mcp