Przejdź do treści

Senuto MCP i integracja z agentami AI w analizie SEO

Dowiedz się, jak połączyć Senuto MCP z agentami AI. Wykorzystaj Claude Code i Codex do automatycznej analizy SEO oraz bezpośredniej pracy na plikach.

Maciej Sala

Founder StriveLab

15 min czytaniaOpublikowano

Na wstępie możesz wybrać ścieżkę odpowiadającą temu, co chcesz zrobić.

Wspólne podstawy opisuję poniżej, a szczegóły parametrów i limitów znajdziesz na końcu artykułu.

Czym jest Senuto MCP i czego potrzebujesz do podłączenia?

Senuto jest jednym z podstawowych narzędzi SEO na polskim rynku o bardzo dużej użyteczności podczas pracy analitycznej. Pokazuje widoczność domeny, pozycje fraz, konkurencję czy historię zmian, ale posiada to samo ograniczenie co Ahrefs czy Semrush: opisuje pewien stan, ale nie przedstawia konkretnego planu działania. Żeby zdecydować, co zmienić w treści w najbliższym tygodniu, trzeba jeszcze nałożyć filtry, wyeksportować dane, porównać się z konkurencją i przeczytać własną podstronę. Proces jest więc wydłużony i opiera się na różnych czynnościach, które wykonujemy ręcznie.

MCP to standard łączenia aplikacji AI z zewnętrznymi narzędziami. Po podłączeniu Senuto asystent może pobierać dane o widoczności domen, frazach i konkurencji na podstawie Twojego polecenia. W związku z powyższym nie musisz już eksportować tabeli i wklejać jej do rozmowy. Wszystko odbywa się automatycznie i jest niezwykle wygodne. Z drugiej strony zastrzegam, że połączenie udostępnia dane, ale nie gwarantuje poprawnej interpretacji. Model może potencjalnie wybrać niewłaściwy zakres albo wyciągnąć zbyt daleko idący wniosek i dlatego właśnie w przykładach proszę o źródła, daty i oddzielenie danych od ocen. Więcej o samym standardzie znajdziesz w przewodniku po MCP.

By zacząć właściwą integrację, potrzebujesz konta Senuto z dostępem do MCP oraz aplikacji AI, która pozwala dodać taki serwer. Pamiętaj, że we wszystkich czterech narzędziach używasz tego samego adresu:

Code
https://mcp.senuto.com/mcp

Serwer działa po stronie Senuto, a logowanie odbywa się przez , czyli ekran autoryzacji konta, bez ręcznego generowania klucza REST API.

Ile kosztuje Senuto MCP i w których planach jest dostępny?

Według dokumentacji Senuto z końca września 2026 MCP jest w cenie planów Advanced i Prime, natomiast w Lite i Basic dostępny jest dodatek „Dostęp do MCP” za 69 zł netto miesięcznie. Ten dodatek nie obejmuje REST API, którego potrzebujesz dopiero do własnych integracji programistycznych. Wywołania MCP zużywają przy tym limity konta, które omawiam w sekcji o limitach. Podsumowując temat kosztów, by zacząć, potrzebujesz około 200 zł minimum po stronie narzędzia Senuto.

Senuto MCP w Claude i ChatGPT: analiza SEO bez programowania

Ta ścieżka jest dla osób, które chcą dostać sam raport, porównać konkurentów albo ustalić priorytety treści. Wybierz narzędzie, z którym pracujesz — omawiam przykłady dwóch najpopularniejszych, czyli Claude i ChatGPT.

Jak podłączyć Senuto MCP do Claude?

  1. Otwórz Claude w przeglądarce lub aplikacji desktopowej i przejdź do Ustawienia → Konektory (Settings → Connectors).
  2. Wybierz Dodaj własny konektor (Add custom connector), nazwij go „Senuto” i wklej adres https://mcp.senuto.com/mcp.
  3. Zapisz połączenie i przejdź logowanie do Senuto, gdy pojawi się prośba o autoryzację — może nastąpić przy łączeniu lub pierwszym użyciu.
  4. W rozmowie upewnij się, że konektor Senuto jest włączony, i wykonaj test z następnej sekcji.

W sytuacji, kiedy nie widzisz opcji dodania własnego konektora, sprawdź uprawnienia konta, a w wypadku przestrzeni organizacji może być potrzebne działanie administratora.

Jak podłączyć Senuto MCP do ChatGPT?

Konfigurację należy rozpocząć z poziomu przeglądarki internetowej. Oficjalna dokumentacja instalacyjna Senuto wskazuje, że do nawiązania połączenia wymagany jest aktywny plan ChatGPT Pro lub Business. Aktualne wytyczne OpenAI kierują użytkownika przez dedykowany tryb deweloperski bezpośrednio do ekranu zarządzania wtyczkami i integracjami:

  1. Otwórz Settings → Security and login i włącz Developer mode, jeśli jest dostępny na Twoim koncie.
  2. Przejdź do Plugins, wybierz przycisk + i podaj nazwę „Senuto” oraz krótki opis połączenia.
  3. W sekcji Connection wpisz adres https://mcp.senuto.com/mcp jako publiczny adres serwera MCP.
  4. Utwórz połączenie, przejdź autoryzację konta Senuto i sprawdź listę udostępnionych narzędzi.
  5. Rozpocznij rozmowę i dodaj połączenie Senuto z menu narzędzi.

Układ ekranów w ChatGPT zmienia się dość często, więc nazwy opcji na Twoim koncie mogą się różnić, ale adres serwera pozostaje ten sam. Dodam jeszcze, że opisany w instrukcji tryb deweloperski służy wyłącznie do skonfigurowania połączenia i nie wymaga samodzielnego pisania kodu.

Jak sprawdzić połączenie z Senuto i ustalić zasady analizy?

Zastąp example.pl swoją domeną i wyślij:

Code
Użyj połączenia Senuto. Sprawdź widoczność example.pl dla Polski,
cała domena z subdomenami, baza 2.0. Pokaż liczbę fraz w TOP3, TOP10 i TOP50.
Podaj datę danych, wybraną bazę i zakres analizy.
Jeśli nie masz dostępu do narzędzia lub danych, napisz to wprost.

Przed przystąpieniem do dalszych prac warto dołączyć zwięzły profil firmy oraz wytyczne analityczne — najlepiej zamieszczając je bezpośrednio na samym początku konwersacji:

Code
Moja domena to example.pl. Firma oferuje [usługi lub produkty]
dla [grupy klientów] na rynku [obszar działania]. Priorytetem jest [cel].
Analizuj całą domenę z subdomenami, tak jak panel Senuto. Dla widoczności w Polsce używaj bazy 2.0;
dla bazy słów kluczowych używaj obsługiwanej bazy 1.0.
Oddzielaj liczby z Senuto od własnych wniosków. Podawaj daty danych.
Brak danych oznaczaj wprost. Przed szerszą analizą sprawdź limity.

Nazwy baz mogą wyglądać technicznie, ale wpływają na zgodność z panelem Senuto. Ich znaczenie i numery parametrów opisuję w sekcji o bazach danych.

Analiza widoczności domeny w Senuto przez AI

Po ustaleniu kontekstu poproś o pierwszy raport:

Code
Na ustalonych zasadach sprawdź widoczność example.pl z ostatnich
sześciu miesięcy. Pokaż zmianę liczby fraz w TOP3, TOP10 i TOP50
oraz 10 adresów URL z największą widocznością. Wskaż dostępny zakres dat.
Na końcu wypisz trzy obserwacje i pytania do dalszego sprawdzenia.
Nie przypisuj przyczyn wzrostów lub spadków bez dodatkowych dowodów.

Raport tego typu precyzyjnie wskazuje, które podstrony są uwzględnione w badanej bazie fraz kluczowych oraz jak kształtowała się ich widoczność na przestrzeni czasu. Sam spadek pozycji nie wskazuje jednak bezpośredniej przyczyny problemu i dlatego jego diagnoza wymaga dalszego sprawdzenia pod kątem stanu indeksacji, niedawnych zmian w treści, czynników sezonowych czy działań konkurencji. Trzeba też pamiętać, że brak danego adresu URL w zestawieniu nie jest równoznaczny z brakiem jego indeksacji w Google ani brakiem generowanego ruchu.

Frazy na pozycjach 11–20 i priorytety optymalizacji treści

Co więcej, zestawienie to stanowi wartościowy punkt wyjścia do audytu istniejących podstron. Przy czym trzeba pamiętać, że pozycje tuż za pierwszą dziesiątką wyników wyszukiwania nie gwarantują automatycznego, szybkiego wzrostu — z tego powodu stały monitoring pozycji należy bezwzględnie zestawić z dokładną intencją zapytania oraz realną ofertą biznesową firmy:

Code
Pobierz frazy example.pl z pozycji 11–20, ich wolumeny i rankujące URL-e.
Pogrupuj je według podstron. Wybierz pięć grup do dalszej analizy,
uwzględniając ofertę i cel firmy podane wcześniej.
W tabeli oddziel dane Senuto od swojej oceny wartości biznesowej.
Dla każdej grupy napisz, co trzeba sprawdzić w treści przed zmianami.
Nie obiecuj wzrostu pozycji ani ruchu.

Pamiętaj, że niszowa fraza usługowa o niskim wolumenie wyszukiwań ma dla firmy często wyższą wartość biznesową niż popularne zapytanie informacyjne. Asystent AI powinien wyczerpująco uzasadnić taki wybór, a w przypadku posiadania wewnętrznych danych o konwersjach lub zapytaniach ofertowych od klientów — bezwzględnie włączyć je do analizy. Same narzędzia SEO, takie jak Senuto, pokazują wyłącznie szacowany ruch, nie rozstrzygając o rzeczywistym potencjale sprzedażowym danej frazy.

Analiza konkurencji i tematy do sprawdzenia na danych Senuto

Code
Znajdź w Senuto konkurentów example.pl i pokaż podstawę ich doboru.
Wybierz trzy domeny, których oferta odpowiada naszej.
Porównaj ich widoczność z naszą na tej samej bazie i dacie danych.
Na podstawie fraz i rankujących URL-i zaproponuj pięć tematów
do sprawdzenia. Dla każdego podaj dane źródłowe i uzasadnienie.
Zaznacz, jeśli nie sprawdzono jeszcze naszej treści lub intencji SERP.

Trzeba przy tym wszystkim pamiętać, że konkurent obecny w wynikach wyszukiwania nie zawsze pokrywa się z realnym konkurentem biznesowym — w zestawieniach widoczności często pojawiają się duże portale informacyjne, agregatory branżowe oraz wielobranżowe e-commerce o odmiennym profilu oferty. Z tego powodu wygenerowana lista tematów powinna służyć przede wszystkim jako punkt wyjścia do weryfikacji, czy serwis posiada już dopasowaną podstronę oraz czy dana tematyka odpowiada na rzeczywiste potrzeby grupy docelowej.

Na tym etapie dysponujesz kompletnym materiałem do podjęcia decyzji redakcyjnych. Wyznaczone zadania możesz przekazać bezpośrednio autorowi treści lub osobie odpowiedzialnej za obsługę serwisu. W celu wdrożenia przygotowanych zmian bezpośrednio w plikach projektowych należy przejść do kolejnej części. Do dalszej pracy w czacie wystarczą jeszcze zasady interpretacji wyników.

Senuto MCP w Claude Code i Codex: praca na plikach strony

Teraz wchodzimy w nieco inną sytuację, czyli opieramy się na uruchomionym narzędziu programistycznym i lokalnym projekcie strony — przykładowo Visual Studio Code, który osobiście najbardziej preferuję. Poniższe przykłady zakładają, że treści lub szablony są w repozytorium. W sytuacji, kiedy treścią zarządzasz w zewnętrznym CMS, agent potrzebuje osobnego dostępu do tych danych lub ich eksportu.

Oczywiście zarówno Claude, jak i ChatGPT mogą analizować dostarczone pliki lub treść stron, jeśli mają odpowiednie narzędzia, ale praca w repozytorium daje jednak możliwość odczytu powiązanych plików, przygotowania zmian i sprawdzenia ich w środowisku projektu.

Jak podłączyć Senuto MCP do Claude Code?

W terminalu dodaj zdalny serwer:

Code
claude mcp add --transport http --scope user senuto https://mcp.senuto.com/mcp

Zakres user udostępnia konfigurację we wszystkich Twoich projektach. Domyślny local ogranicza ją do bieżącego projektu, a project zapisuje w repozytorium plik .mcp.json. Przy współdzieleniu konfiguracji Senuto każda osoba przechodzi własną autoryzację OAuth.

Uruchom Claude Code w katalogu projektu, wpisz /mcp, wybierz Senuto i dokończ logowanie w przeglądarce. W aktualnych wersjach możesz również autoryzować serwer z terminala za pomocą komendy:

Code
claude mcp login senuto
claude mcp list

Sprawdź status połączenia i poproś o widoczność swojej domeny tak jak w pierwszym teście, a jeśli pojawi się błąd autoryzacji, sprawdź dostęp do MCP na koncie Senuto i ponów logowanie z /mcp. Więcej szczegółów opisuje dokumentacja MCP w Claude Code (link w źródłach na końcu artykułu).

Jak podłączyć Senuto MCP do Codex?

W Codex CLI dodaj serwer i zaloguj się do Senuto:

Code
codex mcp add senuto --url https://mcp.senuto.com/mcp
codex mcp login senuto
codex mcp list

Konfiguracja jest zapisywana domyślnie w ~/.codex/config.toml. Możesz też użyć .codex/config.toml dla zaufanego projektu, natomiast odpowiedni wpis wygląda tak:

~/.codex/config.toml
Code
[mcp_servers.senuto]
url = "https://mcp.senuto.com/mcp"

Ręczne utworzenie wpisu stanowi alternatywę dla polecenia add, ale wciąż wymaga przejścia pełnego procesu uwierzytelnienia OAuth. W celu weryfikacji należy otworzyć sesję Codex bezpośrednio w katalogu projektu i wykonać testowe pobranie danych o widoczności domeny, postępując zgodnie z dokumentacją konfiguracji MCP w Codex (link w źródłach na końcu artykułu).

Warto przy tym pamiętać, że integrację w interfejsie ChatGPT oraz konfigurację lokalnego środowiska Codex należy testować niezależnie. Innymi słowy, nawet gdy połączymy Senuto w przeglądarce, nie oznacza to, że te same narzędzia są prawidłowo dostępne w sesji operującej na lokalnym repozytorium kodu.

Stałe instrukcje dla agenta w CLAUDE.md i AGENTS.md

Zapisanie parametrów oraz kontekstu biznesowego bezpośrednio w plikach konfiguracyjnych — CLAUDE.md dla środowiska Claude Code lub AGENTS.md dla Codex — pozwala wyeliminować konieczność ich ponownego wprowadzania przy każdej kolejnej analizie. Poniżej znajdziesz wzorzec, który może być uniwersalnym szablonem i jest gotowy do wdrożenia w obu tych środowiskach. Zmień jedynie domenę, ścieżki projektu i opis oferty, by odpowiadały Twoim potrzebom.

Fragment CLAUDE.md lub AGENTS.md
Code
## Senuto (MCP)
 
- Domena projektu: example.pl, cała domena z subdomenami, tak jak w panelu
  (fetch_mode: subdomain).
- Analiza widoczności: zawsze country_id 200 (Polska, baza 2.0).
- Baza słów kluczowych (get_keywords, get_questions, get_groups,
  get_keyword_statistics): country_id 1, bo baza 2.0 nie jest tam obsługiwana.
- Domyślnie detail_level: summary. Standard lub extended tylko wtedy,
  gdy potrzebne są pełne listy fraz.
- Przed serp_create sprawdź serp_list. Istniejące zadanie dla tej samej
  frazy może nadawać się do ponownego użycia. Sprawdź jego datę i status.
- Każdą liczbę w raporcie podawaj z nazwą narzędzia, z którego pochodzi.
  Wnioski i oceny oznaczaj jako wnioski.
- Treści bloga: content/blog/pl/*.mdx. Strony usług: src/app/(pl)/uslugi/.
  Sprawdź mapowanie URL-i na pliki przed proponowaniem zmian.
- Frazy priorytetowe (usługowe): „agencja digital marketing”,
  „pozycjonowanie stron Kraków”.

Plik opisuje sposób pracy i oczywiście jest tylko przykładem. Eksperymentuj, modyfikuj wg swoich potrzeb i miej oko na potencjalne błędy narzędzi — halucynacje i błędy wciąż mogą mieć miejsce.

Diagnoza frazy: analiza SERP zestawiona z treścią podstrony

Załóżmy, że dane potwierdziły 12. pozycję strony usługowej. W Claude Code lub Codex możesz powiązać analizę z jej plikiem źródłowym za pomocą przykładowo takiego prompta:

Code
Podstrona /uslugi/digital-marketing zajmuje 12. pozycję na frazę
„agencja digital marketing”. Zrób analizę SERP dla tej frazy, porównaj
strony z TOP10 z plikiem tej podstrony w repozytorium i zaproponuj
konkretne zmiany: tytuł, nagłówki, brakujące zagadnienia, pytania
do sekcji FAQ. Nie edytuj plików. Rekomendacje zapisz w
docs/seo/agencja-digital-marketing.md.

Agent powinien sprawdzić dostępność i aktualność raportu SERP, a w razie potrzeby zlecić analizę i zaczekać na jej zakończenie. Następnie zestawia raport z lokalną treścią strony, a jeśli raport zawiera jedynie statystyki, pełne porównanie treści wymaga dodatkowego pobrania stron konkurencji. Nie ma takich danych? Informacja o tym powinna znaleźć się w rekomendacjach.

Diagram
Przykładowa droga od raportu SERP do rekomendacji dla pliku strony.

Kanibalizacja słów kluczowych: od raportu Senuto do plików strony

Teraz skupmy się na niebezpiecznym zjawisku, jakim jest kanibalizacja. Możemy dość łatwo sporządzić raport, posługując się przykładowo takim promptem:

Code
Pobierz z Senuto frazy, na które rankuje więcej niż jeden URL example.pl.
Dla każdej pary URL-i znajdź pliki źródłowe w repozytorium i sprawdź,
czy strony odpowiadają na tę samą intencję oraz czy historia pozycji
wskazuje problem. Dopiero wtedy zaproponuj rozwiązanie: połączenie treści
z przekierowaniem 301, rozdzielenie intencji albo zmianę linkowania.
Dopuść pozostawienie obu stron bez zmian, jeśli nie ma dowodów problemu.

Raport get_cannibalization_keywords wskazuje pary do sprawdzenia w audycie SEO. Pamiętaj przy tym, że obecność kilku adresów URL w wynikach wyszukiwania na tę samą frazę kluczową nie jest wystarczającą przesłanką do stwierdzenia szkodliwej kanibalizacji. Decyzje zawsze musi poprzedzać szczegółowa analiza intencji poszczególnych podstron oraz weryfikacja ich historycznych wahań pozycji.

W sytuacji, kiedy zdecydujesz się na połączenie treści, agent może przygotować poprawki i przekierowanie we właściwej konfiguracji projektu. Przegląd powinien objąć treść docelową, linki wewnętrzne oraz działanie przekierowania.

Jak bezpiecznie wdrożyć rekomendacje SEO przez agenta?

Po wyborze poprawek zleć ograniczony zakres pracy:

Code
Wprowadź zatwierdzone zmiany z raportu docs/seo/agencja-digital-marketing.md.
Zachowaj fakty, ofertę i styl artykułu. Nie dodawaj niepotwierdzonych twierdzeń.
Pokaż zmienione pliki i diff. Uruchom dostępne w projekcie sprawdzenia
odpowiednie do zmian. Nie publikuj strony.

Przejrzyj efekt końcowy bezpośrednio w podglądzie strony. Poprawna składnia MDX oraz pomyślnie zakończony proces budowania aplikacji potwierdzają jedynie poprawność techniczną, nie stanowiąc gwarancji jakości wprowadzonych rekomendacji SEO. Po wdrożeniu modyfikacji należy precyzyjnie odnotować datę oraz pełen zakres zmian, co umożliwi późniejszą, rzetelną ocenę ich wpływu na podstawie analityki z Senuto oraz Google Search Console.

Treść z zewnętrznych stron traktuj jako materiał do analizy, a zawarte w niej polecenia nie powinny sterować agentem mającym dostęp do plików projektu. Ten problem opisuję szerzej przy agentach AI w pracy nad kodem.

Skille Claude Code i Codex do powtarzalnych analiz SEO

Musimy cały czas pamiętać, że choć serwer MCP zapewnia agentowi bezpośredni dostęp do danych, to sposób prowadzenia analiz zależy od nas i naszego doświadczenia. Uzyskanie powtarzalnych, wysokiej jakości rezultatów wymaga precyzyjnie sformułowanych poleceń, które w praktyce powtarzają się w cyklach cotygodniowych. W środowisku Claude Code procedurę tego typu można zdefiniować jako reużywalny skill — tworząc dedykowany folder z plikiem SKILL.md w katalogu .claude/skills/ (dla zakresu projektowego) lub ~/.claude/skills/ (dla zakresu globalnego). Agent automatycznie wczytuje tak przygotowany skill, gdy jego opis odpowiada realizowanemu zadaniu, bądź w momencie wywołania go bezpośrednią komendą /nazwa-skilla.

Przykładowy skill do analizy fraz z pozycji 11–20:

.claude/skills/seo-quick-wins/SKILL.md
Code
---
name: seo-quick-wins
description: Analiza fraz na pozycjach 11–20 w Senuto i plan optymalizacji
  istniejących podstron. Używaj, gdy użytkownik pyta o szybkie wygrane SEO,
  frazy tuż za TOP10 lub priorytety optymalizacji treści.
---
 
# Szybkie wygrane SEO
 
1. Pobierz statystyki domeny (get_domain_statistics, country_id 200)
   i zapisz liczbę fraz w TOP3/10/50.
2. Pobierz frazy z pozycji 11–20 (get_positions_data). Oznacz frazy
   bez danych o wolumenie i brandowe konkurencji do osobnej oceny.
3. Pogrupuj frazy według rankującego URL-a i znajdź plik źródłowy
   każdego URL-a w repozytorium.
4. Dla pięciu grup o najwyższym priorytecie przeczytaj plik i sprawdź:
   czy title i nagłówki jasno opisują temat, jakich zagadnień
   brakuje i czy intencja podstrony odpowiada frazie. Nie wymuszaj
   dokładnej frazy w każdym nagłówku.
5. Zapisz wynik w docs/seo/quick-wins-RRRR-MM-DD.md: tabela fraz,
   lista zmian dla każdego pliku, lista rzeczy do ręcznej weryfikacji.
6. Nie edytuj plików treści bez wyraźnej prośby.

To przykład struktury skilla Claude Code, który łączy trzy elementy: dane z Senuto, wiedzę o tym, jak prowadzić analizę, i znajomość struktury projektu. Na tej samej zasadzie możesz zbudować skille do miesięcznego raportu widoczności, analizy konkurencji albo planowania treści pod frazy pytające.

Z kolei Codex obsługuje skille w tym samym formacie (SKILL.md z polami name i description), ale szuka ich w .agents/skills/ w repozytorium lub w ~/.agents/skills/ dla wszystkich projektów, a jawnie wywołujesz je przez $nazwa-skilla.

Dlaczego wyniki z Senuto MCP różnią się od panelu?

Po podłączeniu integracji częstym zjawiskiem są rozbieżności pomiędzy liczbą fraz w przedziałach TOP3, TOP10 i TOP50 wykazywaną przez agenta a danymi widocznymi w panelu Senuto dla tej samej domeny — sięgające np. sześciu słów kluczowych w TOP10 według agenta przy zaledwie trzech w panelu.

Główną przyczyną tego stanu rzeczy jest domyślna konfiguracja parametru country_id. Dla rynku polskiego serwer MCP obsługuje dwie osobne bazy danych: bazę 1.0 (1) oraz bazę 2.0 (200). Choć Senuto rekomenduje korzystanie z wersji 2.0 jako najbardziej aktualnej i precyzyjnej, to wersja 1.0 oferuje dłuższą historię pomiarów. W przypadku braku jawnie zdefiniowanego parametru country_id API automatycznie odwołuje się do bazy 1.0, co sprawia, że agent przeprowadzający analizę operuje na innym zbiorze danych niż panel graficzny.

Warto kontrolować jeszcze dwa kluczowe parametry konfiguracyjne:

  • fetch_mode — określa zakres analizowanej struktury serwisu:

    • topLevelDomain — ogranicza analizę wyłącznie do wskazanego hosta z wyłączeniem subdomen.
    • subdomain — uwzględnia domenę wraz ze wszystkimi jej subdomenami.

    Uwaga: Serwer MCP stosuje domyślnie tryb topLevelDomain, podczas gdy panel graficzny Senuto operuje na trybie subdomain i zgodnie z dokumentacją jest to najczęstsze źródło rozbieżności w prezentowanych danych. Wybrane końcówki API obsługują ponadto tryby catalog (dla konkretnych katalogów, np. /blog) oraz url (dla pojedynczych adresów podstron).

  • detail_level (summary, standard, extended) — steruje objętością zwracanego obiektu odpowiedzi. Wariant summary jest w pełni wystarczający dla przeważającej większości zadań analitycznych, pozwalając na optymalne zarządzanie oknem kontekstowym modelu.

W interfejsach konwersacyjnych powyższe wytyczne ustal na samym początku sesji, a w środowiskach projektowych zapisz je na stałe w pliku CLAUDE.md lub AGENTS.md. Zestawiając ze sobą gotowe raporty, zweryfikuj dodatkowo znacznik czasowy pobranych danych oraz zestaw zastosowanych filtrów.

Limity Senuto MCP: jedna pula dla panelu, API i agenta

Wywołania przez MCP zużywają te same liczniki co praca w panelu i zapytania do REST API. Nie istnieje osobny limit dla MCP, a zasady naliczania według dokumentacji Senuto są następujące:

NarzędziaKiedy zużywają limit
narzędzia analizy widoczności (get_domain_statistics, get_positions_data, get_urls i pokrewne)jedna jednostka za nową kombinację domeny, fetch_mode i country_id; kolejne raporty z tą samą kombinacją w ciągu 24 godzin nie zużywają kolejnej jednostki tego limitu
get_keywords, get_questionsjedna jednostka za każdą nową frazę, domenę lub URL podany jako punkt wyjścia; ten sam punkt wyjścia powtórzony w ciągu 24 godzin nie zużywa limitu
get_keyword_statisticsjedna jednostka za wywołanie, niezależnie od liczby fraz (do 500)
serp_createjedna jednostka limitu analizy SERP za nową frazę; istniejące zadanie nie jest naliczane
narzędzia monitoringu (rt_*), get_groups, serp_list, serp_check, serp_get_report, get_limitsnie zużywają limitów

Wnioski praktyczne:

  • Zmiana bazy z 1.0 na 2.0 w trakcie analizy to nowa jednostka. To kolejny powód, żeby ustalić parametry na początku rozmowy lub w instrukcjach projektu.

  • Wolumeny dla wielu fraz pobieraj jednym wywołaniem get_keyword_statistics, a nie frazą po frazie.

  • Przed dużą analizą poproś agenta o get_limits.
  • Błąd 418 w trakcie rozmowy najczęściej oznacza wyczerpany limit modułu. Agent, który wpadnie w pętlę, może zużyć limit potrzebny Ci później w panelu.

Najważniejsze narzędzia serwera Senuto MCP

Nie musisz uczyć się ich nazw, żeby używać MCP. Ta tabela pomaga sprawdzić, czy asystent pobrał właściwy typ danych.

Narzędzia, z których korzysta się najczęściej:

NarzędzieCo zwraca
get_domain_statisticswidoczność domeny, liczbę fraz w TOP3, TOP10 i TOP50, ekwiwalent Ads, frazy z AI Overviews i cytowania domeny
get_positions_datafrazy, na które rankuje domena, z pozycjami i widocznością
get_competitorskonkurentów domeny z porównaniem metryk
get_urlspojedyncze adresy URL rankujące w wynikach
get_cannibalization_keywordsfrazy, o które konkuruje kilka URL-i tej samej domeny
get_keyword_statisticswolumen, CPC i trend dla podanych fraz, do 500 na jedno wywołanie
serp_create, serp_get_reportanalizę dla frazy: rankujące URL-e, statystyki treści, pytania, frazy powiązane
rt_get_position_datadzienną historię pozycji z projektów w module Monitoring
get_limitsstan wszystkich limitów konta

Pełna lista wraz z odpowiednikami w REST API jest w dokumentacji serwera MCP Senuto (link w źródłach na końcu artykułu).

Jak interpretować dane z Senuto MCP i łączyć je z Search Console?

Pozycje i wskaźniki w Senuto opisują obecność domeny w bazie fraz tego narzędzia. Google Search Console dostarcza danych o wyświetleniach i kliknięciach w wyszukiwarce. Jeśli udostępnisz oba źródła, możesz zestawić wzrost widoczności z kliknięciami, zachowując ich różne zakresy i metodologie.

Do rzetelnej oceny zaleceń treściowych niezbędny jest bezpośredni dostęp do samej zawartości podstrony — w interfejsie czatu można przekazać ją w postaci pliku lub pobrać za pomocą dedykowanego narzędzia sieciowego. Z kolei w środowisku repozytorium agent automatycznie odczytuje pliki lokalne, jednak pobieranie danych z zewnętrznych systemów CMS bądź serwisów konkurencji wciąż wymaga osobnej integracji. Przy pracy trzeba też pamiętać, że same polecenia np. o porównaniu treści nie stanowią gwarancji, że model przeanalizował wskazane materiały, dlatego dobrą praktyką jest wykazanie źródeł w odpowiedzi agenta.

W przypadku obszernych raportów konieczne jest ograniczenie zakresu analizy do wybranych adresów URL lub priorytetowych fraz kluczowych. Należy przy tym pamiętać, że obcięta odpowiedź API nie reprezentuje pełnego zbioru danych — narzędzia Senuto zwracają maksymalnie 100 rekordów w pojedynczym wywołaniu, natomiast dane o pozycjach z modułu monitoringu ograniczają się do 50 wyników. Praca na kompletnych zestawieniach wymaga od agenta bezwzględnej weryfikacji parametrów paginacji, zastosowanych filtrów oraz faktycznej liczby pobranych rekordów.

Audyt techniczny i optymalizacja pod kątem SEO i GEO.
Audyt techniczny SEO

Często zadawane pytania

Czy do podłączenia Senuto MCP trzeba umieć programować?

Nie. W Claude i ChatGPT dodajesz połączenie w interfejsie aplikacji, logujesz się do Senuto i opisujesz zadanie w rozmowie. Potrzebujesz dostępu do MCP na koncie Senuto i możliwości dodawania własnych połączeń w wybranej aplikacji AI. Claude Code i Codex przydają się, gdy chcesz pracować bezpośrednio na plikach strony i tutaj wchodzisz już w programowanie agentowe - wszelkie zmiany powinien wprowadzać ktoś kto zna się na programowaniu.

Czy do Senuto MCP potrzebny jest klucz API?

Nie. Serwer MCP uwierzytelnia się przez OAuth. Przy pierwszym użyciu klient otwiera ekran logowania Senuto, a po zalogowaniu przechowuje dostęp samodzielnie. Token REST API nie jest do tego potrzebny i nie jest z nim związany.

Dlaczego agent pokazuje inne liczby niż panel Senuto?

Jedną z przyczyn jest wybór innej bazy danych. W analizie widoczności Polska ma bazę 1.0 (country_id: 1) i zalecaną bazę 2.0 (country_id: 200), a bez podanego parametru API sięga po bazę 1.0. Drugą przyczyną bywa fetch_mode: MCP domyślnie analizuje sam host (topLevelDomain), a panel całą domenę z subdomenami (subdomain). Sprawdź też datę danych i filtry raportu.

Czy korzystanie z MCP zużywa limity Senuto?

Tak. Wywołania przez MCP korzystają z tej samej puli co panel i REST API. Analiza widoczności nalicza jednostkę za nową domenę z danym zestawem parametrów, a kolejne zapytania o tę samą domenę z tymi samymi parametrami w ciągu 24 godzin nie zużywają kolejnej jednostki tego limitu. Narzędzia monitoringu i odczyt gotowych raportów SERP nie zużywają limitów.

Claude Code czy Codex?

Oba narzędzia obsługują zdalne serwery MCP z OAuth i oba pracują na plikach w repozytorium. Różnią się konfiguracją: Claude Code dodaje serwer poleceniem claude mcp add, a stałe instrukcje czyta z CLAUDE.md. Codex używa codex mcp add lub pliku config.toml oraz instrukcji z AGENTS.md. W obu przypadkach podaj kontekst biznesowy i sprawdzaj parametry analizy. Pamiętaj też, że wymieniłem je w artykule, bo są najpopularniejsze, a Sanuto umożliwia połączenie z innymi narzędziami AI.

Czy MCP Senuto działa w planie Basic?

Tak, jako dodatek „Dostęp do MCP” za 69 zł netto miesięcznie, który włączasz w panelu, ale nie obejmuje REST API. Zaraz przed większą analizą sprawdź pozostałe limity konta, ponieważ korzystasz z tej samej puli w panelu i przez MCP.

Czy agent może sam wprowadzać zmiany na stronie?

Claude Code i Codex mogą edytować pliki projektu, jeśli mają do nich dostęp i uprawnienia. Bezpieczniejszy tryb pracy to zapisanie rekomendacji w osobnym pliku, a po akceptacji wprowadzenie zmian małymi commitami i przegląd diffu przed wdrożeniem. Dotyczy to zwłaszcza przekierowań oraz łączenia treści.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat SEO

Czytaj dalej

Zobacz więcej wpisów
Jak pracować z narzędziami SEO?

Większość audytów SEO zaczyna się od chaosu. Narzędzia wypluwają wykluczające się liczby, wykresy idą w różne strony, a Ty musisz z tego wyciągnąć sensowne wnioski. Narzędzia SEO nie są nieomylne – to tylko soczewki, z których każda pokazuje inny fragment obrazu. W tym przewodniku pokazuję, jak połączyć popularne panele w jeden spójny system. Zamiast skakać między kartami i zgadywać, komu wierzyć, dostaniesz prosty schemat: od chłodnej analizy danych do decyzji, która przynosi realny efekt.

Maciej Sala

Maciej Sala

Founder StriveLab

Serwer MCP w TypeScript: bezpieczny przewodnik dla Next.js

Model Context Protocol standaryzuje sposób, w jaki aplikacja AI odkrywa narzędzia, odczytuje zasoby i korzysta z gotowych promptów. W tym przewodniku zbudujesz lokalny serwer w TypeScript SDK v2, zabezpieczysz operację zapisu i poznasz wymagania zdalnego wdrożenia przez Streamable HTTP.

Maciej Sala

Maciej Sala

Founder StriveLab

Programowanie z AI: Claude, ChatGPT czy Gemini?

Rynek asystentów AI dla deweloperów nadal zmienia się bardzo szybko, ale trzy nazwy wracają zdecydowanie najczęściej: Claude, ChatGPT i Gemini. Praktycznie każde z tych narzędzi potrafi dziś realnie przyspieszać pracę z kodem, dokumentacją i analizą, ale każde robi to trochę inaczej. Praca z nimi wymaga też ostrożności, dlatego warto zapoznać się z polityką prywatności danego narzędzia.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G