Pinned Post

Plik ai-catalog.json w PrestaShop: czym jest, dlaczego musisz go mieć (pagespeed go wymaga)


Otwierasz PageSpeed Insights. Sprawdzasz sklep. I nagle widzisz nową pozycję w audycie: ai-catalog.json.

Czym jest? Czy to kolejny plik, który musisz dodać? Czy wpływa na wynik? Czy bez niego strona będzie wolniejsza?

Odpowiedzi są prostsze, niż mogłoby się wydawać. Ale warto je znać, bo Google (a konkretnie Lighthouse, który napędza PageSpeed) zaczęło to sprawdzać.

Czym jest ai-catalog.json?

ai-catalog.json to plik JSON, który opisuje możliwości AI Twojej domeny. Nie strony. Nie produkty. Tylko to, co agent AI może na Twojej stronie znaleźć i wykorzystać: API, narzędzia, serwery MCP, agenty, umiejętności.

Myśl o nim jak o sitemap.xml, ale dla AI. sitemap.xml mówi Google, jakie strony masz. ai-catalog.json mówi agentom AI, jakie możliwości oferujesz.

Plik powinien znajdować się pod adresem:

https://twojadomena.pl/.well-known/ai-catalog.json

Standard, który za tym stoi, nazywa się Agentic Resource Discovery (ARD). To otwarta specyfikacja, nad którą pracują Google, Microsoft i inne firmy. Celem jest umożliwienie agentom AI automatycznego znajdowania i korzystania z usług dostępnych w sieci. [116][121]

Co zawiera taki plik?

Minimalny plik ma dwa wymagane pola:

  • specVersion - wersja specyfikacji.
  • entries - lista możliwości (API, narzędzia, agenty).

Może też zawierać opcjonalny blok host z informacją o wydawcy. [127]

Przykład (uproszczony):

{

  "specVersion": "0.91",

  "entries": [

    {

      "identifier": "my-api",

      "displayName": "My Store API",

      "mediaType": "application/json",

      "url": "https://twojadomena.pl/api"

    }

  ]

}

Dlaczego PageSpeed to sprawdza?

PageSpeed Insights korzysta z Lighthouse. Lighthouse w wersji 13.5 dodał audyt dla Agentic Resource Discovery. To audyt w kategorii Agentic Browsing - osobnej od SEO. [120]

Audyt sprawdza:

  • Czy w robots.txt jest dyrektywa Agentmap wskazująca na katalog.
  • Czy w HTML jest tag <link rel="ai-catalog">.
  • Czy w nagłówku HTTP jest Link z relacją ai-catalog.
  • Jeśli nic z powyższego - czy plik istnieje pod /.well-known/ai-catalog.json.

Jeśli nie ma wskaźnika i plik nie istnieje pod well-known path - audyt jest oznaczany jako "Not Applicable". Jeśli plik istnieje, ale ma błędy schematu - audyt kończy się niepowodzeniem. [120]

Czy to wpływa na wynik PageSpeed?

To zależy od tego, jak interpretujesz "wynik".

  • Nie wpływa na Core Web Vitals (LCP, INP, CLS). To są metryki wydajności, nie związane z ai-catalog.
  • Może wpływać na ogólny wynik Lighthouse, jeśli audyt jest aktywny i kończy się niepowodzeniem (np. plik istnieje, ale ma błędy schematu).
  • Nie wpływa na pozycje w Google Search. To audyt dla agentów AI, nie dla wyszukiwarki. [120][126]

Czyli: jeśli nie masz pliku, PageSpeed może pokazać "Not Applicable" - i to nie obniża wyniku. Jeśli masz plik, ale jest błędny - możesz dostać fail w tym audycie.

Jak to wpływa na ocenę sklepu?

Dla większości sklepów PrestaShop, które nie udostępniają API ani narzędzi AI, plik ai-catalog.json nie jest wymagany. PageSpeed pokaże "Not Applicable" i sprawa zamknięta.

Ale jeśli:

  • Masz API publiczne (np. dla aplikacji mobilnej).
  • Udostępniasz narzędzia AI (np. chatbot, rekomendacje).
  • Chcesz, żeby agenty AI mogły korzystać z Twojego sklepu.

...to warto dodać plik. Nawet minimalny. Bo:

  • Agenty AI będą mogły znaleźć Twoje możliwości.
  • PageSpeed nie pokaże błędu w audycie.
  • Jesteś przygotowany na przyszłość (ARD to rozwijający się standard).

Czy brak pliku obniża wynik PageSpeed?

Nie. Jeśli pliku nie ma i nie ma wskaźnika, audyt jest "Not Applicable". Nie obniża wyniku. [120]

Czy błędny plik obniża wynik?

Tak. Jeśli plik istnieje, ale ma błędy schematu, audyt kończy się niepowodzeniem. To może obniżyć ogólny wynik Lighthouse. [120]

Jak dodać ai-catalog.json do PrestaShop?

Jeśli chcesz dodać plik, masz kilka opcji:

1. Ręcznie przez FTP

Utwórz katalog .well-known w root domeny. Dodaj plik ai-catalog.json. Ustaw Content-Type: application/json w konfiguracji serwera.

2. Przez panel hostingu

Niektóre panele hostingowe pozwalają dodawać pliki do well-known path. Sprawdź dokumentację swojego hostingu.

3. Przez moduł

Jeśli nie chcesz grzebać w FTP, są moduły, które to automatyzują. Na przykład artykuł o ai-catalog.json w PrestaShop opisuje, jak to zrobić w praktyce.

Częste pytania

Czym jest ai-catalog.json?

To plik JSON opisujący możliwości AI Twojej domeny (API, narzędzia, agenty). Standard ARD. [116][121]

Gdzie powinien znajdować się plik?

Pod /.well-known/ai-catalog.json na Twojej domenie. [121][127]

Czy ai-catalog.json wpływa na SEO?

Nie bezpośrednio. To audyt dla agentów AI, nie dla wyszukiwarki. Nie wpływa na pozycje w Google Search. [120][126]

Czy ai-catalog.json wpływa na PageSpeed?

Nie wpływa na Core Web Vitals. Może wpływać na ogólny wynik Lighthouse, jeśli audyt jest aktywny i kończy się niepowodzeniem. [120]

Czy muszę mieć ai-catalog.json?

Nie, jeśli nie udostępniasz API ani narzędzi AI. PageSpeed pokaże "Not Applicable". [120]

Jak sprawdzić, czy mój plik jest poprawny?

Użyj walidatora schematu ARD. Albo sprawdź w PageSpeed Insights, czy audyt przechodzi. [120][124]

Czy ai-catalog.json to to samo co sitemap.xml?

Nie. sitemap.xml listuje strony dla wyszukiwarek. ai-catalog.json listuje możliwości AI dla agentów. [121]

Czy muszę mieć zgodę użytkownika, żeby udostępniać ai-catalog.json?

Nie. To publiczny plik, nie przetwarza danych osobowych. [121]

Czy ai-catalog.json jest wymagany przez Google?

Nie jest wymagany. To propozycja standardu (ARD). Google dodaje audyt w Lighthouse, ale nie wymaga pliku. [116][120]

Jak dodać ai-catalog.json do PrestaShop?

Ręcznie przez FTP, przez panel hostingu, albo przez moduł. Więcej w artykule o ai-catalog.json w PrestaShop.

Podsumowanie

ai-catalog.json to nowy plik, który opisuje możliwości AI Twojej domeny. PageSpeed (przez Lighthouse) zaczęło go sprawdzać w audycie Agentic Browsing.

  • Nie wpływa na Core Web Vitals.
  • Nie wpływa na SEO.
  • Jeśli go nie masz - audyt jest "Not Applicable".
  • Jeśli masz, ale jest błędny - możesz dostać fail.

Dla większości sklepów PrestaShop to nie jest priorytet. Ale jeśli planujesz API, chatboty albo integracje AI - warto dodać plik. Nawet minimalny.

Komentarze

Prześlij komentarz