AI Competitor: monitoring cen konkurencji

Prezentacja

AI Competitor monitoruje ceny Twoich konkurentów bezpośrednio z back office PrestaShop. Dla każdego produktu z katalogu deklarujesz jeden albo kilka adresów URL konkurencji, moduł odwiedza je w regularnych odstępach, wyciąga wyświetlaną cenę (z awaryjną ekstrakcją przez AI, gdy metody klasyczne zawiodą), wykrywa istotne zmiany, powiadamia Cię e-mailem i proponuje skorygowaną cenę zgodną z Twoją strategią cenową.

Instalacja

1. W back office otwórz Moduły, Menedżer modułów, Zainstaluj moduł.
2. Wgraj plik dfaicompetitor.zip.
3. Moduł instaluje się i automatycznie tworzy swoje trzy tabele (dfaicompetitor_url, dfaicompetitor_price, dfaicompetitor_alert) oraz menu Katalog, AI Competitor.

Po instalacji generowany jest unikalny token crona. Znajdziesz go na pulpicie modułu.

Konfiguracja początkowa

Otwórz Katalog, AI Competitor. Pulpit skupia statystyki oraz cztery bloki konfiguracji.

Dostawca AI

Awaryjna ekstrakcja przez AI jest opcjonalna, ale mocno zalecana: to ona przejmuje pracę, gdy witryna konkurenta nie udostępnia ani danych strukturalnych, ani użytecznego selektora. Obsługiwani są trzej dostawcy:

• Mistral AI (domyślny): najbardziej ekonomiczny, zalecany model mistral-small-latest
• Anthropic Claude: najlepsza precyzja na złożonych stronach, zalecany model claude-haiku-4-5-20251001
• OpenAI: dobry kompromis, zalecany model gpt-4o-mini

Uzupełnij klucz API wybranego dostawcy. Jest maskowany przy wyświetlaniu, więc przy kolejnym zapisie zostaw pole puste, aby zachować dotychczasowy klucz. Płacisz dostawcy bezpośrednio, bez narzutu ze strony DataFirefly.

Alerty

• E-mail powiadomień: odbiorca zbiorczych alertów i raportu tygodniowego.
• Próg zmiany: w procentach (domyślnie 3 procent). Poniżej progu żaden alert nie jest tworzony.
• Dzień raportu tygodniowego: domyślnie poniedziałek.

Scraping

• Adresy URL na partię crona: liczba adresów przetwarzanych przy każdym uruchomieniu (domyślnie 20).
• Domyślny interwał: w godzinach, stosowany do nowych adresów (domyślnie 24 h).
• Timeout HTTP i User-Agent: dostarczany User-Agent jest identyfikowalny (DataFireflyBot), możesz go dostosować.

Strategia korekty

Sugerowaną cenę wyznaczają trzy strategie, zawsze liczone od najtańszego konkurenta:

• Dopasuj: ta sama cena co u najtańszego konkurenta.
• Podetnij o X procent: X procent poniżej (domyślnie 1 procent).
• Premium o X procent: X procent powyżej, dla świadomego pozycjonowania w wyższym segmencie.

Dodawanie adresów URL konkurencji

Otwórz Katalog, AI Competitor, Competitor URLs, Dodaj. Każdy wiersz wiąże produkt z Twojego katalogu ze stroną konkurenta:

• Produkt: wybierany z Twojego katalogu.
• Nazwa konkurenta: dowolna etykieta (Allegro, Ceneo, sklep internetowy).
• Adres URL: pełny adres konkurencyjnej karty produktu.
• Selektor CSS (opcjonalnie): patrz niżej.
• Waluta ISO: domyślnie EUR.
• Wymuś ekstrakcję AI: pomija metody klasyczne dla tego adresu.
• Interwał: w godzinach, właściwy dla tego adresu.

Przycisk Scrape przy każdym wierszu uruchamia natychmiastową ekstrakcję, co jest wygodne przy weryfikowaniu adresu zaraz po jego utworzeniu.

Jak działa ekstrakcja

Dla każdego adresu moduł próbuje kaskadowo czterech metod i zatrzymuje się na pierwszej, która zadziała:

1. JSON-LD: dane strukturalne Product i Offer, obecne na zdecydowanej większości witryn e-commerce. Cena, waluta i dostępność są odczytywane bezpośrednio, bez konfiguracji.
2. OpenGraph: znaczniki meta z kwotą ceny produktu.
3. Selektor CSS: jeśli go podałeś. Wbudowany konwerter obsługuje klasy, identyfikatory, selektory atrybutów i kombinatory dziecka. Prawidłowe przykłady: .current-price, .price-box > .amount, span[itemprop=price].
4. AI: oczyszczony fragment HTML jest wysyłany do Twojego dostawcy, który zwraca cenę, walutę i stan magazynowy. Obsługiwane są międzynarodowe formaty ceny (1 299,90, 1.234,56, $49.99).

Konfiguracja crona

Okresowy scraping opiera się na endpoincie zabezpieczonym tokenem, wyświetlonym na pulpicie. Zaplanuj jego wywołanie co 30 minut:

*/30 * * * * curl -s "https://twoj-sklep.pl/index.php?fc=module&module=dfaicompetitor&controller=cron&token=TWOJ_TOKEN" > /dev/null

Przy każdym uruchomieniu cron przetwarza partię adresów, których interwał już upłynął, wysyła oczekujące e-maile alertowe, wysyła raport tygodniowy, jeśli wypada odpowiedni dzień, oraz czyści stare dane (migawki starsze niż 180 dni, alerty starsze niż 365 dni). Odpowiedzią jest podsumowanie w formacie JSON.

Token można w każdej chwili wygenerować od nowa z poziomu pulpitu (istniejące wpisy crona trzeba wtedy zaktualizować). Dostępne jest też ręczne uruchomienie przyciskiem Run cron now.

Alerty

Generowanych jest pięć typów alertów, każdy ze swoją wagą:

• price_drop i price_rise: zmiana powyżej progu. Zmiana o 10 procent i więcej przechodzi na poziom critical.
• undercut: konkurent schodzi poniżej Twojej ceny sprzedaży brutto. Zawsze critical.
• out_of_stock i back_in_stock: zmiany dostępności wykryte przez dane strukturalne albo AI.
• scrape_error: wyłącznie po 3 kolejnych niepowodzeniach, aby wyeliminować szum przejściowych niedostępności.

Alerty są grupowane w jeden zbiorczy e-mail na uruchomienie crona i dostępne w Reports & Alerts z potwierdzeniem odczytu (przycisk „Acknowledge all”).

Raport tygodniowy

Co tydzień, w skonfigurowanym dniu, e-mail HTML podsumowuje produkty najbardziej podcięte cenowo, największe spadki i wzrosty u konkurencji, kondycję scrapingu oraz podsumowanie wykonawcze zredagowane przez AI, które hierarchizuje działania do podjęcia. Podgląd bieżącego raportu jest dostępny w każdej chwili w Reports & Alerts, wraz z przyciskiem natychmiastowej wysyłki.

Sugestia ceny

W Reports & Alerts wybierz monitorowany produkt: moduł pokaże Twoją bieżącą cenę, cenę minimalną, średnią i maksymalną u konkurencji, źródła oraz cenę sugerowaną zgodnie z Twoją strategią. Przycisk Zastosuj zapisuje cenę na produkcie PrestaShop.

Rozwiązywanie problemów

Status „no_price”

Żadna z metod nie znalazła ceny. Sprawdź adres w przeglądarce, dodaj selektor CSS wskazujący element z ceną albo włącz „Wymuś ekstrakcję AI” dla tego adresu.

Status „error”

Strona nie odpowiedziała (HTTP 400 i wyżej albo timeout). Niektóre witryny blokują roboty: dostosuj User-Agent w konfiguracji, zwiększ timeout albo wydłuż interwał. Alert jest wysyłany dopiero przy trzecim kolejnym niepowodzeniu.

Ekstrakcja AI nie działa

Sprawdź, czy klucz API jest ważny i czy model istnieje u Twojego dostawcy. Błędy wywołań AI są zapisywane w Ustawienia zaawansowane, Logi z prefiksem [dfaicompetitor].

E-maile nie docierają

Przetestuj konfigurację poczty w PrestaShop (Ustawienia zaawansowane, E-mail). Moduł korzysta z natywnego systemu wysyłki z własnymi szablonami FR i EN.

Dobre praktyki i zgodność

• Wydłużaj interwały (od 6 do 24 godzin per adres w zupełności wystarcza przy monitoringu cenowym), aby niepotrzebnie nie obciążać serwerów konkurencji.
• Zachowaj identyfikowalny User-Agent: to uczciwa praktyka oczekiwana w monitoringu konkurencji.
• Odczyt cen publicznych jest w Europie zasadniczo dozwolony, ale za sposób wykorzystania zebranych danych odpowiadasz Ty.