---
title: "Plik ard.json – czy Twoja strona go potrzebuje?"
description: "Stan na 21 listopada 2026 · logi z&nbsp;8 serwisów za 1–20 listopada 2026 W&nbsp;poradnikach o&nbsp;„gotowości na agentów AI” pojawił się nowy plik do wdrożenia: /.well-known/ard.json. Wcześniej tę samą rolę pełnił ai-catalog.json. Brzmi jak kolejny llms.txt, więc wraca znane pytanie: czy moja strona go potrzebuje? Krótka odpowiedź brzmi: jeśli masz bloga, stronę firmową albo sklep bez"
date: 2026-11-21
author: "Ewelina Podrez-Siama"
url: "https://podrez.pl/ard-json/"
categories:
  - "Blog SEO"
tags:
  - "AI Search i GEO"
  - "SEO techniczne"
---

Stan na 21 listopada 2026 · logi z 8 serwisów za 1–20 listopada 2026

W poradnikach o „gotowości na agentów AI” pojawił się nowy plik do wdrożenia: `/.well-known/ard.json`. Wcześniej tę samą rolę pełnił `ai-catalog.json`. Brzmi jak kolejny [llms.txt](https://podrez.pl/plik-llms-txt/), więc wraca znane pytanie: czy moja strona go potrzebuje?

Krótka odpowiedź brzmi: jeśli masz bloga, stronę firmową albo sklep bez własnego API i serwera MCP, dziś nie potrzebujesz ard.json. Plik nie opisuje treści strony, a jest spisem narzędzi, które agent AI może wywołać: serwerów MCP, agentów, skilli i rejestrów. Strona bez takich narzędzi po prostu nie ma czego w nim wpisać.

Co to jest ARD

**Nazwa:** Agentic Resource Discovery, czyli specyfikacja tego, jak agent AI ma znaleźć narzędzia, które udostępnia firma albo serwis.

**Kto:** autorzy to Junjie Bu (Google), R.V. Guha (w ogłoszeniu Microsoftu podpisany jako Technical Fellow w Microsofcie) i Shaun Smith (Hugging Face). Ogłoszenie 17 czerwca 2026, tego samego dnia na blogach Google, Microsoftu i Hugging Face.

**Status:** wersja v0.91 z 26 sierpnia 2026, oznaczona jako „Proposal”. To zatem propozycja, nie wdrożony standard.

**Gdzie:** plik `/.well-known/ard.json` albo link `<link rel="ard">` w kodzie strony.

**Co opisuje:** serwery MCP, karty agentów A2A, skille i rejestry. Nie zawiera artykułów, produktów czy kategorii.

[Specyfikacja ARD (po angielsku)](https://agenticresourcediscovery.org/spec/)



**194**żądania ard.json i ai-catalog.json

**192**z nich to audyty Lighthouse i WebPageTest

**2**żądania od Andi-SearchBot, po jednym o każdy plik

**1583**żądania traffic-advice od Chrome

 

Logi serwera, 1–20 listopada 2026, 8 serwisów, które prowadzę: blog o SEO, blog kulinarny i przewodniki turystyczne po polsku, angielsku i niemiecku. Żadnego z tych plików nie mam, więc prawie wszystkie odpowiedzi to 404.



ard.json \[SPIS TREŚCI\]

[Toggle](#)

- [Kto o ard.json pyta? Odpowiedzi z moich logów](#kto-o-ardjson-pyta-odpowiedzi-z-moich-logow)
- [ard.json czy ai-catalog.json?](#ardjson-czy-ai-catalogjson)
- [Co jest w środku](#co-jest-w-srodku)
- [Dla kontrastu: traffic-advice, plik, który ma czytelnika](#dla-kontrastu-traffic-advice-plik-ktory-ma-czytelnika)
- [Kiedy ard.json ma sens](#kiedy-ardjson-ma-sens)
- [Co zrobić zamiast tego przy stronie z treścią](#co-zrobic-zamiast-tego-przy-stronie-z-trescia)
- [Najczęstsze pytania](#najczestsze-pytania)



Kto o ard.json pyta? Odpowiedzi z moich logów
---------------------------------------------

W logach 8 serwisów, które prowadzę, ard.json i ai-catalog.json padły od 1 do 20 listopada 194 razy. Pierwsza moja myśl? Agenci już szukają! Ale po weryfikacji: 192 z tych żądań to audyty Lighthouse i WebPageTest. 130 przyszło od Lighthouse uruchamianego z serwerów Google (tak działają narzędzia Google, na przykład PageSpeed Insights), a 62 od WebPageTest. Te z Lighthouse mają w logu podpis Chrome-Lighthouse, a nie Googlebot, więc adres Google nie oznacza, że wyszukiwarka zaczęła czytać ard.json.

Kto uruchamiał te audyty? W większości ja, testując własne strony. Resztę dorzucili, jak podejrzewam, znajomi SEOwcy 😉 Wniosek przyda się w każdej analizie logów: zanim uznasz, że agenci szukają nowego pliku, to sprawdź, czy to nie Ty go szukasz audytami.

Skąd Lighthouse w tej historii? Od wersji 13.5 z września 2026 ma audyt ARD w eksperymentalnej kategorii Agentic Browsing (do testów potrzebny jest Chrome 150 lub nowszy). Od wersji 13.6 z 27 października szuka manifestu tak, jak opisuje specyfikacja v0.91: w robots.txt, w linku `rel="ard"`, w nagłówku HTTP, pod `/.well-known/ard.json`, a na końcu w starych miejscach (ai-catalog.json i `rel="ai-catalog"`), za które daje ostrzeżenie. Dlatego w logach pytania o oba pliki przychodzą parami. Gdy niczego nie znajdzie, audyt dostaje status „nie dotyczy” i nie wpływa na wynik. Ta sama kategoria sprawdza też llms.txt.

Botów było jak na lekarstwo. Andi-SearchBot (wyszukiwarka Andi) 3 listopada zapytał na podrez.pl o oba pliki przy okazji kilkunastu innych adresów dla agentów. AgentTrustBot, który buduje katalog agentów, 5 i 6 listopada pytał na czterech przewodnikach o karty agentów i serwerów MCP, ale już nie o ard.json. Boty ChatGPT, Claude, Gemini i Perplexity o ten plik nie pytały wcale.

Nie znalazłam też dokumentacji, w której OpenAI, Anthropic, Google albo Microsoft piszą, że ich asystenci czytają ard.json ze stron. Google zapowiada natywną obsługę ARD w najbliższych miesiącach w Agent Registry na Gemini Enterprise Agent Platform, czyli w narzędziu dla firm. O wyszukiwarce Google ogłoszenie nie wspomina. Instrukcje „Connect a chatbot” na stronie specyfikacji podpinają do Claude, ChatGPT czy Copilota wyszukiwarkę narzędzi (GitHub Agent Finder albo Hugging Face Discover). Według specyfikacji plik ze strony ma pobrać crawler rejestru, a chatbot pyta już ten rejestr. Tak działa na przykład Agent Finder w GitHub Copilot: szuka narzędzi w rejestrze, który wybierasz Ty albo Twoja firma. Dla pomiaru to ważne. W logach widzę, kto pytał o plik na moim serwerze, ale ewentualne późniejsze pytanie asystenta do rejestru odbywa się już poza moją domeną.

W podziękowaniach specyfikacji są osoby z AWS, Cisco, Databricks, GitHuba, GoDaddy, Google, Microsoftu, Nvidii, Salesforce i Snowflake. Autorzy dziękują im za wkład i uwagi, ale to nie jest lista firm, które plik wdrożyły.

ard.json czy ai-catalog.json?
-----------------------------

Jeśli w jakimś poradniku widoczności w AI widzisz `ai-catalog.json`, to nie jest to pomyłka, tylko starsza wersja pliku. Poprzednik ARD używał adresu `/.well-known/ai-catalog.json`. Od wersji v0.91 obowiązuje jeden adres: `/.well-known/ard.json`. Narzędzia mogą nadal zaglądać pod stary adres (w specyfikacji „MAY”), ale wydawcy powinni przenieść plik pod nowy („SHOULD”). Część poradników wciąż opisuje starą nazwę.

Oprócz pliku specyfikacja opisuje jeszcze cztery drogi: link `rel="ard"` w sekcji `<head>`, linię `Agentmap:` w robots.txt, wpisy w JSON-LD na stronie opisującej narzędzie i rekordy DNS.

Co jest w środku
----------------

Plik to JSON z jedną wymaganą tablicą `entries`. Każdy wpis opisuje jedno narzędzie i musi mieć cztery rzeczy:

- `identifier`, czyli identyfikator w formacie `urn:air:domena:nazwa`,
- `displayName`, czyli nazwę dla ludzi,
- `type`, czyli typ opisu, na przykład `application/mcp-server-card+json` dla karty serwera MCP albo `application/a2a-agent-card+json` dla karty agenta,
- `url` albo `data`: adres opisu albo opis wpisany na miejscu (dokładnie jedno z nich).

Zalecane są też `representativeQueries`: od 2 do 5 przykładowych pytań, przy których agent powinien sięgnąć po to narzędzie. Do tego opcjonalnie opis, tagi i wersja.

Dla kontrastu: traffic-advice, plik, który ma czytelnika
--------------------------------------------------------

W tych samych logach jest plik z .well-known, o który ktoś pyta codziennie: `/.well-known/traffic-advice`. Przez 20 dni Chrome zapytał o niego 1583 razy, na wszystkich 8 serwisach. To Private Prefetch Proxy Chrome. Zanim proxy zestawi połączenie dla strony pobieranej z wyprzedzeniem, na przykład z wyników Google, sprawdza w tym pliku, czy serwis nie chce ograniczyć takiego ruchu.

Na moich serwisach odpowiedź to 404 i tak zostaje, bo brak pliku oznacza zachowanie domyślne. Co ten plik robi, co jeszcze wyszło przy nim w logach i kiedy warto go dodać, opisałam we wpisie [traffic-advice w logach](https://podrez.pl/traffic-advice/). Już teraz widać jednak różnicę: jeden plik ma prawdziwego czytelnika, a drugi czyta głównie Lighthouse.

Kiedy ard.json ma sens
----------------------

- **Masz publiczny serwer MCP** (na przykład z wyszukiwarką produktów, rezerwacjami albo danymi) i chcesz, żeby agenci go znaleźli.
- **Udostępniasz agenta A2A** z kartą agenta albo pakiet skilli.
- **Masz API dla agentów** i opisujesz je kartą serwera MCP albo agenta.
- **Prowadzisz rejestr albo katalog** narzędzi dla agentów.

Tak mógłby wyglądać plik bloga kulinarnego, który ma własny serwer MCP z wyszukiwarką przepisów. To mój przykład, a nie fragment specyfikacji:

```
{
  "entries": [
    {
      "identifier": "urn:air:example.com:mcp:przepisy",
      "displayName": "Wyszukiwarka przepisów",
      "type": "application/mcp-server-card+json",
      "url": "https://example.com/.well-known/mcp/server-card.json",
      "description": "Serwer MCP do wyszukiwania przepisów.",
      "representativeQueries": [
        "przepis na chleb bez glutenu",
        "obiad keto w 30 minut"
      ]
    }
  ]
}
```

Zwróć uwagę na `url`. Prowadzi do karty serwera MCP, czyli kolejnego pliku, który trzeba mieć. A karta prowadzi do działającego serwera. Bez niego ard.json jest drogowskazem donikąd.

Nawet wtedy pamiętaj, że to propozycja w wersji v0.91. Typy nie są jeszcze zarejestrowane w IANA, a autorzy zastrzegają, że format może się zmienić, więc wdrożenie warto traktować jak test.

Sprawdź swoją stronę

Czy Twoja strona ma ard.json albo starszy ai-catalog.json, sprawdzisz w moim narzędziu **Czy boty AI mogą czytać Twoją stronę?** Pokazuje, czy plik jest, ile ma wpisów i jakiego typu, na przykład serwer MCP. Zgłasza też wpisy bez wymaganych pól. Wynik jest informacyjny i nie zmienia ocen dostępu botów.

**Przykład z 21 listopada 2026:** github.com nie ma ard.json, ale ma stary ai-catalog.json z jednym serwerem MCP. Temu wpisowi brakuje pola `displayName`, więc według ARD nie jest kompletny.

[Sprawdź ard.json na swojej stronie](https://podrez.pl/czy-boty-ai-moga-czytac-strone/)



Co zrobić zamiast tego przy stronie z treścią
---------------------------------------------

- **Sprawdź, czy boty AI w ogóle mogą czytać stronę.** Narzędzie [Czy boty AI mogą czytać Twoją stronę?](https://podrez.pl/czy-boty-ai-moga-czytac-strone/) pokazuje, na co botom AI i wyszukiwarkom pozwalają robots.txt, meta tagi i nagłówki.
- **Zdecyduj o trenowaniu modeli.** Jedną regułę w robots.txt opisałam we wpisie o regule [\_\_usage\_ai-training](https://podrez.pl/usage-ai-training/).
- **Zajrzyj do logów.** Od tego, kto naprawdę przychodzi, zaczyna się [analiza logów serwera](https://podrez.pl/analiza-logow-serwera-a-ai/). Boty AI w swoich logach sprawdzisz też narzędziem [Boty AI w logach](https://podrez.pl/boty-ai-w-logach/).

Podsumowując: ard.json to wizytówka dla narzędzi, a nie dla treści. Jeśli Twoja strona nie ma czego agentom podać do ręki, plik zostanie pusty, a głównym gościem będzie Lighthouse.

Najczęstsze pytania
-------------------

### Czym jest plik ard.json?

To manifest ze specyfikacji Agentic Resource Discovery (ARD), umieszczany pod adresem `/.well-known/ard.json`. Opisuje narzędzia, które agent AI może wywołać: serwery MCP, karty agentów A2A, skille i rejestry. Nie opisuje treści strony.



### Czy ard.json pomaga w widoczności w ChatGPT albo Google?

Nie ma na to dowodów. Nie znalazłam dokumentacji, z której wynikałoby, że ChatGPT, Claude, Gemini czy Copilot czytają ten plik ze stron (GitHub Copilot może szukać narzędzi przez Agent Finder, ale pyta wtedy rejestr, a nie Twoją stronę). W logach 8 moich serwisów z 1–20 listopada 2026 nie pytał o niego żaden bot ChatGPT, Claude, Gemini ani Perplexity. Lighthouse sprawdza go w eksperymentalnej kategorii Agentic Browsing, ale brak pliku nie wpływa na wynik.



### Czym różni się ard.json od ai-catalog.json?

ai-catalog.json to adres z poprzednika ARD. Od wersji v0.91 z 26 sierpnia 2026 obowiązuje `/.well-known/ard.json`. Programy mogą nadal sprawdzać stary adres, ale wydawcy powinni przejść na nowy.





 **Źródła** J. Bu, R.V. Guha, S. Smith, [Agentic Resource Discovery Specification v0.91](https://agenticresourcediscovery.org/spec/), 26.08.2026.
 GitHub ards-project, [schemat ard-entry.schema.json](https://github.com/ards-project/ard-spec/blob/main/spec/schemas/ard-entry.schema.json), odczyt 21.11.2026.
 Google for Developers Blog, [Announcing the Agentic Resource Discovery specification](https://developers.googleblog.com/announcing-the-agentic-resource-discovery-specification/), 17.06.2026.
 Microsoft (R. Guha), [Introducing the Agentic Resource Discovery specification](https://commandline.microsoft.com/agentic-resource-discovery-specification-ard/), 17.06.2026.
 Hugging Face, [Agentic Resource Discovery: Let agents search for tools, skills, and other agents](https://huggingface.co/blog/agentic-resource-discovery-launch), 17.06.2026.
 GitHub Changelog, [Agent finder for GitHub Copilot now available](https://github.blog/changelog/2026-06-17-agent-finder-for-github-copilot-now-available/), 17.06.2026.
 GoogleChrome/lighthouse, [wydania 13.5.0 i 13.6.0](https://github.com/GoogleChrome/lighthouse/releases), 17.09.2026 i 27.10.2026.
 ARD, [Connect a chatbot](https://agenticresourcediscovery.org/connect/), odczyt 21.11.2026.
 Chrome for Developers, [ard.json](https://developer.chrome.com/docs/lighthouse/agentic-browsing/ard), aktualizacja 20.10.2026.
 Chrome for Developers, [Lighthouse agentic browsing scoring](https://developer.chrome.com/docs/lighthouse/agentic-browsing/), aktualizacja 5.05.2026.
 Chrome for Developers (K. Hempenius, K. Baheux, M. Buettner), [Private prefetch proxy in Chrome](https://developer.chrome.com/blog/private-prefetch-proxy), aktualizacja 11.05.2022.
 Private Prefetch Proxy, [Traffic Advice](https://github.com/buettner/private-prefetch-proxy/blob/main/traffic-advice.md), opis propozycji, odczyt 21.11.2026.
 Dane własne: logi serwera 8 serwisów, 1–20.11.2026, odczyt 21.11.2026. 

W przygotowaniu tego tekstu mógł wspierać mnie LLM – najczęściej na etapie researchu, korekty tekstu lub stylowania kodu. Odpowiedzialność za decyzje, postawione tezy i przytoczone argumenty jest w pełni moja. Więcej o tym, [jak pracuję z AI](https://podrez.pl/autorstwo-w-czasach-ai/).