Server MCP SEO per agenti IA
Dai a Claude Code, Cursor, Zed o a qualsiasi agente Model Context Protocol lo stesso audit da 91 regole che alimenta la dashboard di MetricSpot. Sei strumenti, un solo endpoint HTTP, zero codice di collegamento.
Senza carta. Risultati in 30 secondi.
Oppure incolla un URL: lo stesso audit, senza installare nulla.
Aggiornato
Installa il server MCP SEO nel tuo agente
Il server MCP di MetricSpot è attivo su https://mcp.metricspot.com tramite Streamable HTTP, e su npm come @metricspot/mcp-server per stdio locale. La maggior parte degli agenti richiede una sola riga di configurazione. Lo strumento di audit anonimo funziona senza chiave (1 audit per IP ogni 24 ore); gli altri 5 strumenti accettano un Bearer token generato dalla tua dashboard MetricSpot.
Claude Code
CLI ufficiale di Anthropic. Riavvia la sessione dopo averlo aggiunto.
claude mcp add metricspot --transport http https://mcp.metricspot.com/mcp Cursor
Aggiungi a ~/.cursor/mcp.json, poi ricarica Cursor.
{
"mcpServers": {
"metricspot": {
"url": "https://mcp.metricspot.com/mcp"
}
}
} Zed
Aggiungi a ~/.config/zed/settings.json.
{
"context_servers": {
"metricspot": {
"command": {
"url": "https://mcp.metricspot.com/mcp"
}
}
}
} Claude Desktop
Aggiungi a ~/Library/Application Support/Claude/claude_desktop_config.json su macOS, poi riavvia Claude Desktop.
{
"mcpServers": {
"metricspot": {
"url": "https://mcp.metricspot.com/mcp"
}
}
} ChatGPT
I connettori MCP personalizzati richiedono un piano ChatGPT Pro, Team o Enterprise. Aggiungilo in Impostazioni, Connettori.
{
"name": "MetricSpot",
"url": "https://mcp.metricspot.com/mcp",
"headers": {
"Authorization": "Bearer ms_live_xxx"
}
} Gemini
Usa la configurazione MCP del CLI Gemini. Richiede una versione del CLI Gemini che supporti i server MCP remoti.
gemini mcp add metricspot --transport http https://mcp.metricspot.com/mcp Sei strumenti esposti dal server MCP
Ogni strumento usa lo stesso motore di audit di app.metricspot.com. Nessuna lacuna funzionale, nessun dato di seconda fascia. Descrizioni, input e output sono validati tramite schemi Zod, così gli agenti ricevono risposte strette e prevedibili.
run_audit_anonymous Senza chiave API Lancia un audit SEO e di leggibilità per IA una tantum su qualsiasi URL pubblico. Restituisce punteggi su 11 moduli e circa 90 controlli, oltre a finding azionabili con link alla documentazione. Limitato a 1 audit per IP ogni 24 ore.
- Input:
- url
- Output:
- Busta di audit completa con punteggi per modulo, finding e URL del report.
run_audit Chiave API richiesta Mette in coda un audit SEO e di leggibilità per IA completo. Include Core Web Vitals da Google PSI e traffico organico se Google Search Console è collegato. Risponde subito con status: queued e un audit_id.
- Input:
- url
- Output:
- Busta di audit con audit_id, status e suggerimento di polling.
get_audit Chiave API richiesta Recupera tramite id un audit già eseguito. Restituisce i punteggi per modulo (0-100), il punteggio totale, ogni finding con severità e testo di raccomandazione, oltre ai link ai report HTML e PDF.
- Input:
- audit_id
- Output:
- Busta di audit con status, total_score, module_scores, findings.
list_audits Chiave API richiesta Elenca gli audit dell'utente, dai più recenti, deduplicati per URL. Restituisce audit_id, url, status, total_score e created_at. Limite predefinito 24, massimo 100.
- Input:
- limit (opzionale)
- Output:
- Array di riepiloghi di audit.
get_audit_pdf Chiave API richiesta Restituisce un URL firmato per scaricare il report PDF brandizzato. Se non è stato ancora generato alcun PDF, mette in coda il rendering e restituisce status: queued così l'agente può richiamare lo stesso strumento.
- Input:
- audit_id
- Output:
- URL firmato del PDF o stato queued.
get_organic_traffic Chiave API richiesta Restituisce lo snapshot a 28 giorni del traffico organico per un audit se l'utente ha collegato GA4 e Google Search Console. Include sessioni, trend giornaliero, principali landing page, principali query e salute dell'indicizzazione.
- Input:
- audit_id
- Output:
- Snapshot di traffico organico o stato not-linked.
Perché usare un server MCP invece di un'API REST o di un audit manuale
MCP è pensato per gli agenti IA: descrizioni degli strumenti, schemi tipizzati e autenticazione viaggiano insieme alla connessione. L'agente può pianificare un audit multi-step (lanciare, fare polling, riassumere, generare PDF, approfondire i finding) senza che tu scriva codice di collegamento.
| Funzione | Audit SEO manuale | Altre API SEO | MCP di MetricSpot |
|---|---|---|---|
| Tempo di setup | Ore per sito, da ripetere a ogni esecuzione | Ore: leggere i docs, scrivere il client, gestire l'auth, parsare il JSON | Una riga di configurazione nel tuo client MCP |
| Nativo per agenti | No: umano nel loop a ogni passo | Parziale: gli agenti possono chiamare REST, ma servono wrapper scritti a mano | Sì: descrizioni, schemi e rate limit viaggiano con la connessione |
| Controlli di leggibilità per IA | Raro: la maggior parte dei template precede llms.txt e gli AI Overviews | Limitato: la maggior parte delle API si concentra su backlink e keyword | 11 regole dedicate all'IA, valutate accanto al SEO classico |
| PDF white-label | Export manuale, rebrand manuale | Di solito non offerto, o solo nel piano più caro | get_audit_pdf restituisce un PDF brandizzato in ogni piano a pagamento |
| Prova anonima | Non applicabile | Quasi mai disponibile senza account a pagamento | run_audit_anonymous funziona senza chiave, 1 per IP ogni 24 ore |
| Modello di prezzo | Fatturazione a ore | Misurazione per chiamata, spesso per keyword o per dominio | Piani mensili fissi, allineati alla dashboard |
Prezzi del server MCP
Il server MCP è incluso in ogni piano a pagamento di MetricSpot: stessi crediti di audit, stessi moduli, stesso rendering PDF. Lo strumento di audit anonimo è gratuito e funziona senza account. Gli strumenti autenticati pesano sulla stessa quota mensile di audit che vedi nella tua dashboard.
Free
$0/mo
Prova la piattaforma. Senza carta, senza impegno.
- ·10 audit al mese (1 per sito ogni 24h)
- ·Tutti e dieci i moduli di punteggio
- ·Download PDF con il nostro brand
- ·Report multilingua
Starter
$29/mo
Per freelance con report mensili.
- ·Fino a 5 domini monitorati
- ·50 audit al mese
- ·Report PDF completamente white-label
- ·Brand kit personalizzato (logo, colore, footer)
Pro
$49/mo
Per agenzie, freelance e rivenditori.
- ·Tutto incluso in Starter
- ·Re-audit pianificati (settimanale, quindicinale o mensile)
- ·Domini monitorati illimitati
- ·Invio diretto dei report al cliente via email
Quali agenti IA possono usare questo server MCP
Qualsiasi client compatibile con MCP può connettersi tramite Streamable HTTP, oppure eseguire il server in locale come sottoprocesso stdio tramite il pacchetto npm @metricspot/mcp-server. Sotto trovi gli agenti su cui testiamo oggi.
- •Claude Code: CLI ufficiale di Anthropic per Claude, con supporto MCP di prima classe.
- •Cursor: l'editor di codice AI-first. Aggiungilo in ~/.cursor/mcp.json.
- •Zed: l'editor ad alte prestazioni. Aggiungilo in ~/.config/zed/settings.json.
- •Claude Desktop: l'app per macOS e Windows, configurata tramite claude_desktop_config.json.
- •ChatGPT (Pro, Team, Enterprise): connettori MCP personalizzati in Impostazioni, Connettori.
- •Gemini CLI: tramite la configurazione MCP del CLI Gemini.
Far girare MetricSpot da un agente è metà della storia della scoperta tramite IA. L'altra metà è rendere il tuo sito leggibile da ChatGPT, Perplexity e Google AI Overviews: dai un'occhiata ai nostri controlli di visibilità nella ricerca IA per le 11 regole che MetricSpot esegue su ogni pagina.
Domande frequenti
Cos'è MCP e perché uno strumento SEO ne ha bisogno?
Model Context Protocol è uno standard aperto di Anthropic per collegare gli agenti IA a strumenti esterni. Invece di chiedere al tuo agente di fare scraping dell'interfaccia di MetricSpot o di scrivere a mano un client REST, gli dai l'URL del nostro server MCP e lui scopre automaticamente ogni strumento, schema e requisito di autenticazione. Per il lavoro SEO, questo significa che un agente può auditare un sito, riassumere i finding, recuperare un PDF e approfondire le singole regole in un'unica conversazione.
Ho bisogno di una chiave API per usare il server MCP?
Solo per 5 dei 6 strumenti. Lo strumento run_audit_anonymous funziona senza alcuna chiave, con un limite di 1 audit per IP ogni 24 ore: abbastanza per provare il server da capo a fondo. Gli altri strumenti (run_audit, get_audit, list_audits, get_audit_pdf, get_organic_traffic) richiedono un Bearer token. Richiedilo dalla tua dashboard MetricSpot dopo esserti iscritto a un qualsiasi piano, incluso quello Free.
Quali client MCP sono supportati?
Qualsiasi client che parli MCP via Streamable HTTP. Testiamo con Claude Code, Cursor, Zed, Claude Desktop, ChatGPT (Pro, Team, Enterprise) e il CLI Gemini. Il protocollo è aperto, quindi anche altri client dovrebbero funzionare: se il tuo non va, apri una issue.
Quali trasporti supporta il server?
Entrambi i trasporti sono attivi oggi. Streamable HTTP su https://mcp.metricspot.com/mcp è la via più semplice: una riga di configurazione, niente da installare. Per gli agenti che preferiscono eseguire il server come sottoprocesso locale, installa il pacchetto npm @metricspot/mcp-server e punta il tuo client a `npx -y @metricspot/mcp-server`.
Quali sono i rate limit?
Lo strumento anonimo è limitato a 1 audit per IP ogni 24 ore. Gli strumenti autenticati pesano sulla quota mensile di audit del tuo piano: lo stesso numero che vedi nella pagina dei prezzi. Non c'è una quota MCP separata né un sovrapprezzo per chiamata.
Qual è la differenza tra audit anonimi e autenticati?
Stesso motore di audit, stesse 91 regole, stessi 11 moduli di punteggio. Gli audit autenticati aggiungono i Core Web Vitals (tramite Google PageSpeed Insights), i dati di traffico organico se hai collegato Google Search Console, le riesecuzioni programmate e l'accesso al report PDF brandizzato. Gli audit anonimi sono pensati per controlli rapidi e demo.
Posso eseguirlo in CI o in un job pianificato?
Sì. L'endpoint Streamable HTTP è stateless dal punto di vista dell'agente: puoi chiamarlo da qualsiasi runner CI, scheduler o funzione serverless che parli MCP. Usa run_audit per mettere in coda, poi fai polling con get_audit finché lo status non è complete. Abbinalo a get_audit_pdf se vuoi inviare via email un report brandizzato dopo ogni esecuzione.
Dove segnalo bug o chiedo nuovi strumenti?
Apri una issue su github.com/MetricSpot/mcp-server (preferito) oppure scrivi a info@metricspot.com . Le richieste di strumenti da parte di agenti in produzione vengono prioritizzate. Il server MCP è open source con licenza MIT.
Basta scrivere report SEO a mano.
Lancia un audit, applica il tuo brand al PDF, invialo al cliente. In cinque minuti.
Avvia il tuo primo audit