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

39 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 — 22 narzędzi

Te narzędzia tylko odczytują. Zwracają Twoje dane i niczego nie zmieniają.

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

Zapis — 17 narzędzi

Te narzędzia wprowadzają zmiany: dodają stronę, planują kalendarz, piszą, tłumaczą, publikują lub usuwają. Większość wymaga potwierdzenia (poniżej); wszystkie są ograniczone do Twojego konta.

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_focuswymaga potwierdzenia
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_articlewymaga potwierdzenia
Permanently delete one article, or every non-primary translation of a group.
generate_articlewymaga potwierdzenia
Write ONE article now for a site (inline, ~30-60s).
generate_articles_bulkwymaga potwierdzenia
Enqueue many background article-generate jobs at once (returns immediately).
generate_calendarwymaga potwierdzenia
Plan a content calendar for one of your sites.
launch_localewymaga potwierdzenia
Re-run native content research for one of this site's already-enabled languages.
publish_articlewymaga potwierdzenia
Publish a DRAFT article to the site's connected destination.
publish_translationswymaga potwierdzenia
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_keywordswymaga potwierdzenia
Refresh a non-primary locale's keyword ideas: purge unscheduled backlog keywords and re-discover fresh native ones.
refresh_og_imageswymaga potwierdzeniatylko dla administratora
ADMIN ONLY.
reschedule_item
Move a PLANNED calendar item to a new publish date.
research_keywordswymaga potwierdzeniatylko dla administratora
ADMIN ONLY.
translate_articlewymaga potwierdzenia
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.

Zanim cokolwiek ulegnie zmianie

Każda akcja pyta najpierw o zgodę.

Narzędzia, które wiążą się z kosztami lub modyfikują Twoją stronę, korzystają z przepływu dwuetapowego. Pierwsze wywołanie niczego nie zmienia — zwraca podgląd tego, co dokładnie się wydarzy, oraz informację o konieczności potwierdzenia. Dopiero drugie wywołanie z confirm:true wykonuje operację. Asystent wyświetla podgląd pomiędzy wywołaniami, więc agent nie może po cichu publikować ani ponosić kosztów w Twoim imieniu.

Co zwraca pierwsze wywołanie

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

Kilka narzędzi zapisu nie wymaga potwierdzenia, ponieważ są bezpłatne i odwracalne — dodanie witryny, ponowne indeksowanie, edycja jej profilu czy przesunięcie elementu w kalendarzu. Żadne narzędzie publikujące ani wiążące się z kosztami 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 tokenu z uprawnieniami do Twojego konta. Oto jak go uzyskać.

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.

Twoje konto i tylko Twoje

Token jest powiązany z jednym kontem. Każde narzędzie pobiera identyfikatory stron z Twojego konta i żadne narzędzie nie przyjmuje identyfikatora konta jako argumentu, więc klient posiadający Twój token nie ma dostępu do danych innych osób — nawet jeśli o nie zapyta.

Operacje zapisu wymagają zgody, nie są zablokowane

To nie jest integracja tylko do odczytu: 17 z 39 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ć.

Zarządzaj swoim SEO z swojego edytora.