Flödet detta är byggt för
Granskning → åtgärdsprompt → din kodningsagent.
get_fix_prompt returnerar en instruktion skriven för en kodningsagent, inte en checklista för människor: vad resultatet innebär, hur det åtgärdas samt allvarlighetsgrad och vilket område det påverkar. Din assistent läser ett resultat från din granskning, begär dess åtgärdsprompt och tillämpar den på kodförrådet som redan är öppet — granskningen och koden lämnar aldrig din editor.
- 1
Kör en kostnadsfri granskning av din webbplats — inget konto krävs.
- 2
Anslut MCP-servern med din token (nedan).
- 3
Be din assistent hämta ett resultat och dess åtgärdsprompt och tillämpa den.
Värt att veta
Granskningar startas i instrumentpanelen — inget MCP-verktyg startar en granskning. Via MCP läser du körningarna och deras resultat. En åtgärdsprompt är vägledning för din agent per typ av upptäckt; det är inte en patch, och din agent måste fortfarande göra och kontrollera ändringen.
Det här får du
39 verktyg som din assistent kan anropa.
När du är ansluten kan ditt AI-kodnings-CLI be UPGeoSEO om dina webbplatser, granskningar och åtgärder — och agera på dem. Listan nedan genereras direkt från servern, så den visar exakt vad som är registrerat idag, inte en sammanfattning som någon skrev för länge sedan.
Läs — 22 verktyg
Dessa läser endast data. De returnerar din egen data och ändrar ingenting.
detect_localesShow the languages detected on one of your sites.
get_ai_visibilityThe site's most recent completed AI-visibility probe cycle rates.
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.
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_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.
get_index_statusStored Google/Bing 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_sitesList the sites in your account, with each site's id, URL, and latest audit scores (foundation + AI-readiness).
Skriv — 17 verktyg
Dessa ändrar något: de lägger till en webbplats, planerar en kalender, skriver, översätter, publicerar eller raderar. De flesta kräver bekräftelse (se nedan); samtliga är begränsade till ditt eget konto.
add_siteAdd a new site to your account by its URL: crawls it and builds its brand profile.
connect_publishAdd a publish destination for a site: a WordPress site or a webhook.
create_focusfrågar förstConcentrate 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_articlefrågar förstPermanently delete one article, or every non-primary translation of a group.
generate_articlefrågar förstWrite ONE article now for a site (inline, ~30-60s).
generate_articles_bulkfrågar förstEnqueue many background article-generate jobs at once (returns immediately).
generate_calendarfrågar förstPlan a content calendar for one of your sites.
launch_localefrågar förstRe-run native content research for one of this site's already-enabled languages.
publish_articlefrågar förstPublish a DRAFT article to the site's connected destination.
publish_translationsfrågar förstCascade-publish a whole translation group: the primary plus every draft sibling.
recrawl_siteRe-learn one of your sites: re-crawl it and refresh the crawl-derived brand profile and brand colors.
refresh_locale_keywordsfrågar förstRefresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imagesfrågar förstendast adminADMIN ONLY.
reschedule_itemMove a PLANNED calendar item to a new publish date.
research_keywordsfrågar förstendast adminADMIN ONLY.
translate_articlefrågar förstTranslate an existing article into the site's other enabled languages (background jobs).
update_site_profileComplete or edit a site's onboarding / brand profile and (admin-only) its publishing schedule.
Innan något ändras
Varje åtgärd frågar dig först.
Verktygen som kostar pengar eller ändrar din webbplats använder ett tvåstegsflöde. Det första anropet ändrar ingenting — det returnerar en förhandsgranskning av exakt vad som skulle hända och en notis om att bekräftelse krävs. Endast ett andra anrop med confirm:true utför arbetet. Din assistent visar förhandsgranskningen däremellan, så att en agent inte obemärkt kan publicera eller spendera å dina vägnar.
Vad det första anropet returnerar
{
"confirm_required": true,
"message": "This will generate 1 article for example.com …
Call generate_article again with confirm:true to proceed."
}En handfull skrivverktyg kräver inte bekräftelse eftersom de är billiga och reversibla — som att lägga till en webbplats, crawla om en, redigera dess profil eller flytta ett kalenderobjekt. Inget som publicerar eller kostar pengar ingår i den gruppen.
Hämta din token
Skapa en token en gång.
Alla klienter nedan autentiserar på samma sätt: med en personlig token som ger behörighet till ditt konto. Här hämtar du den.
Logga in på ditt UPGeoSEO-konto (eller skapa ett – det är gratis att börja).
Öppna Kontrollpanel → Din profil och leta upp kortet för API-åtkomst (MCP).
Klicka på Skapa token. Kopiera den nu – den börjar med ugs_live_ och visas bara en gång.
Anslut din klient
Rikta ditt AI-kodnings-CLI mot servern.
UPGeoSEO använder standard-MCP över Streamable HTTP med Bearer-autentisering, så det fungerar med alla klienter som stöder en fjärr-HTTP-server och ett anpassat header-fält. Välj din klient nedan och ersätt YOUR_TOKEN med den token du skapade.
Claude Code (CLI)
Ett enda kommando lägger till den – kör det varifrån som helst:
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Lägg till en post i ~/.cursor/mcp.json (globalt) eller .cursor/mcp.json i ditt projekt:
// ~/.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
Lägg till det i Windsurfs mcp_config.json med samma format för url + headers:
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Obs: vissa Windsurf-versioner namnger fältet serverUrl istället för url. Om url inte fungerar, byt namn på den nyckeln – allt annat förblir detsamma.
Cline och andra MCP-tillägg för VS Code
Lägg till en server i din .mcp.json (eller tilläggets MCP-inställningar), url + headers som vanligt:
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Alla andra MCP-klienter – ren fakta
Om din klient stöder en fjärransluten HTTP MCP-server med anpassade headers fungerar det. Det enda den behöver är följande tre saker:
- Transport: Streamable HTTP
- Slutpunkt:
https://app.upgeoseo.com/api/mcp - Autentisering: HTTP-header
Authorization: Bearer <token>
Exakta sökvägar till konfigurationsfiler och fältnamn varierar beroende på klient och version. Det konstanta är alltid detsamma: URL:en ovan, plus headern Authorization: Bearer som bär din token.
Prova det
När den är ansluten är det bara att fråga.
Du anropar inte verktygen vid namn – du pratar med din assistent, så väljer den verktygen. Några saker att prova:
“Lista mina webbplatser.”
“Visa öppna fynd för example.com.”
“Hämta åtgärdsprompten för h1_missing och applicera den på detta repo.”
Säkerhet
Avgränsad till dig, kräver bekräftelse, återkallningsbar.
Ditt konto, och endast ditt
En token är bunden till ett konto. Varje verktyg hämtar sina webbplats-id:n från ditt eget konto och inget verktyg accepterar ett konto-id som argument. En klient med din token kan därför inte komma åt någon annans data — inte ens genom att fråga efter den.
Skrivåtgärder är villkorade, inte blockerade
Det här är inte en skrivskyddad integration: 17 av de 39 verktygen ändrar något. Det som skyddar dig är bekräftelsesteget, din prenumerations månatliga gränser och det faktum att publicering genomgår samma kontroller som i instrumentpanelen.
Återkalla när som helst
Ta bort en token från samma kort för API access (MCP) när du vill. När den har återkallats slutar alla klienter som använder den att fungera omedelbart.
Visas en gång
Vi visar en ny token en enda gång, vid generering. Om du tappar bort den kan du inte återställa den – du genererar en ny och byter ut den.
