{
  "markdown": "# otwarteapi-catalog\n\nPubliczne dane katalogu stojące za [otwarteAPI.pl](https://otwarteapi.pl) —\nkatalogu publicznych API rządowych z całego świata (Polska, Unia Europejska\ni kraje z 6 kontynentów — 32 jurysdykcje), opisanych tak by mogły być\nodkrywane i wywoływane przez agentów AI oraz ludzi.\n\n## Co to jest\n\n`ai-catalog.json` w formacie **ARD (Agent Resource Directory)** — jeden\nmaszynowo czytelny plik opisujący każde API: nazwę, opis, endpoint,\nwymagany klucz/autoryzację, jurysdykcję (kod kraju, `EU` lub `INT`), tagi i\nprzykładowe zapytania. Ten sam plik serwuje sama strona pod\n[otwarteapi.pl/.well-known/ai-catalog.json](https://otwarteapi.pl/.well-known/ai-catalog.json).\n\n## Kto to prowadzi\n\nBartosz Kuć (ten sam autor co [skanfirmy.pl](https://skanfirmy.pl)),\nprywatny projekt non-profit. Kontakt: firma@bartosza.pl. Więcej na\n[otwarteapi.pl/o-projekcie](https://otwarteapi.pl/o-projekcie).\n\n## To jest lustro, nie źródło prawdy\n\nTo repozytorium to **kopia** stanu produkcyjnego, aktualizowana ręcznie.\nZaakceptowane PR-y i issue trafiają najpierw tutaj do przeglądu, a\ndopiero potem są ręcznie przenoszone do prywatnego repo, które faktycznie\nzasila stronę produkcyjną — nie ma automatycznej synchronizacji w żadną\nstronę.\n\n## Jak zgłosić nowe API lub poprawkę\n\n1. **Nowe API**: otwórz issue albo PR dodający wpis do `entries[]` w\n   `ai-catalog.json`. Wymagane pola: `identifier` (URN, np.\n   `urn:air:otwarteapi.pl:api:twoj-slug`), `displayName`, `description`,\n   `url` (dokumentacja techniczna), `type`, `jurisdiction` (`PL`/`EU`/kod\n   kraju), `tags`, `metadata.auth` (`brak` jeśli bez klucza), oraz\n   `representativeQueries` (2-3 przykładowe pytania, po jednym w\n   naturalnym języku). API musi być **publiczne, oficjalne** (rządowe,\n   samorządowe lub międzynarodowej instytucji publicznej) i mieć żywą,\n   działającą dokumentację.\n2. **Poprawka istniejącego wpisu** (zmieniony endpoint, nieaktualny opis,\n   błędna jurysdykcja): PR edytujący konkretny wpis, z krótkim\n   uzasadnieniem w opisie PR.\n3. Każdy PR jest ręcznie recenzowany pod kątem poprawności i tego, czy\n   API faktycznie działa (żywy `curl`/test), zanim trafi do wersji\n   produkcyjnej.\n\n## Licencja\n\nMIT — patrz [LICENSE](LICENSE). Same dane API pozostają własnością i na\nlicencji swoich pierwotnych źródeł (rządów/instytucji UE); ten plik tylko\nje katalogizuje i linkuje do oficjalnej dokumentacji.\n",
  "bytes": 2391,
  "sha": "0b7694a8cee4ab66b5eca64f4ab27b20cd6287a72307aa4e4e7b1d9d64439e3a",
  "repo_slug": "bartosz-kuc/otwarteapi-catalog",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bartosz_kuc_otwarteapi_57a32238/readme"
}