seomcp

Open source · Gratuito · In italiano

Search Console e Bing Webmaster, dentro Claude e ChatGPT.

Un server MCP che permette al tuo assistente AI di leggere i dati dei tuoi siti. Fai domande in italiano e ottieni analisi sui dati veri. Le credenziali restano sul tuo computer.

Funziona con Claude, ChatGPT, GitHub Copilot, Gemini CLI e Mistral Vibe · Licenza MIT · Node.js 22+

Claude
Quali query di esempio.it sono in posizione 4-20 negli ultimi 90 giorni? Dammi le 3 con più potenziale.

gsc_striking_distance · 90 giorni

QueryPos.Impr.
scarpe trekking donna6,28.410
scarponi impermeabili11,85.120
zaino 30 litri4,93.760

La prima è la più vicina: la pagina è già sesta. Aggiungerei una sezione sulle taglie e una FAQ…

Esempio illustrativo con dati di fantasia.

Perché fidarsi

Affidare le credenziali di Search Console a uno strumento è una decisione seria. Per questo seomcp è fatto per essere verificato, non solo usato.

Sola lettura

Chiede a Google solo lo scope webmasters.readonly: non può modificare nulla nelle tue proprietà.

Credenziali in locale

Gira sul tuo computer. Nessun server intermedio, nessun gateway di terzi: i dati vanno da Google e Bing direttamente a te.

Nessuna telemetria

Non raccoglie statistiche d'uso e non contatta altri server. Nemmeno questa pagina usa cookie o tracker.

Solo librerie ufficiali

SDK MCP, @googleapis/searchconsole e google-auth-library. Bing è una semplice chiamata REST.

Codice leggibile

Circa 1.500 righe di TypeScript, con test e CI. Si legge in un'ora, prima di installarlo.

Rispetta le regole

Non usa la Google Indexing API, che Google riserva alle offerte di lavoro e alle dirette video.

Cosa puoi chiedere

Il server restituisce dati puliti. Le analisi le fa l'assistente, ragionando su quei dati.

  • Confronta questo mese con lo stesso periodo dell'anno scorso e segnala i cali di clic sopra il 30%.
  • Ci sono query per cui competono due pagine diverse del sito?
  • Questa pagina è indicizzata? Quale canonical ha scelto Google?
  • Su Bing come va la query "corso SEO" rispetto a Google?
  • Qual è il volume di ricerca su Bing di "noleggio bici Garda"?
  • Le sitemap hanno errori? Quando le ha scaricate Google l'ultima volta?

11 tool, tutti in sola lettura

Google Search Console

gsc_performance
Clic, impressioni, CTR e posizione per query, pagina, paese, dispositivo, data
gsc_compare_periods
Confronto con il periodo precedente o l'anno prima
gsc_striking_distance
Query in posizione 4-20, ordinate per potenziale
gsc_inspect_url
Indicizzazione, canonical, ultima scansione, rich result
gsc_list_sitemaps
Sitemap inviate, errori e avvisi
gsc_list_sites
Proprietà accessibili

Bing Webmaster Tools

bing_query_stats
Performance per query
bing_page_stats
Performance per pagina
bing_keyword_stats
Volumi di ricerca, di default Italia / italiano
bing_list_sites
Siti del tuo account

Diagnostica

seomcp_status
Cosa è configurato e cosa manca, con le istruzioni per sistemarlo

Installa in 3 passi

Configura solo le fonti che usi: Google e Bing sono entrambe facoltative.

Provalo subito da GitHub. Il pacchetto npm @contentisking/seomcp è in arrivo. Nel frattempo i comandi qui sotto installano seomcp direttamente dal repository. Il primo avvio richiede qualche secondo in più, perché il codice viene compilato sul tuo computer. Serve anche git installato.

  1. Prepara le credenziali

    Per Google scegli tra service account e OAuth con un client tuo. Per Bing ti basta una API key, che si genera in due minuti. Le guide sono passo passo e in italiano.

  2. Collegalo al tuo assistente

    Versioni web non supportate. claude.ai, chatgpt.com, l'app Gemini, Microsoft 365 Copilot e Mistral Vibe sul web accettano solo server MCP remoti. seomcp gira in locale per non far uscire le tue credenziali dal computer, quindi servono le app desktop o la riga di comando.

  3. Controlla che funzioni

    npx -y github:davide-cik/seomcp doctor

    Prova ogni fonte e ti dice esattamente cosa manca. Per esempio: «aggiungi seomcp@progetto.iam.gserviceaccount.com come utente della proprietà».

Un regalo alla community SEO

Ci serviva uno strumento così e non ne abbiamo trovato uno di cui fidarci. Così l'abbiamo scritto noi, e invece di tenerlo in casa l'abbiamo reso pubblico. Non vendiamo niente.

Lo manteniamo nel tempo libero, senza garanzie di supporto. Ogni segnalazione ci aiuta, e se sei uno sviluppatore puoi partire da una delle issue già pronte.

Anche come libreria

import { GscClient, strikingDistance }
  from '@contentisking/seomcp';

const gsc = new GscClient(auth);
const rows = await gsc.query({ siteUrl, startDate,
  endDate, dimensions: ['query', 'page'] });
strikingDistance(rows);

I client non leggono né file né variabili d'ambiente, quindi si possono usare anche in un'applicazione multi-utente.