Dane publiczne Oficjalne API

Dane o gminach i powiatach z GUS BDL

Porównaj ludność i inne wskaźniki gmin lub powiatów w GUS BDL. Skill dobiera wspólny rok i zachowuje jednostki miary oraz definicje danych.

Zainstaluj skill

Do czego służy ten skill?

Porównanie dwóch gmin lub powiatów jest użyteczne dopiero wtedy, gdy dane opisują ten sam poziom administracyjny i ten sam rok. Skill wyszukuje jednostki w Banku Danych Lokalnych GUS i pomaga dobrać właściwe wskaźniki do porównania.

Wynik zachowuje identyfikator jednostki, definicję wskaźnika, jednostkę miary i rok. Można podać rok samodzielnie albo wybrać najnowszy wspólny okres z danymi. Nazwy jednostek bywają zbieżne, dlatego ważne jest rozróżnienie gminy, miasta, części wiejskiej i powiatu.

  • Wyszukiwanie jednostek terytorialnych i wskaźników
  • Porównanie w podanym lub wspólnym najnowszym roku
  • Definicje, jednostki miar i oznaczenia braku danych

Przykładowe pytania do agenta

  • Znajdź gminy o nazwie Piaseczno w GUS BDL.
  • Porównaj liczbę ludności tych dwóch powiatów w jednym roku.
  • Wyszukaj wskaźnik budownictwa dostępny dla mojej gminy.

Najpierw znajdź jednostki i wskaźnik. Następnie porównaj wskazane identyfikatory BDL w jednym roku. Agent powinien podać definicję danych, a przy brakach wyjaśnić zakres dostępnej serii.

Zakres i ograniczenia

  • Nie każdy wskaźnik jest dostępny dla gminy; część danych dotyczy powiatów lub województw.
  • API GUS ma limity zapytań, a najnowszy rok może różnić się między seriami.
  • Podczas weryfikacji 5 listopada 2026 r. odczyty API GUS kończyły się błędami lub przekroczeniem czasu. Pełny wynik wymaga dostępnego źródła; lokalne testy nie potwierdzają bieżącej dostępności.

Instalacja i uruchomienie

W terminalu, w katalogu projektu, uruchom instalator wybranego skilla:

curl -fsSL https://raw.githubusercontent.com/b44x/ai-polish-skills/main/install.sh | bash -s moja-gmina

Instalator zapisuje instrukcje i skrypt w .agents/skills/moja-gmina/. Agent odczytuje plik SKILL.md, a skrypt pobiera dane i zwraca wynik w JSON. Dostępne komendy sprawdzisz lokalnie:

python3 .agents/skills/moja-gmina/scripts/moja_gmina.py --help

Wymagany jest Python 3.8 lub nowszy; skrypt korzysta ze standardowej biblioteki. W Windows polecenie python3 można zastąpić py.

Pełne instrukcje i przykłady w SKILL.md ↗

← Wróć do wszystkich 17 skilli