Pętla pracy, do której to służy
Audyt → prompt z poprawką → Twój agent programistyczny.
get_fix_prompt zwraca instrukcję przygotowaną dla agenta programistycznego, a nie ludzką listę kontrolną: co oznacza problem, jak go naprawić oraz jakiej wagi i obszaru dotyczy. Twój asystent odczytuje problem z audytu, prosi o prompt z poprawką i stosuje go w już otwartym repozytorium — audyt i kod nigdy nie opuszczają Twojego edytora.
- 1
Uruchom darmowy audyt swojej strony — bez konieczności zakładania konta.
- 2
Połącz serwer MCP za pomocą swojego tokena (poniżej).
- 3
Poproś asystenta o pobranie wykrytego problemu oraz prompta z poprawką i wdrożenie go.
Warto wiedzieć
Audyty uruchamia się w panelu — żadne narzędzie MCP ich nie rozpoczyna. Przez MCP odczytujesz przebiegi i ich wyniki. Prompt z poprawką to wskazówka dla Twojego agenta dla danego typu problemu; nie jest to gotowy patch, a Twój agent nadal musi wprowadzić i sprawdzić zmianę.
Co zyskujesz
41 narzędzi, które Twój asystent może wywołać.
Po połączeniu Twoje CLI do kodowania AI może zapytać UPGeoSEO o Twoje strony, audyty i poprawki — oraz na nich działać. Poniższa lista jest generowana bezpośrednio z serwera, więc odzwierciedla to, co jest faktycznie zarejestrowane dzisiaj, a nie dawno spisane podsumowanie.
Odczyt — 27 narzędzi
Te narzędzia tylko odczytują. Zwracają Twoje dane i niczego nie zmieniają.
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.
Zapis — 14 narzędzi
Te narzędzia wprowadzają zmiany: dodają witrynę, planują kalendarz, publikują lub usuwają. Większość wymaga potwierdzenia (poniżej); wszystkie są ograniczone do witryn, które możesz otworzyć.
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_focuswymaga potwierdzeniaConcentrate the next days on a new feature (other articles of that language mention it) or a newly launched language, without adding articles.
delete_articlewymaga potwierdzeniaPermanently delete one article, or every non-primary translation of a group.
generate_calendarwymaga potwierdzeniaPlan a content calendar for one of your sites.
launch_localewymaga potwierdzeniaRe-run market research for one of this site's already-enabled languages.
publish_articlewymaga potwierdzeniaPublish a DRAFT article to the site's connected destination.
publish_translationswymaga potwierdzeniaCascade-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_keywordswymaga potwierdzeniaRefresh 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.
Zanim cokolwiek ulegnie zmianie
Każda akcja pyta najpierw o zgodę.
Narzędzia wprowadzające zmiany na stronie lub zużywające część miesięcznego limitu działają w modelu dwuetapowym. Pierwsze wywołanie niczego nie zmienia — zwraca podgląd tego, co dokładnie by się stało, oraz informację o wymaganym potwierdzeniu. Dopiero drugie wywołanie z parametrem confirm:true wykonuje operację. Twój asystent wyświetla w tym czasie podgląd, więc agent nie może po cichu nic opublikować ani zużyć limitu w Twoim imieniu.
Co zwraca pierwsze wywołanie
{
"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."
}Kilka narzędzi zapisu nie wymaga potwierdzenia, ponieważ ich działanie jest tanie i odwracalne — dodanie strony, ponowne skanowanie, edycja profilu czy przesunięcie elementu w kalendarzu. Żadne narzędzie publikujące treści nie należy do tej grupy.
Pobierz swój token
Wygeneruj token — wystarczy raz.
Każdy z poniższych klientów uwierzytelnia się w ten sam sposób: za pomocą osobistego tokena działającego w Twoim imieniu. Oto gdzie go pobrać.
Zaloguj się na swoje konto UPGeoSEO (lub załóż je — start jest bezpłatny).
Otwórz Pulpit → Twój profil i znajdź sekcję Dostęp API (MCP).
Kliknij Generuj token. Skopiuj go od razu — zaczyna się od ugs_live_ i jest wyświetlany tylko raz.
Połącz swojego klienta
Skieruj swoje AI coding CLI na serwer.
UPGeoSEO obsługuje standardowy protokół MCP przez Streamable HTTP z autoryzacją bearer, dzięki czemu działa z każdym klientem wspierającym zdalny serwer HTTP i niestandardowy nagłówek. Wybierz swoje narzędzie poniżej i zastąp YOUR_TOKEN wygenerowanym tokenem.
Claude Code (CLI)
Wystarczy jedno polecenie — uruchom je z dowolnego miejsca:
claude mcp add --transport http upgeoseo \
https://app.upgeoseo.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Dodaj wpis do ~/.cursor/mcp.json (globalnie) lub .cursor/mcp.json w swoim projekcie:
// ~/.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
Dodaj go do pliku mcp_config.json w Windsurf z tą samą strukturą url + headers:
// Windsurf → mcp_config.json
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Uwaga: niektóre wersje Windsurf nazywają to pole serverUrl zamiast url. Jeśli url nie działa, zmień tylko ten jeden klucz — cała reszta pozostaje bez zmian.
Cline i inne rozszerzenia MCP dla VS Code
Dodaj serwer do pliku .mcp.json (lub w ustawieniach MCP rozszerzenia), standardowo podając url + headers:
// .mcp.json (or your MCP extension's settings)
{
"mcpServers": {
"upgeoseo": {
"url": "https://app.upgeoseo.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Dowolny inny klient MCP — podstawowe informacje
Jeśli Twój klient obsługuje zdalny serwer MCP przez HTTP z niestandardowymi nagłówkami, to zadziała. Potrzebuje tylko trzech rzeczy:
- Transport: Streamable HTTP
- Punkt końcowy:
https://app.upgeoseo.com/api/mcp - Uwierzytelnianie: Nagłówek HTTP
Authorization: Bearer <token>
Dokładne ścieżki plików konfiguracyjnych i nazwy pól różnią się w zależności od klienta i wersji. Stała pozostaje zawsze ta sama: powyższy URL oraz nagłówek Authorization: Bearer z Twoim tokenem.
Wypróbuj
Po połączeniu po prostu zapytaj.
Nie wywołujesz narzędzi po nazwie — rozmawiasz ze swoim asystentem, a on sam je wybiera. Kilka przykładów do wypróbowania:
“Wymień moje witryny.”
“Pokaż otwarte błędy dla example.com.”
“Pobierz prompt naprawczy dla h1_missing i zastosuj go w tym repozytorium.”
Bezpieczeństwo
Przypisane do Ciebie, wymagające potwierdzenia, odwoływalne.
Twój dostęp i tylko Twój
Token działa w Twoim imieniu: ma dostęp do każdej witryny, którą możesz już otworzyć w panelu, na Twoim własnym koncie oraz na dowolnym koncie, do którego należysz, z rolą, jaką na nim posiadasz. Żadne narzędzie nie przyjmuje identyfikatora konta jako argumentu, więc klient posiadający Twój token nie uzyska dostępu do danych nikogo innego, nawet jeśli o nie poprosi.
Operacje zapisu wymagają zgody, nie są zablokowane
To nie jest integracja tylko do odczytu: 14 z 41 narzędzi wprowadza zmiany. Przed niepożądanymi działaniami chroni Cię krok potwierdzenia, miesięczne limity planu oraz fakt, że publikacja przechodzi przez te same kontrole, co w panelu.
Unieważnij w dowolnym momencie
Usuń token z karty Dostęp do API (MCP), kiedy tylko chcesz. Po unieważnieniu każdy klient, który z niego korzysta, natychmiast przestanie działać.
Wyświetlany tylko raz
Nowy token pokazujemy tylko raz, podczas jego generowania. Jeśli go zgubisz, nie można go odzyskać — musisz wygenerować nowy i go podmienić.
