Il flusso per cui è stato creato
Audit → fix-prompt → il tuo agente di programmazione.
get_fix_prompt restituisce un'istruzione scritta per un agente di programmazione, non una checklist per esseri umani: cosa significa il risultato dell'audit, come risolverlo, la gravità e l'area interessata. Il tuo assistente legge un risultato dal tuo audit, richiede il relativo fix-prompt e lo applica direttamente al repository aperto: l'audit e il codice non lasciano mai il tuo editor.
- 1
Esegui un audit gratuito sul tuo sito — nessun account necessario.
- 2
Connetti il server MCP con il tuo token (sotto).
- 3
Chiedi al tuo assistente di recuperare un risultato, il relativo fix-prompt e di applicarlo.
Da sapere
Gli audit vengono avviati nella dashboard — nessuno strumento MCP può avviarne uno. Tramite MCP leggi le esecuzioni e i rispettivi risultati. Un fix-prompt è una guida per il tuo agente, per ciascun tipo di risultato; non è una patch e il tuo agente deve comunque implementare e verificare la modifica.
Cosa ottieni
41 strumenti che il tuo assistente può richiamare.
Una volta connesso, la tua CLI di programmazione AI può richiedere a UPGeoSEO siti, audit e correzioni — e intervenire su di essi. L'elenco qui sotto è generato direttamente dal server: mostra ciò che è effettivamente registrato oggi, non un riepilogo scritto in passato.
Lettura — 27 strumenti
Questi effettuano solo controlli. Restituiscono i tuoi dati e non modificano nulla.
detect_localesShow the languages detected on one of your sites.
get_ai_visibilityThe site's AI-visibility report, query by query: per language and engine (Google AI Overviews, Google AI Mode, ChatGPT, Gemini, Perplexity), how often AI answers cite your site or mention your brand over the last 4 weeks (k of n) with a paired trend, plus every tracked query's latest result, cited URLs and history.
get_analyticsGoogle Analytics 4 report for one of your sites.
get_analytics_realtimeGA4 realtime active users, by country and page.
get_articleLook up one article by id: its title, language, status, whether it is the PRIMARY or a translation, slug, live URL, image refs, SEO score, and its whole translation group.
get_article_impactSEO + GEO impact deltas/trend for one article vs. its pre-publish baseline.
get_audit_findingsPAGINATED — returns at most `limit` findings (default 50, max 200) with `page.hasMore` and `page.nextOffset`; read `summary` for totals by severity and type, then page with `offset`.
get_bing_performanceBing Webmaster traffic, per-page stats, and crawl stats for one of your sites.
get_calendarPAGINATED — the content calendar for one of your sites: each slot's scheduled date, TARGET KEYWORD (with its volume/competition), locale, role, intent, and the article it produced.
get_content_planA site's content plan: without locale, where each language stands; with locale, that language page by page (the page's own keyword, its topics, what is already scheduled, what was left out and why).
get_fix_promptGet a ready-to-paste remediation prompt for a finding type.
get_geo_summaryLive GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).
get_impact_reportThe site's impact report: clicks/impressions/avg position for the last 28 days vs. the prior 28 days, counting ONLY the URLs of articles this account published (never a customer's pre-existing pages).
get_index_statusStored Google index verdicts for one of your sites' articles.
get_indexnow_setupShow the IndexNow verification file one of your sites must serve so Bing, Yandex, Seznam and Naver accept the URLs we submit on your behalf.
get_integration_schemasGet JSON Schema for everything UPGeoSEO emits to your own systems (Article, WebhookPublishPayload, RssItem, StructuredData, TranslationGroup) plus the MCP tool index and per-channel integration guides.
get_keyword_metricsThe STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).
get_keywordsPAGINATED — the keywords discovered for one of your sites, with volume, competition, difficulty, intent, source, and whether each is already scheduled on the calendar.
get_search_performanceGoogle Search Console performance for one of your sites (clicks, impressions, CTR, position).
get_site_speedThe last stored PageSpeed Insights check (mobile + desktop).
get_usageShow this month's action usage for one of your sites — what each limit counts, used/total, reset date.
list_auditsList recent audit runs for one of your sites.
list_rivalsThe rivals YOU named (up to 10) and how you compare over the last four weeks of AI answers.
list_sitesList every site this token can reach: a token acts as the person who created it, so these are the sites that person can open in the dashboard, across every account they belong to (a restricted teammate sees only the sites shared with them), each with its account, your role there, and its latest audit scores (foundation + AI-readiness).
list_tracked_questionsThe questions YOU asked us to track in AI answers (up to 10 per language), each with its latest result per engine: answered (with whether your brand was mentioned and your site linked) or no answer shown.
remove_rivalStop comparing with a rival.
remove_tracked_questionStop tracking one of your questions.
Scrittura — 14 strumenti
Questi modificano qualcosa: aggiungono un sito, pianificano un calendario, pubblicano o eliminano. La maggior parte richiede conferma (qui sotto); tutti sono limitati ai siti che puoi aprire.
add_rivalName a rival to compare with in AI answers: a name (2 to 60 characters) and optionally its website, reduced to its domain (it may not be your own).
add_siteAdd a new site, by its URL, to the account this token was created in (owner or admin only): crawls it and builds its brand profile.
add_tracked_questionTrack one more question in AI answers for a language of the site.
connect_publishAdd a publish destination for a site: a WordPress site, a webhook, a Ghost site, a Webflow CMS collection, a Shopify store or a Wix site (the last two return an install link).
create_focusrichiede confermaConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlerichiede confermaPermanently delete one article, or every non-primary translation of a group.
generate_calendarrichiede confermaPlan a content calendar for one of your sites.
launch_localerichiede confermaRe-run market research for one of this site's already-enabled languages.
publish_articlerichiede confermaPublish a DRAFT article to the site's connected destination.
publish_translationsrichiede confermaCascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_siteRe-learn one of your sites: re-read it and refresh its brand profile and brand colors.
refresh_locale_keywordsrichiede confermaRefresh a non-primary language's keyword ideas: replace the ones not yet on your calendar with freshly researched ones.
reschedule_itemMove a PLANNED calendar item to a new publish date.
update_site_profileComplete or edit a site's onboarding / brand profile, switch Autopilot on or off (publishMode), and (admin-only) set its publishing schedule.
Prima di qualsiasi modifica
Ogni azione richiede prima la tua conferma.
Gli strumenti che modificano il tuo sito o consumano parte della tua quota mensile usano un flusso a due chiamate. La prima chiamata non modifica nulla: restituisce un'anteprima esatta di ciò che accadrebbe e un avviso che è necessaria la conferma. Solo una seconda chiamata con confirm:true esegue l'operazione. Nel frattempo il tuo assistente ti mostra l'anteprima, così nessun agente può pubblicare o consumare la tua quota di nascosto a tuo nome.
Cosa restituisce la prima chiamata
{
"confirm_required": true,
"message": "This will publish “How to split rent” to example.com's connected destination.
Call publish_article again with confirm:true to proceed."
}Una manciata di strumenti di scrittura non richiede conferma perché sono leggeri e reversibili: aggiungere un sito, rieseguirne la scansione, modificarne il profilo, spostare un elemento del calendario. Nessuno strumento che pubblica fa parte di questo gruppo.
Ottieni il tuo token
Genera un token, una volta sola.
Ogni client qui sotto si autentica con la stessa cosa: un token personale che agisce a tuo nome. Ecco dove ottenerlo.
Accedi al tuo account UPGeoSEO (o creane uno — iniziare è gratis).
Apri Dashboard → Il tuo profilo e trova la scheda API access (MCP).
Clicca su Generate token. Copialo subito — inizia con ugs_live_ ed è mostrato una sola volta.
Collega il tuo client
Punta la tua CLI di coding con IA al server.
UPGeoSEO parla MCP standard su Streamable HTTP con auth bearer, quindi funziona con qualsiasi client che supporti un server HTTP remoto e un header personalizzato. Scegli il tuo qui sotto e sostituisci YOUR_TOKEN con il token che hai generato.
Claude Code (CLI)
Un solo comando lo aggiunge — eseguilo da qualsiasi posto:
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Aggiungi una voce a ~/.cursor/mcp.json (globale) o .cursor/mcp.json nel tuo progetto:
// ~/.cursor/mcp.json (or .cursor/mcp.json in your project)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Windsurf
Aggiungilo al mcp_config.json di Windsurf con la stessa struttura url + headers:
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Nota: alcune versioni di Windsurf chiamano il campo serverUrl invece di url. Se url non funziona, rinomina quella singola chiave — tutto il resto resta uguale.
Cline e altre estensioni MCP di VS Code
Aggiungi un server al tuo .mcp.json (o alle impostazioni MCP dell’estensione), url + headers come al solito:
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Qualsiasi altro client MCP — i fatti nudi e crudi
Se il tuo client supporta un server MCP HTTP remoto con header personalizzati, funziona. Le sole tre cose di cui ha bisogno:
- Trasporto: Streamable HTTP
- Endpoint:
https://app.upgeoseo.com/api/mcp - Auth: Header HTTP
Authorization: Bearer <token>
I percorsi esatti dei file di configurazione e i nomi dei campi variano per client e versione. La costante è sempre la stessa: l’URL qui sopra, più l’header Authorization: Bearer che porta il tuo token.
Provalo
Una volta collegato, basta chiedere.
Non chiami gli strumenti per nome — parli con il tuo assistente e li sceglie lui. Qualche cosa da provare:
“Elenca i miei siti.”
“Mostra i problemi aperti per example.com.”
“Prendi il prompt di correzione per h1_missing e applicalo a questo repository.”
Sicurezza
Circoscritto al tuo account, con conferma vincolante e revocabile.
Il tuo accesso, e solo il tuo
Un token agisce a tuo nome: accede a ogni sito che puoi già aprire nella dashboard, nel tuo account e in qualsiasi account a cui appartieni, con il ruolo che hai in ciascuno. Nessuno strumento accetta un account id come argomento, quindi un client con il tuo token non può accedere ai dati di nessun altro, nemmeno chiedendoli.
Le scritture richiedono conferma, non sono bloccate
Questa non è un'integrazione di sola lettura: 14 dei 41 strumenti apportano modifiche. A proteggerti ci sono il passaggio di conferma, i limiti mensili del tuo piano e il fatto che la pubblicazione segue gli stessi controlli della dashboard.
Revoca quando vuoi
Elimina un token dalla stessa scheda API access (MCP) quando vuoi. Una volta revocato, qualsiasi client che lo detiene ancora smette di funzionare all’istante.
Mostrato una volta
Mostriamo un nuovo token una sola volta, alla generazione. Se lo perdi, non lo recuperi — ne generi uno nuovo e lo sostituisci.
