WP-CLI i MCP: wszystkie polecenia i narzędzia
Ta strona opisuje wszystko, co możesz zrobić w Spark Speed 0.73.2 bez ekranu administracyjnego: polecenia WP-CLI na serwerze oraz narzędzia MCP, których asystent AI, taki jak Claude lub ChatGPT, używa do pracy z Twoją witryną. Przeznaczona dla administratorów i agencji, które pracują z wierszem poleceń lub asystentem AI; do codziennego zarządzania tego nie potrzebujesz.
W skrócie
- Każde polecenie zaczyna się od wp spark-speed i działa na serwerze
- mcp token i ai apply istnieją tylko z ważną licencją; diagnostics odmawia bez niej
- MCP wymaga ważnej licencji i autoryzowanego klienta działającego jako administrator
- start_optimization wymaga otwartego pulpitu w przeglądarce dla kontroli przeglądarki
Status i cache
Szybko zobacz, jak wygląda cache, wyczyść go i sprawdź, co dostają odwiedzający.
wp spark-speed status
- Co robi
- Pokazuje stan cache w pięciu wierszach: która wtyczka zarządza plikiem drop-in cache (plikiem, który WordPress ładuje wcześnie dla cache stron), czy WP_CACHE jest włączone, ile stron jest w cache, ile adresów czeka w kolejce i czy opcjonalny lokalny worker jest osiągalny. Przydatne do szybkiego podglądu bez otwierania wp-admin.
- Kiedy używać
- Po aktualizacji, migracji lub czyszczeniu cache albo w skrypcie monitorującym.
- Jak sprawdzić efekt
- Wynik jest po angielsku:
Drop-in owner,WP_CACHE,Cached pages,Queue pending,Worker.Worker : OFFLINEjest normalne: worker jest opcjonalny i nie ma go w pliku zip; Spark używa wtedy ścieżki PHP. - Przykład
wp spark-speed status- Jak cofnąć
- Nie ma czego cofać: polecenie tylko odczytuje.
wp spark-speed purge
- Co robi
- Czyści cały cache stron. Strony są potem budowane od nowa przy następnej wizycie lub przez rozgrzewacz cache.
- Kiedy używać
- Gdy odwiedzający widzą nieaktualną wersję albo po dużej zmianie motywu lub ustawień.
- Jak sprawdzić efekt
- Zobaczysz
Page cache purged.Za pomocąwp spark-speed statuszobaczysz spadekCached pages. - Przykład
wp spark-speed purge- Uwaga
- Dopóki cache nie zostanie odbudowany, pierwsze wizyty są wolniejsze. Nie czyści to pamięci podręcznej obiektów; służy do tego
flush-object-cache. - Jak cofnąć
- Nie można cofnąć. Odbuduj cache poleceniem
wp spark-speed optimize --alla potemwp spark-speed warm.
wp spark-speed flush-object-cache
- Co robi
- Czyści pamięć podręczną obiektów (tymczasowy magazyn wyników bazy danych, na przykład w Redis, Memcached, APCu lub SQLite), która działa przez drop-in pamięci podręcznej obiektów Spark. Jest to celowo oddzielone od cache stron.
- Kiedy używać
- Gdy podejrzewasz nieaktualne dane w pamięci podręcznej obiektów. Spark nie czyści jej automatycznie.
- Wymagania
- Działająca pamięć podręczna obiektów Spark. W przeciwnym razie dostaniesz ostrzeżenie.
- Jak sprawdzić efekt
- Komunikat o powodzeniu albo ostrzeżenie, gdy nie było czego czyścić.
- Przykład
wp spark-speed flush-object-cache- Uwaga
- Zaraz po wyczyszczeniu WordPress znów więcej odpytuje bazę danych.
- Jak cofnąć
- Niepotrzebne: pamięć podręczna obiektów napełnia się sama.
wp spark-speed verify-cache
- Co robi
- Pobiera jedną stronę Twojej witryny jako odwiedzający na komputerze i na telefonie i zwraca ocenę w JSON: jaki status cache został podany i czy pasuje do obecnego kodu i ustawień.
- Kiedy używać
- Po zmianie, aby sprawdzić, czy odwiedzający dostają nową wersję z cache.
- Wymagania
--pagez pełnym adresem w tej witrynie, bez query stringa. Bez--pagepolecenie kończy się błędem.- Jak sprawdzić efekt
- JSON zawiera
ok. Kod wyjścia to 0, gdy wszystko się zgadza, i 2, gdy nie, więc możesz użyć tego w skrypcie. - Przykład
wp spark-speed verify-cache --page=https://example.com/product/example/- Jak cofnąć
- Nie ma czego cofać: polecenie tylko odczytuje.
Budowanie cache
Optymalizuj strony, przetwarzaj kolejkę oraz śledź i wznawiaj budowanie cache. To samo budowanie zobaczysz w panelu na karcie Cache.
wp spark-speed optimize
- Co robi
- Bez dodatkowych opcji przebudowuje stronę główną, zoptymalizowaną i zapisaną w cache dla każdego urządzenia. Za pomocą
--page=<address>robisz to dla jednej strony. Za pomocą--allkolejkujesz każdą stronę witryny; właściwą pracę wykonujesz potem za pomocąprocesslubwarm. - Kiedy używać
- Po czyszczeniu cache albo gdy chcesz mieć jedną ważną stronę od razu gotową.
- Wymagania
- Użyj
--page, a nie--url: WP-CLI już rezerwuje--url. - Jak sprawdzić efekt
- Jeden wiersz na urządzenie z wynikiem, na przykład
oklub powód, dla którego się nie udało. Za pomocą--allzobaczysz, ile adresów trafiło do kolejki. - Przykład
wp spark-speed optimize --page=https://example.com/shop/- Uwaga
- Gdy hamulec bezpieczeństwa (tryb bezpieczny) jest włączony lub optymalizacja jest wyłączona, strony są tylko zapisywane w cache, a nie optymalizowane.
- Jak cofnąć
- Wyczyść cache tej strony lub cały cache.
wp spark-speed process
- Co robi
- Przetwarza teraz część kolejki, domyślnie 20 adresów. Używa tej samej blokady co przetwarzanie w tle, więc nigdy sobie nie przeszkadzają.
- Kiedy używać
- Aby przetwarzać pełną kolejkę etapami, na przykład po
optimize --all. - Wymagania
- Kolejka z adresami. Liczbę zmienisz za pomocą
--limit=<number>. - Jak sprawdzić efekt
- Jeden wiersz na adres z wynikiem dla każdego urządzenia, a na końcu
Batch done. Remaining: N. - Przykład
wp spark-speed process --limit=50- Uwaga
- Obciąża serwer, dopóki działa. Jeśli inny proces trzyma blokadę, nic nie jest przetwarzane.
- Jak cofnąć
- Nie dotyczy.
wp spark-speed warm
- Co robi
- Przetwarza całą kolejkę aż do opróżnienia, domyślnie w porcjach po 25. Gdy nie ma postępu, ustala dlaczego. Jeśli zajęty jest inny proces, informuje o tym i kończy; z
--waitczeka na blokadę do 15 minut. - Kiedy używać
- Na witrynach o małym ruchu, gdzie WP-Cron sam nie działa wystarczająco często, albo po pełnym czyszczeniu cache.
- Wymagania
- Witryna musi móc połączyć się sama ze sobą (loopback), ponieważ rozgrzewacz pobiera Twoje własne strony. Rozmiar porcji zmienisz za pomocą
--batch=<number>. - Jak sprawdzić efekt
- W każdej rundzie
remaining: N (cached M)oraz podsumowanie. Kod wyjścia to 0, gdy kolejka jest pusta, 1, gdy zostało coś do zrobienia, i 2, gdy rozgrzewacz jest zablokowany lub utknął. - Przykład
wp spark-speed warm --wait- Uwaga
- Może trwać długo i obciąża serwer. Witryna w trybie konserwacji lub za ochroną przed botami, która zwraca 403, powoduje błędy stron.
- Jak cofnąć
- Zatrzymaj za pomocą Ctrl+C. Zbudowany cache możesz wyczyścić poleceniem
purge.
wp spark-speed warm-status
- Co robi
- Pokazuje, jak idzie budowanie cache: stan i od kiedy, jak długo nic się nie działo, przyczynę, kolejkę, strony w cache w stosunku do całości, ewentualną pauzę, nieudane adresy i ostatni test. Za pomocą
--jsondostaniesz wszystko jako JSON. - Kiedy używać
- Gdy budowanie nie postępuje albo w monitorze, który śledzi kod wyjścia.
- Jak sprawdzić efekt
- Wiersze mają niderlandzkie etykiety (
stand,sinds,wachtrij,gecached,pauze,fails,laatste toets). Kod wyjścia 0 oznacza stan zdrowy, 1 znaną przyczynę, 2 zablokowanie, a 3, że nie da się ustalić stanu. - Przykład
wp spark-speed warm-status --json- Jak cofnąć
- Nie ma czego cofać: polecenie tylko odczytuje.
wp spark-speed warm-hervat
- Co robi
- Testuje wstrzymane budowanie cache prawdziwą próbą na pierwszym adresie w kolejce i wznawia budowanie, gdy witryna odpowiada poprawnie. To wersja wiersza poleceń przycisku wznawiającego budowanie na karcie Cache.
- Kiedy używać
- Po usunięciu przyczyny pauzy, na przykład błędu loopback lub ochrony przed botami.
- Wymagania
- Otwarta pauza. Bez pauzy zgłasza
Er stond geen pauze open.. - Jak sprawdzić efekt
- Gdy wznowi, zobaczysz
Hervat.z kolejką i liczbą stron w cache (kod wyjścia 0). Gdy się nie uda, pojawi się ostrzeżenieNiet hervat: <reason>(kod wyjścia 1). Potem sprawdź za pomocąwarm-status. - Przykład
wp spark-speed warm-hervat- Uwaga
- Jeśli witryna nadal zwraca błędy, pauza pozostaje.
- Jak cofnąć
- Nie dotyczy.
Sklep, klienci i plan ładowania
Te polecenia obsługują funkcje, które znajdziesz też w panelu, z tym samym testem na początku. Podpolecenia to niderlandzkie słowa: aan (włączone), uit (wyłączone), proef (test), legen (wyczyść).
wp spark-speed winkelwagen
- Co robi
- Obsługuje cache dla odwiedzających z pełnym koszykiem, tę samą funkcję co Cached pages with a filled cart na karcie Cart and logged-in customers.
status(domyślnie) pokazuje stan i ostatni test.proefuruchamia test.aanwłącza funkcję, auitją wyłącza. - Kiedy używać
- W sklepie WooCommerce, gdzie kupujący z czymś w koszyku w przeciwnym razie za każdym razem dostaliby w pełni zbudowaną, wolną stronę.
- Wymagania
- WooCommerce.
aandziała tylko po udanym teście lub z--bevestigdpo samodzielnym przejrzeniu znalezionej różnicy. - Jak sprawdzić efekt
- Test zgłasza wynik, liczbę stron, czy skrypt koszyka jest potrzebny i jakie znaleziono różnice. Przy włączaniu zobaczysz
Winkelwagencache aan; de paginacache is geleegd.. - Przykład
wp spark-speed winkelwagen proef- Uwaga
- Włączenie czyści cały cache stron. Jeśli błędnie zatwierdzisz różnicę za pomocą
--bevestigd, treści osobiste mogą trafić na wspólne strony. - Jak cofnąć
wp spark-speed winkelwagen uit- Nazwa techniczna
woo_cart_cache
wp spark-speed klantcache
- Co robi
- Obsługuje własny cache dla zalogowanych klientów, tę samą funkcję co Own cache for logged-in customers na karcie Cart and logged-in customers.
status(domyślnie) pokazuje stan, liczbę sesji z własną kopią i to, czy można go włączyć.aan(włączone),uit(wyłączone i wyczyszczone) orazlegen(czyści wszystkie kopie klientów). - Kiedy używać
- Gdy zalogowani klienci przy każdym kliknięciu dostają w pełni zbudowaną stronę.
- Wymagania
- Jeśli funkcji nie można włączyć w tej witrynie,
aanodmawia i podaje powód. Tylko role klientów, nigdy administratorzy. Kopia ma co najwyżej 8 godzin. - Jak sprawdzić efekt
- Komunikaty takie jak
Klantcache aan.lubKlantcache uit en geleegd., a zstatuswiersz zstand,sessies met eigen kopieenikan aan. - Przykład
wp spark-speed klantcache status- Uwaga
- Każda zalogowana sesja dostaje własne kopie, więc zajęte miejsce na dysku rośnie wraz z liczbą klientów.
- Jak cofnąć
wp spark-speed klantcache uit- Nazwa techniczna
klant_cache
wp spark-speed laadplan
- Co robi
- Obsługuje plan ładowania: wtyczki, które ładują kod na froncie bez zmieniania strony, są tam pomijane, po dowodzie. To ta sama funkcja co karta Front-end load plan w Diagnostics.
kandidatenwyświetla wtyczki z liczbą ich plików i ostatnim testem.proef <plugin>sprawdza, czy strona pozostaje taka sama bez tej wtyczki.weglaten <plugin>pomija ją na froncie.laden <plugin>ładuje ją ponownie.aaniuitwłącza lub wyłącza plan.statuspokazuje stan. - Kiedy używać
- Gdy wtyczka ładuje dużo kodu frontu, którego Twoi odwiedzający nie potrzebują.
- Wymagania
weglatenjest dozwolone tylko po teście z wynikiemgelijk(równe) lub z--bevestigdpo samodzielnym przejrzeniu różnicy. Dotyczy tylko anonimowych odwiedzających. Plan jest domyślnie wyłączony.- Jak sprawdzić efekt
- Wiersz z
modus,weggelaten op de voorkantoraz właścicielem wtyczki must-use (wtyczki, którą WordPress zawsze ładuje jako pierwszą). - Przykład
wp spark-speed laadplan proef contact-form-7- Uwaga
- Identyczna strona nie dowodzi, że wtyczka nie wykonuje niewidocznej pracy, takiej jak bezpieczeństwo, śledzenie po stronie serwera czy logowanie. Pomijaj tylko wtyczki, które znasz.
- Jak cofnąć
wp spark-speed laadplan laden <plugin>lubwp spark-speed laadplan uit.
Importowanie i analiza pomiarów
Dla tych, którzy mierzą sami: importuj pomiary z przeglądarki, aby Spark nadawał priorytet dokładnie właściwemu obrazowi i czcionkom, i przeglądaj ścieżkę krytyczną.
wp spark-speed image-hint
- Co robi
- Importuje pomiar z prawdziwej przeglądarki, który rejestruje, który obraz na stronie jest LCP (największym widocznym elementem podczas ładowania). Dopóki pomiar jest ważny, strona z cache ładuje dokładnie ten obraz z priorytetem.
- Kiedy używać
- Gdy Spark sam wybiera niewłaściwy obraz główny.
- Wymagania
- Plik JSON o rozmiarze co najwyżej 16 KB ze skanu administratora. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
- Jak sprawdzić efekt
- Przy powodzeniu
Observation stored; refresh and verify the affected cache variants.. Jeśli adres, wiek, ustawienia lub dowód LCP się nie zgadzają, pomiar jest odrzucany. Wtedy odśwież daną stronę i sprawdź za pomocąverify-cache. - Przykład
wp spark-speed image-hint --file=lcp.json- Uwaga
- Polecenie nie czyści cache ani nie zmienia ustawień. Pomiary wygasają po sześciu godzinach oraz po zmianach treści, mediów, menu, motywu, wtyczek lub ustawień.
- Jak cofnąć
- Nie ma osobnego polecenia do usunięcia pomiaru; po jego wygaśnięciu znów obowiązuje wybór automatyczny.
wp spark-speed font-hint
- Co robi
- Importuje pomiar lokalnych czcionek, które faktycznie są widocznie ładowane, aby tylko one były ładowane z wyprzedzeniem.
- Kiedy używać
- Gdy ładowanych jest z wyprzedzeniem zbyt wiele czcionek lub niewłaściwe.
- Wymagania
- Plik JSON o rozmiarze co najwyżej 16 KB. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
- Jak sprawdzić efekt
Font observation stored; refresh and verify affected cache variants.lubFont observation rejected..- Przykład
wp spark-speed font-hint --file=fonts.json- Uwaga
- Nieaktualny pomiar może spowodować wczytanie z wyprzedzeniem niewłaściwej czcionki. Pomiary wygasają po sześciu godzinach i po zmianach w witrynie.
- Jak cofnąć
- Brak osobnego polecenia; po wygaśnięciu znów obowiązuje wybór automatyczny.
wp spark-speed font-metrics
- Co robi
- Importuje zmierzone rozmiary dla czcionki zapasowej, aby tekst przesuwał się mniej podczas ładowania czcionki webowej.
- Kiedy używać
- Gdy tekst widocznie przesuwa się, gdy tylko pojawi się czcionka webowa.
- Wymagania
- Plik JSON o rozmiarze co najwyżej 16 KB. Wartości spoza zakresu są odrzucane. Skrypty zbierające wymienione na karcie Measured choices nie są dołączone do pliku zip wtyczki.
- Jak sprawdzić efekt
Font metrics stored; refresh the affected cache variants and verify the layout.Potem obejrzyj stronę.- Przykład
wp spark-speed font-metrics --file=metrics.json- Uwaga
- Błędne rozmiary mogą zamiast tego powodować przesuwanie się tekstu. Sprawdź układ.
- Jak cofnąć
- Nie znaleziono osobnego polecenia; wyczyść cache danych stron.
wp spark-speed kritiek-pad
- Co robi
- Pokazuje, co musi się załadować przed LCP (ścieżka krytyczna). Za pomocą
--fileanalizuje JSON Lighthouse (eksport z DevTools lub odpowiedź PageSpeed) i zapisuje wynik dla karty What keeps the score from green w Diagnostics. Za pomocą--pagepobiera stronę jako odwiedzający na telefonie i szacuje na podstawie HTML, bez czasów. - Kiedy używać
- Gdy chcesz wiedzieć, co obniża wynik.
- Wymagania
- Jedna z dwóch opcji. Plik Lighthouse musi zawierać żądania sieciowe.
--pagedziała tylko z adresami w tej witrynie. - Jak sprawdzić efekt
- Kompaktowy JSON w terminalu.
- Przykład
wp spark-speed kritiek-pad --file=lighthouse.json- Jak cofnąć
- Niepotrzebne: polecenie niczego więcej w witrynie nie zmienia.
Polecenia wymagające ważnej licencji
Spark Speed ma jeden poziom licencji. Polecenia mcp token i ai apply istnieją tylko, dopóki licencja jest ważna (lub w 14-dniowym okresie karencji); diagnostics istnieje zawsze, ale odmawia bez ważnej licencji.
wp spark-speed diagnostics
- Co robi
- Wypisuje raport diagnostyczny jako JSON (serwer, PHP, cache, wtyczki) albo zapisuje go do pliku za pomocą
--save=<path>. To ten sam raport co Download diagnostic report w panelu administracyjnym. - Kiedy używać
- Dla supportu albo do przekazania AI.
- Wymagania
- Ważna licencja. Polecenie istnieje także bez licencji, ale wtedy odmawia z błędem.
- Jak sprawdzić efekt
- JSON w terminalu albo
Saved to <path>. - Przykład
wp spark-speed diagnostics --save=spark-report.json- Uwaga
- Plik zawiera szczegóły serwera i ustawień. Traktuj go jako poufny.
- Jak cofnąć
- Usuń plik.
wp spark-speed mcp token
- Co robi
- Zarządza kluczami MCP z wiersza poleceń.
createtworzy nowy klucz i pokazuje go raz.listpokazuje klucze bez sekretu.revoke <id>unieważnia klucz. Użyj--labelaby nazwać klucz (domyślnie WP-CLI). To to samo co karta Create key na karcie Connect Claude or ChatGPT (MCP). - Kiedy używać
- Gdy chcesz połączyć z witryną program AI na własnym komputerze, taki jak Claude Code.
- Wymagania
- Istnieje tylko, dopóki licencja jest ważna. Musisz podać
--user=<admin>dla użytkownika z uprawnieniami administratora.createodmawia wypisania na ekran: przekaż wynik od razu do menedżera haseł lub magazynu sekretów. Co najwyżej pięć kluczy. - Jak sprawdzić efekt
listpokazuje dla każdego klucza id, wskazówkę (pierwsze i ostatnie cztery znaki), nazwę, właściciela, czas utworzenia i ostatnie użycie.- Przykład
wp spark-speed mcp token list --user=admin- Uwaga
- Klucz może robić wszystko, co potrafią narzędzia MCP, działając jako administrator, który jest jego właścicielem. Zgubionego klucza nie można odzyskać, można go tylko unieważnić. Jeśli właściciel straci uprawnienia administratora, klucz przestaje działać.
- Jak cofnąć
wp spark-speed mcp token revoke <id> --user=admin(id, nie sam klucz).
wp spark-speed ai apply
- Co robi
- Stosuje propozycję konfiguracji od AI przez tę samą bramkę bezpieczeństwa co narzędzie MCP
apply_config: zabronione ustawienia i ustawienia powiązane z witryną są odrzucane, naraz włączany jest co najwyżej jeden ryzykowny przełącznik, a każda zmiana dostajechange_id. Propozycja pochodzi z--filelub ze standardowego wejścia. - Kiedy używać
- Gdy masz propozycję przygotowaną z AI i chcesz zastosować ją w kontrolowany sposób bez otwierania panelu administracyjnego.
- Wymagania
- Istnieje tylko, dopóki licencja jest ważna.
--user=<admin>z uprawnieniami administratora. Propozycja to JSON o rozmiarze co najwyżej 64 KB. - Jak sprawdzić efekt
- JSON zawierający między innymi
applied,change_id,changed,rejectedinext_step. Potem sprawdź witrynę na telefonie: menu, suwaki, formularze i koszyk. - Przykład
wp spark-speed ai apply --file=proposal.json --json --user=admin- Uwaga
- Ryzykowne ustawienie może zepsuć front. Po każdej udanej zmianie cache jest budowany od nowa, co przez pewien czas obciąża serwer.
- Jak cofnąć
- Nie ma polecenia WP-CLI do cofania. Użyj narzędzia MCP
revert_changezchange_id, albo przywróć ustawienie w panelu administracyjnym.
MCP: łączenie i wymagania
Czego potrzebujesz, zanim asystent AI będzie mógł używać poniższych narzędzi.
MCP-koppeling
- Co robi
- MCP (Model Context Protocol) to standard, dzięki któremu asystent AI, taki jak Claude lub ChatGPT, pracuje z Twoją witryną przez stałe narzędzia. Spark Speed ma w WordPressie własny adres MCP. Daje AI tylko narzędzia wymienione poniżej: mierzenie, zmianę ustawień, cofanie i czyszczenie cache, bez dostępu do serwera.
- Wymagania
- Ważna licencja i autoryzowany klient działający jako administrator. Są trzy sposoby: własny klucz (przez Create key lub
wp spark-speed mcp token) w nagłówkuX-Spark-Tokenlub jako token Bearer; hasło aplikacji WordPress administratora; albo konektor z Claude.ai lub ChatGPT, w którym logujesz się do WordPressa i udzielasz dostępu. Bez ważnej licencji adres odrzuca każde żądanie. - Jak sprawdzić efekt
- Adres i wiersze dla Claude Code i Claude Desktop znajdziesz w karcie Connect Claude or ChatGPT (MCP) na karcie Optimization. Po pierwszym żądaniu Twój klucz pokazuje tam czas ostatniego użycia.
- Przykład
claude mcp add --transport http spark-speed https://example.com/wp-json/spark-speed/v1/mcp --header "X-Spark-Token: <key>"- Uwaga
- Każdy klucz lub użytkownik może wysłać co najwyżej 120 żądań na minutę. Żądanie z przeglądarki na innej domenie jest odrzucane. AI nigdy nie może zmieniać niektórych ustawień, w tym hamulca bezpieczeństwa, automatycznego wycofania i ustawień należących do tego serwera.
- Jak cofnąć
- Klucz lub połączenie unieważnisz w tej samej karcie albo za pomocą
wp spark-speed mcp token revoke.
Narzędzia MCP tylko do odczytu
Te narzędzia niczego nie zmieniają w Twojej witrynie. AI używa ich do mierzenia i uzasadniania propozycji.
get_optimization_guide
- Co robi
- Zwraca scenariusz optymalizacji: przebieg pracy, co robi każde ustawienie, które ustawienia są ryzykowne i jak je zweryfikować. Ten sam scenariusz jest dołączony do raportu diagnostycznego.
- Kiedy używać
- Na początku rozmowy, aby AI wiedziało, jak działa Spark Speed.
- Jak sprawdzić efekt
- Zwykły tekst, nie JSON.
- Przykład
- Poproś: „Najpierw przeczytaj przewodnik Spark Speed.”
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_site_overview
- Co robi
- Zwraca przegląd: adres witryny, wtyczkę, wersje WordPressa i PHP, wykryty builder, WooCommerce i hosting, pokrycie cache, główne przełączniki i ostatnie zmiany.
- Kiedy używać
- Na początku każdej sesji.
- Jak sprawdzić efekt
- JSON zawierający między innymi wersję i przełączniki.
- Przykład
- Poproś: „Pokaż mi przegląd mojej witryny w Spark Speed.”
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_optimization_status
- Co robi
- Pokazuje, czy wbudowany optimizer (przycisk Optimize my site) jest włączony i jak idzie trwająca runda, z linkiem do pulpitu. Celowo nie zwraca ustawień ani danych przeglądarki.
- Kiedy używać
- Przed i po
start_optimization. - Jak sprawdzić efekt
- JSON ze statusem i następnym krokiem. Runda, która już nie trwa, nie dowodzi, że wszystko się udało.
- Przykład
- Poproś: „Jak idzie optymalizacja?”
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_config
- Co robi
- Zwraca wszystkie bieżące ustawienia oraz informację, których ustawień AI nie może zmieniać, które są powiązane z tą witryną lub serwerem i które są ryzykowne.
- Kiedy używać
- Zanim AI zaproponuje zmianę.
- Jak sprawdzić efekt
- JSON.
- Przykład
- Poproś: „Które ustawienia są teraz włączone?”
- Uwaga
- Pokazuje to AI Twoją pełną konfigurację Spark Speed.
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_diagnostics
- Co robi
- Zwraca pełny raport diagnostyczny: serwer, cache, co ładuje się na stronach i ustalenia, w tym co optimizer zdecydował wcześniej. Duży; użyj go, gdy przegląd nie wystarcza.
- Kiedy używać
- Gdy szukasz przyczyny albo chcesz odczytać decyzje Optimize my site.
- Jak sprawdzić efekt
- JSON.
- Przykład
- Poproś: „Co optimizer zdecydował w ostatniej rundzie?”
- Uwaga
- Zawiera szczegóły serwera.
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
check_page
- Co robi
- Pobiera jedną stronę Twojej witryny jako odwiedzający na komputerze i na telefonie: status cache (HIT lub MISS), podaną wersję i to, co ładuje HTML (skrypty, opóźnione skrypty, arkusze stylów, preloady, obraz LCP). Za pomocą
measurewykonuje też pomiar Google PageSpeed Insights. - Kiedy używać
- Po każdej zmianie, dla każdej ważnej strony.
- Wymagania
- Pełny adres w tej witrynie bez query stringa. Dla
measure: skonfigurowany klucz PageSpeed i publicznie dostępna witryna. - Jak sprawdzić efekt
- JSON z częścią dotyczącą cache, analizą HTML i opcjonalnie pomiarem.
- Przykład
{"url": "https://example.com/", "measure": true, "strategy": "mobile"}- Uwaga
- Za pomocą
measurepubliczny adres jest wysyłany do Google. Pomiary są ograniczone do dwóch na minutę na użytkownika. - Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_site_findings
- Co robi
- Zwraca problemy w samej witrynie, z nazwami plików i zmierzonym kosztem: błędy 404, łańcuchy przekierowań i ciężkie pliki.
- Kiedy używać
- Gdy wynik jest niski z powodu czegoś, czego Spark nie może naprawić.
- Jak sprawdzić efekt
- JSON.
- Przykład
- Poproś: „Jakie problemy są w samej mojej witrynie?”
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
get_warm_status
- Co robi
- Zwraca stan budowania cache: strony w cache w stosunku do całości, czy budowanie trwa, czy utknęło, i nieudane adresy. Te same dane co
wp spark-speed warm-status. - Kiedy używać
- Po czyszczeniu cache lub zmianie.
- Jak sprawdzić efekt
- JSON albo
available: falsegdy nie da się ustalić stanu. - Przykład
- Poproś: „Czy cache został już zbudowany?”
- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
list_changes
- Co robi
- Zwraca zmiany wykonane przez MCP lub
ai apply, zchange_id, czasem, użytkownikiem, uzasadnieniem i informacją, czy zostały cofnięte, oraz oś czasu wszystkich zmian ustawień w witrynie. - Kiedy używać
- Aby znaleźć
change_iddlarevert_change. - Wymagania
- Opcjonalny
limitod 1 do 60 (domyślnie 15). - Jak sprawdzić efekt
- JSON z listą zmian i osią czasu.
- Przykład
{"limit": 20}- Jak cofnąć
- Nie ma czego cofać: to narzędzie tylko odczytuje.
Narzędzia MCP, które coś zmieniają
Te cztery narzędzia zmieniają witrynę. Dobry asystent AI najpierw prosi o Twoją zgodę i wykonuje jeden krok naraz.
start_optimization
- Co robi
- Włącza wbudowany optimizer i uruchamia rundę, tak samo jak przycisk Optimize my site w karcie Smart optimization. Optimizer używa własnych reguł i kontroli przeglądarki. Jeśli runda już trwa, używana jest ta sama.
- Kiedy używać
- Tylko po Twojej wyraźnej zgodzie; AI musi wysłać
confirm: true. - Wymagania
- Przeglądarka z otwartym pulpitem Spark Speed. Kontrola przeglądarki działa na tym otwartym ekranie administracyjnym, a runda nie zostanie ukończona, jeśli nikt nie otworzy pulpitu. Samo MCP nie wystarcza więc do ukończenia rundy bez przeglądarki.
- Jak sprawdzić efekt
- Odpowiedź zawiera
run_idoraz status. Śledź rundę za pomocąget_optimization_statusoraz na pulpicie; udany start nie dowodzi, że kontrola się zakończyła. - Przykład
{"confirm": true}- Uwaga
- Optimizer może zmieniać ustawienia. W 0.73.2 panel nie pokazuje listy decyzji ani przycisku do cofnięcia całej rundy; decyzje odczytasz w raporcie diagnostycznym lub przez
get_diagnostics. - Jak cofnąć
- Przywróć dane ustawienia na karcie Optimization lub Cache.
apply_config
- Co robi
- Zmienia ustawienia Spark Speed przez tę samą bramkę bezpieczeństwa co propozycja AI w panelu administracyjnym. Do list dopisywane są nowe wpisy, chyba że są wymienione w
replace_lists. Za pomocądry_runnajpierw zobaczysz, co by się zmieniło. Każda rzeczywista zmiana dostajechange_idi trafia na oś czasu wraz z uzasadnieniem; potem cache jest budowany od nowa. - Kiedy używać
- Po zmierzeniu narzędziami odczytu, jeden krok na raz.
- Wymagania
changesoraz jednozdaniowereason. Tylko ustawienia zget_config, co najwyżej 40 naraz i co najwyżej jeden włączony ryzykowny przełącznik na wywołanie. Zabronione ustawienia i ustawienia powiązane z witryną są odrzucane z podaniem powodu.- Jak sprawdzić efekt
- JSON z
applied,change_id,changed(stara i nowa wartość dla każdego ustawienia) orazrejected. Potem sprawdź witrynę na telefonie: menu, suwaki, formularze i koszyk. - Przykład
{"changes": {"delay_js": true}, "reason": "Reduce main-thread work", "dry_run": true}- Uwaga
- Ryzykowne ustawienie może zepsuć front. Odbudowa cache obciąża serwer.
- Jak cofnąć
revert_changezchange_id.
revert_change
- Co robi
- Cofa jedną wcześniejszą zmianę wykonaną za pomocą
apply_configlubai apply. Wracają tylko ustawienia tej zmiany. Jeśli ustawienie zostało potem zmienione ponownie, przez kogoś innego lub w późniejszym kroku, zostaje nietknięte i jest zgłaszane. - Kiedy używać
- Gdy zmiana coś psuje albo nie przynosi korzyści.
- Wymagania
- Wymagane
change_id(zobaczlist_changes). Znanych jest tylko ostatnie 30 zmian wykonanych przez MCP lub WP-CLI. - Jak sprawdzić efekt
- JSON z
reverted,restoredileft_alone_because_changed_since. Drugie wywołanie zgłasza, że zmiana została już cofnięta. - Przykład
{"change_id": "mcp-20261010-101500-ab12cd"}- Uwaga
- Nie cofa to zmian wykonanych w panelu administracyjnym ani przez optimizer.
- Jak cofnąć
- Zastosuj zmianę ponownie za pomocą
apply_config.
purge_cache
- Co robi
- Czyści cache stron dla jednego adresu albo dla całej witryny, gdy nie podasz adresu. Dla całej witryny wszystko jest kolejkowane od nowa. Trafia to na oś czasu.
- Kiedy używać
- Gdy strona pokazuje nieaktualną wersję.
- Wymagania
- Adres musi należeć do tej witryny.
- Jak sprawdzić efekt
- Odpowiedź
purgedz adresem luball. - Przykład
{"url": "https://example.com/shop/"}- Uwaga
- Po pełnym czyszczeniu cache strony są wolniejsze, dopóki budowanie się nie zakończy.
- Jak cofnąć
- Niepotrzebne: budowanie cache napełnia go ponownie.
Masz wątpliwości co do jakiegoś kroku? Cofnij zmianę, sprawdź swoją witrynę i napisz do nas przez stronę kontaktową.
Nie masz jeszcze Spark Speed? Zobacz, co robi i ile kosztuje.
Najczęściej zadawane pytania
Nie. Przez MCP AI może mierzyć, zmieniać ustawienia i uruchamiać rundę optymalizacji, ale kontrola przeglądarki tej rundy działa w pulpicie Spark Speed. Musi on być otwarty w przeglądarce, dopóki runda trwa.
mcp token i ai apply istnieją tylko z ważną licencją, a diagnostics odmawia bez niej. Pozostałe polecenia są dostępne, ale zarządzanie i nowe optymalizacje wymagają ważnej licencji lub 14-dniowego okresu karencji.
Znajdź change_id za pomocą list_changes i użyj revert_change. Wracają tylko ustawienia tej zmiany. Zmiany z przycisku Optimize my site w 0.73.2 cofasz, samodzielnie przywracając te ustawienia.
Klucz jest pokazywany tylko raz i nie można go odzyskać. Unieważnij go w karcie Connect Claude or ChatGPT (MCP) lub za pomocą wp spark-speed mcp token revoke i utwórz nowy.
Tak zostały zbudowane w 0.73.2: winkelwagen (koszyk), klantcache (cache klientów), laadplan (plan ładowania) i warm-hervat (wznowienie rozgrzewania) używają niderlandzkich słów, takich jak aan, uit, proef i legen. Część wyniku też jest po niderlandzku.