Le flux prévu

Audit → fix-prompt → votre agent de code.

get_fix_prompt renvoie une instruction rédigée pour un agent de code, pas une checklist humaine : signification de l'anomalie, méthode de correction, niveau de gravité et zone concernée. Votre assistant lit un résultat de votre audit, demande son fix-prompt et l'applique au dépôt déjà ouvert — l'audit et le code ne quittent jamais votre éditeur.

1
Lancez un audit gratuit de votre site — aucun compte requis.
2
Connectez le serveur MCP avec votre jeton (ci-dessous).
3
Demandez à votre assistant de récupérer une anomalie et son fix-prompt, puis de l'appliquer.

Bon à savoir

Les audits sont lancés depuis le tableau de bord — aucun outil MCP n'en démarre un. Via MCP, vous consultez les exécutions et leurs résultats. Un fix-prompt est une directive destinée à votre agent selon le type d'anomalie ; ce n'est pas un patch, et votre agent doit tout de même effectuer et vérifier la modification.

Ce que vous obtenez

39 outils que votre assistant peut appeler.

Une fois connectée, votre CLI de code IA peut interroger UPGeoSEO pour obtenir vos sites, audits et correctifs — et agir en conséquence. La liste ci-dessous est générée par le serveur lui-même : elle reflète fidèlement ce qui est enregistré aujourd'hui, et non un résumé rédigé autrefois.

Lecture — 22 outils

Ces outils se contentent de consulter. Ils renvoient vos propres données sans rien modifier.

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).

Écriture — 17 outils

Ces outils modifient des données : ils ajoutent un site, planifient un calendrier, rédigent, traduisent, publient ou suppriment. La plupart nécessitent une confirmation (ci-dessous) ; tous sont limités à votre propre compte.

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_focusdemande confirmation
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_articledemande confirmation
Permanently delete one article, or every non-primary translation of a group.
generate_articledemande confirmation
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkdemande confirmation
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendardemande confirmation
Plan a content calendar for one of your sites.
launch_localedemande confirmation
Re-run native content research for one of this site's already-enabled languages.
publish_articledemande confirmation
Publish a DRAFT article to the site's connected destination.
publish_translationsdemande confirmation
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_keywordsdemande confirmation
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagesdemande confirmationadmin uniquement
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordsdemande confirmationadmin uniquement
ADMIN ONLY.
translate_articledemande confirmation
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.

Avant toute modification

Chaque action vous demande d'abord confirmation.

Les outils qui consomment des crédits ou modifient votre site fonctionnent en deux appels. Le premier appel ne modifie rien — il renvoie un aperçu exact de ce qui se produirait, accompagné d'une mention indiquant qu'une confirmation est requise. Seul un second appel avec confirm:true applique les modifications. Votre assistant vous affiche l'aperçu entre les deux, empêchant ainsi un agent de publier ou de dépenser discrètement à votre insu.

Ce que renvoie le premier appel

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

Une poignée d'outils d'écriture ne nécessitent pas de confirmation car ils sont peu coûteux et réversibles — ajouter un site, relancer son crawl, modifier son profil, déplacer un élément du calendrier. Rien de ce qui publie ou consomme des crédits ne fait partie de ce groupe.

Obtenez votre jeton

Générez un jeton, une seule fois.

Chaque client ci-dessous s’authentifie avec la même chose : un jeton personnel qui limite l’accès à votre compte. Voici où l’obtenir.

Connectez-vous à votre compte UPGeoSEO (ou créez-en un — c’est gratuit pour commencer).

Ouvrez Tableau de bord → Votre profil et trouvez la carte API access (MCP).

Cliquez sur Generate token. Copiez-le maintenant — il commence par ugs_live_ et n’est affiché qu’une seule fois.

Connectez votre client

Pointez votre CLI de codage IA vers le serveur.

UPGeoSEO parle le MCP standard en Streamable HTTP avec authentification bearer, il fonctionne donc avec tout client prenant en charge un serveur HTTP distant et un en-tête personnalisé. Choisissez le vôtre ci-dessous et remplacez YOUR_TOKEN par le jeton que vous avez généré.

Claude Code (CLI)

Une seule commande l’ajoute — exécutez-la depuis n’importe où :

claude mcp add --transport http upgeoseo \
  https://app.upgeoseo.com/api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Ajoutez une entrée à ~/.cursor/mcp.json (global) ou .cursor/mcp.json dans votre projet :

// ~/.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

Ajoutez-le au mcp_config.json de Windsurf avec la même structure url + headers :

// Windsurf → mcp_config.json
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Note : certaines versions de Windsurf nomment le champ serverUrl au lieu de url. Si url ne fonctionne pas, renommez cette seule clé — tout le reste ne change pas.

Cline et autres extensions MCP de VS Code

Ajoutez un serveur à votre .mcp.json (ou aux réglages MCP de l’extension), url + headers comme d’habitude :

// .mcp.json (or your MCP extension's settings)
{
  "mcpServers": {
    "upgeoseo": {
      "url": "https://app.upgeoseo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Tout autre client MCP — les faits bruts

Si votre client prend en charge un serveur MCP HTTP distant avec des en-têtes personnalisés, il fonctionne. Les trois seules choses dont il a besoin :

Transport : Streamable HTTP
Point d’accès : https://app.upgeoseo.com/api/mcp
Auth : En-tête HTTP Authorization: Bearer <token>

Les chemins exacts des fichiers de configuration et les noms de champs varient selon le client et la version. La constante reste toujours la même : l’URL ci-dessus, plus l’en-tête Authorization: Bearer portant votre jeton.

Essayez

Une fois connecté, il suffit de demander.

Vous n’appelez pas les outils par leur nom — vous parlez à votre assistant, et il les choisit. Quelques idées à essayer :

“Liste mes sites.”

“Montre les problèmes ouverts pour example.com.”

“Récupère le prompt de correction pour h1_missing et applique-le à ce dépôt.”

Sécurité

Limité à votre compte, avec confirmation, révocable.

Votre compte, et uniquement le vôtre

Un jeton est lié à un seul compte. Chaque outil récupère ses identifiants de site depuis votre propre compte et aucun outil n'accepte d'identifiant de compte en argument ; un client disposant de votre jeton ne peut donc accéder aux données de personne d'autre — même en les demandant explicitement.

Les écritures sont encadrées, pas bloquées

Il ne s'agit pas d'une intégration en lecture seule : 17 des 39 outils modifient des éléments. Ce qui vous protège, c'est l'étape de confirmation, les limites mensuelles de votre forfait et le fait que la publication passe par les mêmes vérifications que dans le tableau de bord.

Révoquez à tout moment

Supprimez un jeton depuis la même carte API access (MCP) quand vous voulez. Une fois révoqué, tout client qui le détient encore cesse de fonctionner immédiatement.

Affiché une seule fois

Nous montrons un nouveau jeton une seule fois, à sa génération. Si vous le perdez, vous ne le récupérez pas — vous en générez un nouveau et le remplacez.

Gérez votre SEO depuis votre éditeur.