Yandex Metrica MCP Server: traffico e conversioni

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Yandex Metrica, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Yandex Metrica

Fai analizzare alla tua AI la web analytics di Yandex Metrica: contatori, obiettivi, filtri e segmenti, report a tabella, serie temporali, drill-down e confronti su visite, sorgenti, pagine e conversioni, e visite e hit grezzi tramite la Logs API.

Setup

La configurazione richiede circa 5 minuti. Ti servono un account Yandex che possiede i contatori di Metrica o vi ha accesso, e un'app tua registrata su oauth.yandex.com.

1. Crea su oauth.yandex.com un'app del tipo For API access or debugging e assegnale l'accesso metrika:read (statistiche di Metrica, impostazioni dei contatori, elenco dei contatori). Annota il suo ClientID.
2. Con l'account Yandex che possiede o vede i contatori, apri https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID> con il tuo ClientID e copia il token (inizia con y0_) in YANDEX_METRICA_TOKEN, senza OAuth o Bearer davanti.
3. Installa il connettore ed esegui yandex_metrica_list_counters: verifica il token ed elenca gli id dei contatori che servono agli altri tool.

Cloud e self-hosting funzionano allo stesso modo: incolli il token e il connettore lo invia come Authorization: OAuth ... a ogni chiamata. In AnythingMCP non c'è nessuna Redirect URL da impostare.

Il token dura circa un anno: si prolunga finché viene usato. L'accesso in lettura basta per tutto: metrika:read copre i report, le impostazioni dei contatori e le richieste alla Logs API.

Prima contatori e obiettivi: l'id del contatore va in ids nei report e in counterId ovunque altrove. yandex_metrica_list_goals fornisce gli id degli obiettivi, che le metriche degli obiettivi contengono, come ym:s:goal123reaches e ym:s:goal123conversionRate.

Metriche, date e filtri: metriche e dimensioni iniziano con ym:s: per le sessioni (visite) e ym:pv: per le visualizzazioni di pagina, ad esempio ym:s:visits, ym:s:bounceRate o ym:s:lastTrafficSource. Le date accettano YYYY-MM-DD, today, yesterday o 30daysAgo. I filtri usano ==, !=, =@ (contiene) e =~ (regex), combinati con AND e OR; i segmenti salvati di yandex_metrica_list_segments si possono riusare come filtri. Le righe si sfogliano con limit (predefinito 100, al massimo 100.000) e offset, che parte da 1.

Dati campionati: le risposte dei report contengono sampled e sample_share. Quando sampled è true i valori sono stime: su intervalli brevi chiedi la precisione piena (accuracy full), altrimenti usa la Logs API.

Logs API: visite e hit grezzi, non campionati, vengono preparati dal lato di Yandex. L'AI verifica con yandex_metrica_evaluate_log_request se la richiesta si può creare, la crea, attende che lo stato sia processed e scarica ogni parte come testo separato da tabulazioni, con i nomi dei campi nella prima riga. L'intervallo di date non può includere oggi, e i log preparati contano nella quota di archiviazione dei log del contatore.

Limiti: 5.000 richieste al giorno per utente, 200 richieste di report ogni 5 minuti per utente, 3 richieste in parallelo per utente e 30 richieste al secondo per indirizzo IP (10 per la Logs API). Oltre, Yandex risponde 429: aspetta e riprova.

Errori frequenti: 401 vuol dire che il token è sbagliato, scaduto o revocato: ottienine uno nuovo con il ClientID della tua app come al passo 2. 403 vuol dire che il token funziona, ma il suo account non ha accesso a quel contatore oppure all'app manca metrika:read. 400 vuol dire che una metrica, una dimensione o un filtro non è valido, e il messaggio lo indica.

Cosa legge: contatori con sito, mirror, stato, fuso orario, stato del codice, proprietario e il tuo permesso, e le etichette (cartelle) in cui sono ordinati; obiettivi con tipo, condizioni, passi e prezzo; filtri dei dati, operazioni sugli URL, segmenti salvati e chi ha accesso a un contatore; report a tabella, serie temporali, drill-down e confronti su visite, utenti, frequenza di rimbalzo, sorgenti di traffico, pagine, paesi, dispositivi e conversioni degli obiettivi; e visite e hit grezzi, non campionati, dalla Logs API.

Disattivato all'installazione: yandex_metrica_clean_log_request. Cancella i file preparati di una richiesta della Logs API già elaborata per liberare la quota di archiviazione dei log del contatore, e dopo i file non si possono più scaricare. Attivalo nella pagina del connettore solo se ti serve; l'AI ti chiede conferma prima di ogni modifica. yandex_metrica_create_log_request e yandex_metrica_cancel_log_request sono attivi: avviano o fermano solo la preparazione di un'esportazione di dati grezzi dal lato di Yandex e non modificano contatori, obiettivi o impostazioni.

Non incluso: creare o modificare contatori, obiettivi, filtri e accessi, e caricare conversioni offline, chiamate, spese, parametri utente o dati CRM.

Prerequisiti: YANDEX_METRICA_TOKEN

Installazione locale del connettore

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Apri http://localhost:3000/connectors/store, scegli Yandex Metrica e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali sorgenti di traffico hanno portato più visite il mese scorso, e con quale frequenza di rimbalzo?"
• "Com'è cambiato settimana per settimana negli ultimi tre mesi il tasso di conversione del mio obiettivo ordine?"
• "Confronta visite e obiettivi raggiunti per sorgente di traffico tra ottobre e settembre."
• "Quali pagine hanno avuto più visualizzazioni ieri, e su quali dispositivi?"
• "Prendi le visite grezze, non campionate, della settimana scorsa tramite la Logs API e contale per regione."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT