# AEO Monitor i Optimizer: kompletny przewodnik
> Prezentacja AEO Monitor i Optimizer mierzy widoczność Twojej marki w odpowiedziach pięciu asystentów AI: ChatGPT (OpenAI), Claude (Anthropic), Perplexity, Gemini (Google) i Mistral, a następnie generuje konkretne rekomendacje, jak ją…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-29
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfaeomonitor/index.md), [en](https://www.datafirefly.com/en/documentation/dfaeomonitor/index.md), [es](https://www.datafirefly.com/es/documentation/dfaeomonitor/index.md), [de](https://www.datafirefly.com/de/documentation/dfaeomonitor/index.md), [it](https://www.datafirefly.com/it/documentation/dfaeomonitor/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaeomonitor/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaeomonitor/index.md)
- Indeks:
## Prezentacja
AEO Monitor i Optimizer mierzy widoczność Twojej marki w odpowiedziach pięciu asystentów AI: ChatGPT (OpenAI), Claude (Anthropic), Perplexity, Gemini (Google) i Mistral, a następnie generuje konkretne rekomendacje, jak ją poprawić. Wtyczka wysyła Twoje prompty monitorujące do każdego włączonego LLM, analizuje odpowiedzi (wzmianki o marce, cytowania domeny, dokładne adresy URL, konkurenci), liczy wynik widoczności od 0 do 100 i serwuje dynamiczny plik llms.txt.
Wtyczka działa w modelu BYOK (Bring Your Own Key): używasz własnych kluczy API, a wywołania wychodzą bezpośrednio z Twojego serwera do oficjalnych API. Żadne dane nie przechodzą przez DataFirefly.
## Wymagania
- WordPress 6.0 lub nowszy (testowane do 6.7)
- PHP 7.4 lub nowszy (zalecane 8.1+)
- WooCommerce 7.0+ wyłącznie do automatycznego śledzenia produktów i generowania promptów per kategoria (opcjonalnie)
- Co najmniej jeden klucz API spośród: OpenAI, Anthropic, Perplexity, Google Gemini, Mistral
- Działający WP-Cron (albo cron systemowy wywołujący wp-cron.php) na potrzeby zaplanowanych audytów
## Instalacja
1. Pobierz plik ZIP ze swojego konta klienta DataFirefly.
2. W administracji WordPressa przejdź do **Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer**, wybierz plik dfaeomonitor.zip i kliknij **Zainstaluj teraz**.
3. Kliknij **Włącz**. Wtyczka automatycznie tworzy swoje 6 tabel w bazie danych i planuje cotygodniowy cron audytu.
4. Przejdź do **Ustawienia → Bezpośrednie odnośniki** i kliknij **Zapisz** (bez żadnej zmiany), aby odświeżyć reguły przepisywania pod adres llms.txt.
W pasku bocznym administracji pojawia się menu **AEO Monitor** z sześcioma stronami: Panel, Prompty, Wyniki, Śledzone strony, Rekomendacje i Ustawienia.
## Konfiguracja początkowa
### 1. Marka i witryna
W **AEO Monitor → Ustawienia** uzupełnij:
- **Nazwa marki**: dokładna nazwa, którą LLM powinny cytować.
- **Aliasy i warianty**: inne pisownie albo nazwy handlowe (po jednej w wierszu). Każdy alias liczy się jako wzmianka o marce.
- **Domena główna**: Twoja domena bez http i bez www (przykład: mojsklep.pl). Każde cytowanie adresu z tej domeny liczy się jako cytowanie domeny.
- **Konkurenci**: jedna marka na wiersz. Wtyczka wykrywa, kiedy LLM mówi o nich zamiast o Tobie, i nakłada karę na wynik.
### 2. Dostawcy LLM
Nadal w Ustawieniach włącz dostawców, których chcesz odpytywać, i wklej odpowiedni klucz API:
- **OpenAI**: klucz z platform.openai.com. Zalecany model do monitoringu: gpt-4o-mini. Wtyczka używa API Responses z narzędziem wyszukiwania w sieci.
- **Anthropic**: klucz z console.anthropic.com. Wywołanie korzysta z API Messages z narzędziem wyszukiwania w sieci.
- **Perplexity**: klucz z perplexity.ai. Model sonar-pro z natywnymi cytowaniami: dostawca najbogatszy w źródła.
- **Google Gemini**: klucz z Google AI Studio. Grounding w Google Search włączany jest automatycznie.
- **Mistral**: klucz z console.mistral.ai. Wyszukiwanie w sieci, gdy dostępne, w przeciwnym razie fallback na wiedzę wewnętrzną modelu.
Do startu wystarczy jedno API, ale trzy albo więcej dostawców daje reprezentatywny obraz. Cotygodniowy audyt 10 promptów na 5 LLM (50 wywołań) kosztuje zwykle od 0,30 do 1,20 euro przy modelach ekonomicznych.
### 3. Harmonogram
- **Częstotliwość audytu**: tygodniowa (zalecana) albo dzienna.
- **Maksimum promptów na audyt**: limit promptów wysyłanych przy każdym uruchomieniu. Pamiętaj: każdy prompt trafia do każdego włączonego LLM.
- **Timeout żądania**: maksymalny czas trwania wywołania API (domyślnie 45 sekund).
- **Automatyczne śledzenie**: zaznacz, aby automatycznie śledzić każdy nowo opublikowany produkt WooCommerce, a jeśli chcesz, także każdą nową stronę.
- **Dynamiczny llms.txt**: włącza odpowiedź witryny pod adresem llms.txt.
## Tworzenie promptów i zarządzanie nimi
Prompt to pytanie zadawane LLM-om dokładnie w takiej formie, w jakiej sformułowałby je prawdziwy użytkownik. Przykłady: „Jakie są najlepsze moduły SEO do PrestaShop?", „Jaki sklep polecasz do kupienia skórzanych sneakersów w Polsce?"
W **AEO Monitor → Prompty** możesz:
- **Utworzyć prompt ręcznie** z wewnętrzną etykietą, treścią pytania, intencją (marka, produkt, kategoria, konkurent, informacyjna), językiem i opcjonalnie docelowym adresem URL, którego cytowanie chcesz śledzić.
- **Wygenerować prompty domyślne**: dedykowany przycisk automatycznie tworzy prompty markowe i jeden prompt na kategorię WooCommerce, w języku witryny.
- **Włączać i wyłączać** prompt bez usuwania go: podczas audytów wysyłane są wyłącznie prompty aktywne.
Powiązanie promptu z docelowym adresem URL pozwala precyzyjnie mierzyć, czy LLM odsyłają do właściwej strony: wynik rośnie o 20 punktów, gdy zacytowany jest dokładny adres.
## Uruchomienie audytu
Audyt można uruchomić na trzy sposoby:
1. **Przycisk „Uruchom audyt teraz"** na panelu: wykonanie startuje w tle w ciągu kilku sekund.
2. **Zaplanowany cron**: automatycznie, według częstotliwości wybranej w ustawieniach.
3. **WP-CLI**: polecenie wp dfaeo audit wykonuje audyt synchronicznie, ze szczegółami w terminalu.
Podczas audytu każdy aktywny prompt wysyłany jest do każdego włączonego dostawcy, z 300 ms odstępu między wywołaniami. Odpowiedzi są zapisywane, analizowane, a na koniec automatycznie generowane są rekomendacje.
## Zrozumieć wynik widoczności
Każda odpowiedź LLM otrzymuje wynik od 0 do 100, liczony tak:
- +30 punktów, jeśli Twoja marka jest wzmiankowana, plus bonus do +15 zależnie od liczby powtórzeń
- +25 punktów, jeśli Twoja domena jest cytowana w źródłach
- +20 punktów, jeśli zacytowany jest dokładny docelowy adres URL promptu
- +5 punktów, jeśli odpowiedź zawiera źródła
- Kara do -15 punktów zależnie od liczby wzmianek o konkurentach
Panel agreguje te wyniki: średnia globalna, wskaźnik wzmianek o marce, wskaźnik cytowań domeny, zmiana na przestrzeni 7, 30 albo 90 dni oraz porównanie pięciu platform.
## Śledzone strony i wynik pokrycia
Strona **Śledzone strony** wypisuje adresy, których indeksowanie przez LLM monitorujesz. Wynik pokrycia strony rośnie za każdym razem, gdy LLM zacytuje jej dokładny adres, i lekko maleje przy każdym audycie bez cytowania (współczynnik 0,98), co odzwierciedla rzeczywistą świeżość Twojej obecności.
- Opublikowane produkty WooCommerce dodawane są automatycznie, jeśli opcja jest włączona.
- Możesz ręcznie dodać dowolny adres z typem (strona, produkt, wpis, kategoria) i priorytetem od 1 do 10.
- Strony o wysokim priorytecie, ale niskim wyniku, automatycznie generują rekomendacje.
## Rekomendacje
Po każdym audycie silnik rekomendacji analizuje strony z problemami i proponuje działania sklasyfikowane według wagi (wysoka, średnia, niska):
- **FAQ JSON-LD**: blok kodu gotowy do wklejenia w nagłówku strony, z pytaniami i odpowiedziami wygenerowanymi z treści.
- **Schema Product**: wzbogacone dane strukturalne dla kart WooCommerce (cena, dostępność, opinie), zasilane prawdziwymi danymi produktu.
- **Streszczenie TL;DR**: akapit 60 do 80 słów do umieszczenia na początku treści, format chętnie wyciągany przez LLM.
- **Schema Organization**: wzmocniona tożsamość marki, ograniczająca pomyłki i halucynacje na temat Twojej firmy.
- **robots.txt**: reguły zezwoleń dla crawlerów AI: GPTBot, ClaudeBot, PerplexityBot, Google-Extended.
- **Priorytet w llms.txt**: wypromowanie strategicznej strony w dynamicznym pliku llms.txt.
Każdą rekomendację można oznaczyć jako W toku, Rozwiązaną albo Zignorowaną. Proponowany kod wyświetla się w rozwijanym bloku gotowym do skopiowania.
## Dynamiczny plik llms.txt
Gdy opcja jest włączona, Twoja witryna odpowiada pod adresem llms.txt indeksem w Markdownie generowanym na bieżąco:
- **Top references**: strony najlepiej wykrywane przez LLM, uszeregowane według wyniku pokrycia.
- **Priority pages**: strony o priorytecie 5 lub wyższym, jeszcze niedobrze wykrywane.
- **Catalog**: Twoje główne kategorie WooCommerce.
- **About**: nazwa marki, adres witryny i kontakt.
Jeśli adres llms.txt zwraca 404, zapisz ponownie bezpośrednie odnośniki w Ustawienia → Bezpośrednie odnośniki. Filtr dfaeo_llmstxt_lines pozwala deweloperom modyfikować generowane linie.
## WP-CLI
Do automatyzacji dostępne są trzy polecenia:
```
„wp dfaeo audit" uruchamia audyt synchroniczny (opcja --prompts=5 ogranicza liczbę)
„wp dfaeo seed" generuje domyślne prompty z marki i kategorii
„wp dfaeo report --days=30" wyświetla zagregowany raport (opcja --format=json albo csv)
```
Polecenie report idealnie nadaje się do zasilania narzędzia BI albo zewnętrznego panelu przez systemowe zadanie cron.
## Rozwiązywanie problemów
- **„Żaden audyt nie mógł się uruchomić"**: sprawdź, czy co najmniej jeden dostawca jest włączony z prawidłowym kluczem API i czy co najmniej jeden prompt jest aktywny.
- **Błędy 401 / 403 w wynikach**: klucz API danego dostawcy jest nieprawidłowy albo wygasł. Błędy widoczne są w szczegółach każdego wyniku.
- **Błędy 429**: wyczerpany limit API u dostawcy. Zmniejsz liczbę promptów na audyt albo przejdź na częstotliwość tygodniową.
- **Cron się nie uruchamia**: na witrynach o niskim ruchu WP-Cron wykonuje się tylko przy odwiedzinach. Skonfiguruj cron systemowy wywołujący wp-cron.php co 15 minut.
- **llms.txt zwraca 404**: zapisz ponownie bezpośrednie odnośniki albo wyłącz i włącz wtyczkę.
- **Puste wykresy na panelu**: to normalne przed pierwszym ukończonym audytem. Sprawdź też, czy żaden bloker skryptów nie uniemożliwia załadowania Chart.js z CDN jsdelivr.
## Deinstalacja
Wyłączenie zachowuje wszystkie dane. Usunięcie wtyczki ze strony Wtyczki uruchamia pełne czyszczenie: 6 tabel (prompts, runs, results, citations, pages, recommendations), opcje i zadania cron zostają trwale usunięte.
## Prywatność i RODO
Wtyczka nie wysyła żadnych danych do DataFirefly i nie zawiera telemetrii. Jedyne wywołania wychodzące kierowane są do API tych LLM, które włączyłeś, z Twoimi kluczami. Prompty, które redagujesz, przekazywane są tym zewnętrznym dostawcom: unikaj umieszczania w nich danych osobowych klientów. Klucze API przechowywane są w tabeli opcji WordPressa w Twojej bazie danych.