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

39 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 — 22 strumenti

Questi effettuano solo controlli. Restituiscono i tuoi dati e non modificano nulla.

detect_locales
Show the languages detected on one of your sites.
get_ai_visibility
The site's most recent completed AI-visibility probe cycle rates.
get_analytics
Google Analytics 4 report for one of your sites.
get_analytics_realtime
GA4 realtime active users, by country and page.
get_article
Look 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_impact
SEO + GEO impact deltas/trend for one article vs.
get_audit_findings
PAGINATED — 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_performance
Bing Webmaster traffic, per-page stats, and crawl stats for one of your sites.
get_calendar
PAGINATED — 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_fix_prompt
Get a ready-to-paste remediation prompt for a finding type.
get_geo_summary
Live GA4 rollup of AI-assistant referral traffic (ChatGPT, Perplexity, Gemini, Claude, Copilot, You.com).
get_impact_report
The site's impact report: clicks/impressions/avg position for the last 28 days vs.
get_index_status
Stored Google/Bing index verdicts for one of your sites' articles.
get_indexnow_setup
Show 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_schemas
Get 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_metrics
The STORED search metrics for one keyword on one of your sites (volume, competition, CPC, difficulty, market, source, measured-at).
get_keywords
PAGINATED — 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_performance
Google Search Console performance for one of your sites (clicks, impressions, CTR, position).
get_site_speed
The last stored PageSpeed Insights check (mobile + desktop).
get_usage
Show this month's action usage for one of your sites — what each limit counts, used/total, reset date.
list_audits
List recent audit runs for one of your sites.
list_sites
List the sites in your account, with each site's id, URL, and latest audit scores (foundation + AI-readiness).

Scrittura — 17 strumenti

Questi modificano qualcosa: aggiungono un sito, pianificano un calendario, scrivono, traducono, pubblicano o eliminano. La maggior parte richiede conferma (vedi sotto); tutti sono limitati esclusivamente al tuo account.

add_site
Add a new site to your account by its URL: crawls it and builds its brand profile.
connect_publish
Add a publish destination for a site: a WordPress site or a webhook.
create_focusrichiede conferma
Concentrate promotion on a new feature (sourced through real demand; the feature name is never the keyword; other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlerichiede conferma
Permanently delete one article, or every non-primary translation of a group.
generate_articlerichiede conferma
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkrichiede conferma
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarrichiede conferma
Plan a content calendar for one of your sites.
launch_localerichiede conferma
Re-run native content research for one of this site's already-enabled languages.
publish_articlerichiede conferma
Publish a DRAFT article to the site's connected destination.
publish_translationsrichiede conferma
Cascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_site
Re-learn one of your sites: re-crawl it and refresh the crawl-derived brand profile and brand colors.
refresh_locale_keywordsrichiede conferma
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagesrichiede confermasolo admin
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordsrichiede confermasolo admin
ADMIN ONLY.
translate_articlerichiede conferma
Translate an existing article into the site's other enabled languages (background jobs).
update_site_profile
Complete or edit a site's onboarding / brand profile and (admin-only) its publishing schedule.

Prima di qualsiasi modifica

Ogni azione richiede prima la tua conferma.

Gli strumenti che comportano spese o modificano il tuo sito usano un flusso a due chiamate. La prima chiamata non modifica nulla: restituisce un'anteprima esatta di ciò che accadrebbe e un avviso che è richiesta la conferma. Solo una seconda chiamata con confirm:true esegue l'operazione. Il tuo assistente ti mostra l'anteprima prima di procedere, impedendo a un agente di pubblicare o spendere a tua insaputa.

Cosa restituisce la prima chiamata

{
  "confirm_required": true,
  "message": "This will generate 1 article for example.com …
              Call generate_article again with confirm:true to proceed."
}

Alcuni strumenti di scrittura non richiedono conferma perché sono a basso impatto e reversibili: aggiungere un sito, rieseguirne la scansione, modificarne il profilo, spostare un elemento nel calendario. Nessuna operazione che pubblica o comporta spese rientra in 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 limita l’accesso al tuo account. 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 account, e solo il tuo

Un token è vincolato a un solo account. Ciascuno strumento recupera gli id dei siti dal tuo account e nessuno strumento accetta un id account come argomento: un client che possiede il tuo token non può accedere ai dati di nessun altro, nemmeno richiedendoli esplicitamente.

Le scritture richiedono conferma, non sono bloccate

Questa non è un'integrazione di sola lettura: 17 dei 39 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.

Gestisci la tua SEO da tuo editor.