PL
Zacznij za darmo

Claude Code + Semurai

Claude Code do SEO
jednym poleceniem.

Dodaj serwer MCP Semurai do Claude Code jednym poleceniem w terminalu, a Claude Code będzie pracować na Twoich frazach, pozycjach, danych z Search Console i audytach strony, edytując repozytorium. Uruchamiaj prompty Semurai jako polecenia z ukośnikiem, zapisuj raporty obok kodu i udostępnij konfigurację zespołowi. Logowanie OAuth, bez kluczy API.

Zacznij za darmoPoradnik konfiguracji

Claude Code MCP · zakres local, project lub user

Dodaj z terminala

Terminal
claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp
  • Uruchom /mcp, wybierz semurai i zaloguj się
  • Sześć promptów Semurai w menu /
  • Albo użyj konektora z claude.ai

Konfiguracja

Jak dodać Semurai
do Claude Code?

Jedno polecenie dodaje serwer, jedno logowanie łączy Twoje konto Semurai. Potem Semurai jest dostępne w każdym projekcie.

  1. W terminalu uruchom claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp.

  2. Uruchom Claude Code w dowolnym projekcie, wpisz /mcp i wybierz semurai.

  3. W przeglądarce otworzy się Semurai. Zaloguj się, wybierz domyślny workspace i kliknij Zezwól.

  4. Pisz do Claude Code zwyczajnie albo wpisz /, żeby uruchomić jeden z promptów Semurai.

Terminal
claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp
Albo zaloguj się z powłoki
claude mcp login semurai

Warto wiedzieć

  • Semurai jest już konektorem w claude.ai? Jeśli korzystasz z Claude Code na tym samym koncie, Semurai pojawi się w /mcp bez claude mcp add.
  • --scope user udostępnia Semurai we wszystkich Twoich projektach. Pozostałe zakresy opisujemy niżej.
  • Konfigurację sprawdzisz poleceniem claude mcp list, a sam wpis Semurai poleceniem claude mcp get semurai.

Po co łączyć

Sam Claude Code
czy Claude Code z Semurai?

Claude Code zna już Twoje pliki. Semurai mówi mu, jak te strony radzą sobie w wyszukiwarce.

  1. Sam Claude Code

    Przepisuje tytuł tylko na podstawie treści strony.

    Claude Code z Semurai

    Przepisuje go dla stron, które w Search Console mają dużo wyświetleń i mało kliknięć.

  2. Sam Claude Code

    Dobiera nagłówki, nie wiedząc, czego ludzie szukają.

    Claude Code z Semurai

    Najpierw sprawdza liczbę wyszukiwań, trudność i intencję każdego nagłówka.

  3. Sam Claude Code

    Zapomina o frazach, gdy nowa strona trafi na produkcję.

    Claude Code z Semurai

    Dodaje frazy nowej strony do monitorowania pozycji, zanim strona ruszy.

  4. Sam Claude Code

    Zostawia kolejne kroki w terminalu.

    Claude Code z Semurai

    Umieszcza kolejne kroki na tablicy zadań w Semurai.

Zastosowania

Co Claude Code może robić
z Semurai?

SEO z poziomu terminala dla stron budowanych z kodu: treści w Markdownie, szablony w repozytorium, zmiany do przejrzenia jako diff.

  • SEO stron z treścią w repozytorium

    Astro, Next.js, Hugo albo folder z dokumentacją: Claude Code czyta Twoje pliki z treścią, a Semurai podpowiada, na jakie frazy powinna celować każda strona.

  • Prompty Semurai jako polecenia z ukośnikiem

    Wpisz / i uruchom seo_article, competitor_gap_report albo weekly_seo_report jak każde inne polecenie Claude Code, z folderu, w którym pracujesz.

  • Raport tygodniowy obok kodu

    Tygodniowy raport SEO trafia do repozytorium jako plik Markdown: pozycje, ruch, kondycja strony, wyniki treści, otwarte zadania i kolejne kroki.

  • Luka fraz zamieniona w zadania

    Claude Code porównuje Twoją domenę z maksymalnie pięcioma konkurentami i umieszcza tematy warte osobnej strony na tablicy zadań w Semurai, każdy z krótką instrukcją.

  • Monitorowanie pozycji nowych stron

    Zanim nowa strona ruszy, Claude Code dodaje jej frazy do monitorowania pozycji, do 50 naraz, a Semurai od razu zleca pierwsze sprawdzenie.

  • Jeden .mcp.json dla zespołu

    Dodaj konfigurację projektu do repozytorium (commit) raz. Każdy programista loguje się do Semurai osobno, a to, co może zrobić, wynika z jego roli w danym workspace.

Przykład

Tygodniowy raport SEO
zapisany w repozytorium.

Wspólny .mcp.json zespołu, jedno polecenie z ukośnikiem i plik raportu obok kodu.

  1. Ty:

    /semurai:weekly_seo_report

  2. Narzędzie Semurai: semurai.get_workspacemorrowfield.coffee
  3. Narzędzie Semurai: semurai.list_tracked_keywords48 fraz
  4. Narzędzie Semurai: semurai.get_ranking_history6 największych zmian
  5. Narzędzie Semurai: semurai.search_console_reportostatnie 7 dni wobec 7 poprzednich
  6. Narzędzie Semurai: semurai.get_site_auditostatni audyt
  7. Narzędzie Semurai: semurai.get_performance_reportostatnie artykuły
  8. Narzędzie Semurai: semurai.list_tasksotwarte zadania
  9. Asystent:

    Tydzień 44 w porównaniu z tygodniem 43. Pozycje: 7 fraz w górę, 3 w dół. Największe zmiany:

    FrazaPozycjaZmiana
    proporcje cold brew6+5
    mielenie kawy do kawiarki11+4
    espresso bez kofeiny ziarna14-3
    proporcje french press9-2

    Search Console: 1240 kliknięć (+9%), CTR 2,4%. Kondycja strony 86/100, 7 otwartych zadań. Zapisać raport jako reports/seo-week-44.md i dodać pięć kolejnych kroków do tablicy zadań?

  10. Ty:

    Tak, jedno i drugie.

  11. Narzędzie Semurai: semurai.create_tasks5 zadań
  12. Asystent:

    Gotowe. Plik reports/seo-week-44.md ma wszystkie sześć sekcji, od pozycji po kolejne kroki, a pięć zadań czeka na tablicy w Semurai.

Projekt demo: Morrowfield Coffee Co. (dane przykładowe). Przykład promptu weekly_seo_report uruchomionego jako polecenie z ukośnikiem w Claude Code, z ośmioma narzędziami Semurai.

Prompty do wypróbowania

Napisz do Claude Code
na przykład tak.

  • „Uruchom /semurai:weekly_seo_report i zapisz raport jako reports/seo-week-44.md.”
  • „Znajdź lukę fraz względem zapisanych konkurentów i dodaj pięć najlepszych tematów do tablicy zadań w Semurai.”
  • „Zbuduj w Semurai klaster tematyczny „cold brew” i zaproponuj strukturę folderów w src/content/poradniki.”
  • „Sprawdź liczbę wyszukiwań i trudność nagłówków H2 w tym wpisie i powiedz, które zostawić.”
  • „Dodaj frazy docelowe stron z src/content/poradniki do monitorowania pozycji w Semurai.”

Zakresy

Zakres local, project
czy user?

Claude Code przechowuje każdy serwer MCP w jakimś zakresie. Wybierz ten, który pasuje do tego, kto ma korzystać z Semurai i gdzie.

Który zakres wybrać

Zakresy serwera MCP Semurai w Claude Code
ZakresKto korzystaGdzie działaGdzie jest zapisany
local (domyślny)Tylko TyTylko bieżący projekt~/.claude.json, pod ścieżką projektu
projectKażdy, kto pracuje w repozytoriumTen projekt.mcp.json w katalogu głównym projektu
userTylko TyWszystkie Twoje projekty~/.claude.json

Polecenie na górze strony używa --scope user. Pomiń tę flagę, jeśli wystarczy Ci zakres local, albo użyj --scope project, żeby zapisać plik dla zespołu.

Wspólna konfiguracja w .mcp.json

Dodaj ten plik do katalogu głównego repozytorium (commit) albo uruchom polecenie z --scope project. Claude Code prosi każdą osobę o zgodę na serwer projektu, zanim go użyje, a potem każdy loguje się do Semurai własnymi danymi.

.mcp.json
{
  "mcpServers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Prompty i skille

Polecenia z ukośnikiem
i skille SEO dla Claude.

Sześć gotowych promptów Semurai działa w Claude Code jako polecenia z ukośnikiem i dobrze współpracuje z Twoimi skillami.

Prompty Semurai jako polecenia z ukośnikiem

Wpisz / w Claude Code, a prompty Semurai pojawią się w menu jako /semurai:seo_article (MCP) i kolejne. Polecenie /mcp__semurai__weekly_seo_report też uruchamia prompt.

  • /semurai:seo_article: temat, fraza główna, język
  • /semurai:competitor_gap_report: domena konkurenta
  • /semurai:weekly_seo_report: bez argumentów
  • /semurai:monthly_content_plan: miesiąc, tematyka
  • /semurai:store_product_seo: sklep, kategoria
  • /semurai:social_week: temat, kanały

W regułach uprawnień narzędzia Semurai mają nazwy mcp__semurai__<narzędzie>, na przykład mcp__semurai__research_keywords.

Skill SEO dla Claude czy konektor MCP?

Nie musisz wybierać. Skill uczy Claude, jak wykonać zadanie: to instrukcje w folderze, które Claude wczytuje, gdy zadanie się pojawia. Serwer Semurai daje Claude aktualne dane i działania w Twoim workspace.

  • Skill: Twoje zasady dla tytułów, nagłówków, front matter i tonu.
  • Semurai: dane o frazach, pozycje, Search Console, audyty, szkice i publikacja.
  • Razem: skill mówi, jak wygląda dobry tytuł na Twojej stronie, a Semurai dostarcza zapytania i liczby, na których się opiera.

Inni asystenci

Korzystaj z Semurai
w innym asystencie.

Ten sam adres serwera i to samo konto Semurai działają w każdym asystencie poniżej.

FAQ

Claude Code i Semurai: pytania

Jak dodać serwer MCP do Claude Code?

Uruchom claude mcp add z transportem, zakresem, nazwą i adresem. Dla Semurai: claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp. Potem wpisz /mcp w Claude Code, wybierz semurai, zaloguj się do Semurai w przeglądarce i kliknij Zezwól.

Czy Claude Code MCP działa ze zdalnym serwerem, takim jak Semurai?

Tak. Claude Code dodaje zdalne serwery MCP przez HTTP, stąd --transport http w poleceniu claude mcp add. Semurai jest właśnie takim serwerem: działa pod adresem https://api.semur.ai/mcp, a logowanie odbywa się przez OAuth w przeglądarce, bez kluczy API.

Jaki zakres wybrać dla Semurai?

Zakres user, jeśli chcesz mieć Semurai w każdym projekcie na swoim komputerze. Zakres project, jeśli cały zespół pracuje nad jedną stroną i ma dzielić konfigurację przez .mcp.json. Domyślny zakres local ogranicza serwer do Ciebie i bieżącego projektu.

Gdzie Claude Code zapisuje serwer Semurai?

Serwery z zakresu local i user trafiają do ~/.claude.json, a serwery projektu do .mcp.json w katalogu głównym projektu. claude mcp list pokazuje wszystkie skonfigurowane serwery, a claude mcp get semurai sam wpis Semurai.

Jak uruchomić prompt Semurai w Claude Code?

Wpisz / i wybierz prompt Semurai z menu, na przykład /semurai:seo_article (MCP) albo /semurai:weekly_seo_report (MCP). Raport tygodniowy uruchomisz też poleceniem /mcp__semurai__weekly_seo_report.

Czy zespół może korzystać z jednej konfiguracji Claude Code?

Tak. Dodaj Semurai z zakresem project albo dodaj do repozytorium (commit) plik .mcp.json z wpisem semurai. Claude Code poprosi każdą osobę o zgodę na serwer projektu, a potem każdy loguje się do Semurai na własne konto i działa w ramach swojej roli w danym workspace.

Jak wylogować się z Semurai albo usunąć je z Claude Code?

claude mcp logout semurai usuwa zapisane logowanie, a claude mcp remove semurai usuwa serwer z konfiguracji. Żeby zakończyć dostęp po stronie Semurai, odłącz Claude Code w Ustawieniach, w sekcji Asystenci AI (MCP).

Czy Claude Code stworzy grafiki w Semurai?

Tak, gdy dodasz serwer pełny pod osobną nazwą: uruchom claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full, potem claude mcp login semurai-full (albo wybierz semurai-full w /mcp) i kliknij Zezwól. Claude Code wygeneruje wtedy obrazy do biblioteki mediów i dostanie adres każdego z nich do edytowanej strony, a także przygotuje projekty w Canvas albo Creative Studio na podstawie briefu. Odpowie też na pytania projektanta, poprawi projekt i zapisze jego strony w bibliotece mediów jako PNG, JPG lub PDF. Wpis semurai działa dalej jak wcześniej, a grafiki zużywają limity użycia workspace.

Czy Claude Code może zmienić moją stronę na żywo przez Semurai?

Zmiany w plikach zostają w repozytorium, dopóki ich nie zacommitujesz i nie wdrożysz. Semurai oznacza narzędzia, które zmieniają coś na żywo, na przykład publikację w WordPressie albo dodanie posta do kolejki, a Claude Code upewnia się u Ciebie, zanim któreś z nich uruchomi.

Przenieś Semurai
do terminala.

Załóż konto w Semurai, uruchom jedno polecenie i zapytaj Claude Code o swoją stronę.

  • Darmowy plan na zawsze
  • Bez karty płatniczej
  • Start w około 3 minuty