К основному содержанию
скилл CX Codex

moja-gmina — скилл для Claude Code: статистика и установка

Скилл moja-gmina для Claude Code ищет статистику GUS BDL и сравнивает польские территориальные единицы за общий год. Запускается для запросов о населении, демографии, строительстве или безработице.

MIT ★ 60 обновлён 2026-11-15

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add b44x/ai-polish-skills
/plugin install moja-gmina@polskie-skille
Открыть на GitHub

Что делает moja-gmina

Скилл находит муниципалитеты, повяты и воеводства в базе GUS BDL, ищет статистические показатели и сравнивает выбранные единицы. Скрипт scripts/moja_gmina.py принимает команды units, indicators, indicator и compare; результат выводится в JSON. При совпадающих названиях территорий важно различать их по уровню, типу и родительскому идентификатору.

Для работы нужны Python 3.8+ и доступ в интернет. API принимает анонимные запросы, а ключ BDL_API_KEY можно задать, чтобы повысить лимиты. Без общего года с данными для всех выбранных единиц сравнение подбирает последний общий год отдельно для каждого показателя; пустые наблюдения и статистическая конфиденциальность не означают ноль. Данные поступают из официального Банка локальных данных GUS.

Какие задачи решает

  • найти муниципалитет по названию и уровню
  • подобрать показатель и посмотреть его определение
  • сравнить население нескольких территорий за общий год
  • сопоставить безработицу или строительство на местном уровне

Примеры запросов агенту

  • Найди муниципалитеты с названием Piaseczno на уровне 6.
  • Подбери показатель для сравнения безработицы на уровне повята.
  • Сравни население этих двух единиц за 2024 год.

Как установить moja-gmina

1Через маркетплейс плагинов

/plugin marketplace add b44x/ai-polish-skills
/plugin install moja-gmina@polskie-skille

Команда ставит плагин moja-gmina целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add b44x/ai-polish-skills --skill moja-gmina -a claude-code

3Вручную: положить файлы

~/.claude/skills/moja-gmina/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/moja-gmina/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о moja-gmina

Как установить moja-gmina в Claude Code?

Выполни /plugin marketplace add b44x/ai-polish-skills и затем /plugin install moja-gmina@polskie-skille. Команды вводятся в Claude Code.

Что делает moja-gmina?

Скилл ищет территориальные единицы и показатели в GUS BDL, а затем сравнивает выбранные территории. В результатах сохраняются уровень территории, единицы измерения и атрибуты пропущенных данных.

Что нужно для работы moja-gmina?

Нужны Python 3.8+ и доступ в интернет. API доступен анонимно; BDL_API_KEY необязателен и повышает лимиты запросов.

Исходный текст

SKILL.md · MIT
---
name: moja-gmina
display_name: Moja gmina — statystyki GUS BDL
version: 1.0.0
description: >-
  Search official GUS BDL statistics and compare Polish municipalities, counties or voivodeships for a common year. Use for population, local demography, construction or unemployment comparisons, finding territorial units and statistical indicators. Preserves geographic levels, units of measure and missing-data attributes.
category: public_data
language: pl
country: PL
license: MIT
author: Michell Hoduń (https://github.com/b44x)
repository: https://github.com/b44x/ai-polish-skills
network: true
authentication: none
source: Główny Urząd Statystyczny — Bank Danych Lokalnych
source_type: official_api
official: true
homepage: https://bdl.stat.gov.pl/
documentation: https://api.stat.gov.pl/home/bdlapi
rate_limit: Anonymous 5 requests/s, 100/15 min, 1000/12 h, 10000/week; optional BDL_API_KEY increases limits.
last_verified: 2026-11-05
tags:
  - gus
  - bdl
  - gmina
  - powiat
  - demografia
  - ludnosc
  - statystyki
compatibility: Python 3.8+ (standard library only); internet access required.
---

# GUS BDL local statistics

## Running the script

Run `python3 scripts/moja_gmina.py <command>` from this skill's directory (`py` on Windows).

| Command | Purpose |
|---|---|
| `units "Piaseczno" --level 6` | Find municipalities, preserving unit type and parent identifier |
| `indicators "ludność" --level 6` | Search indicators and their dimensions |
| `indicators "bezrobotni" --level 5` | Find an appropriate county-level series |
| `indicator ludnosc` | Full definition and available years for total population (BDL 72305) |
| `compare --units <ID_BDL_1> <ID_BDL_2> --indicators ludnosc --year 2024` | Compare units found through `units` for a common year |
| `compare --units <ID_BDL_1> <ID_BDL_2> --indicators <INDICATOR_ID>` | Select the latest year with data for both units |

## Workflow and interpretation

1. Resolve units through `units`; the 12-digit BDL identifier differs from a shortened TERYT code. For matching names, inspect `level`, `kind` and `parentId`. An urban-rural municipality, its town and its rural part may be separate units.
2. Select an indicator through `indicators`, then inspect its full definition with `indicator`. Names `n1`…`n5`, unit of measure, geographic level and available years are part of the definition. Total and per-capita income are different series; wages or unemployment rates may not be available at municipality level.
3. `compare` accepts up to 10 units of the same level and up to 5 indicators. Without `--year`, it chooses the latest common year **separately for each indicator**. `no_common_data` means no comparable data; do not substitute another unit's latest year.
4. Cite **GUS, Bank Danych Lokalnych**, the year, unit of measure and indicator definition. Preserve attributes, methodological notes and territorial scope. `null`, absent observations and statistical confidentiality do not mean zero. Population size is neither a quality-of-life rating nor a forecast.

## Cache, availability and exit codes

Metadata is cached for 24 hours and data for 1 hour in `~/.cache/ai-polish-skills/moja-gmina`. Put `--no-cache` before the command to force a fetch. `requests` contains the URL, actual retrieval time and cache status. Root-level `fetched_at` is the response preparation time. Override the cache directory with `MOJA_GMINA_CACHE_DIR`. There is no fallback to expired data.

The API supports anonymous access; optionally set `BDL_API_KEY` for the `X-ClientId` header. On HTTP 429, the skill exits with 69 and reports `retry_after`; respect that delay before another attempt. Do not increase request frequency during an outage. During verification on 2026-11-05, official API documentation and the schema were available, but REST data requests timed out; offline tests do not confirm service availability.

Success: JSON on stdout, exit `0`. Errors: JSON on stderr, exit `2` for a missing resource/results, `64` for validation or `69` for network/API/format/rate-limit errors. `--help` returns `0`. Read [references/api.md](references/api.md) for API details.

© Michell Hoduń (https://github.com/b44x) · MIT · b44x/ai-polish-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
deweloperuch.pl (unofficial) MBratkowski deweloperuch.pl (unofficial) — MCP-сервер с доступом ИИ к ценам на новостройки в Польше, зарегистрированным сделкам и статистике GUS и NBP. Данные можно сравнивать с предложениями. CX Codex +1 ★ 29звёзд репо ResultRail by LarryBuildsAI larrybuildsai ResultRail by LarryBuildsAI — MCP-сервер для получения публичных данных по доменам и URL с оплатой только за успешный результат. Возвращает источники, оценку надёжности и хеш квитанции для обогащения данных и разовых запросов. CX Codex +1 6 708установок LiveDataLink blackboxfoundry LiveDataLink подключает ИИ-агента к источникам публичных данных через MCP. Он пригодится для проверок компаний, котировок, недвижимости и санкционных списков. CX Codex +1 3 686установок TapWaterMap squidcode MCP-сервер TapWaterMap подключает к агенту открытые данные EPA о водоснабжении городов США. Помогает проверить нарушения и список загрязнителей без ключей доступа. CX Codex +1 1 707установок cristianoaredes-mcp-dadosbr cristianoaredes MCP-сервер cristianoaredes-mcp-dadosbr для Claude Code и других ИИ-ассистентов. Подключает к публичным реестрам Бразилии: CNPJ, CEP, судебные процессы, госконтракты и курсы Банка Централ. CX Codex +1 ★ 10звёзд репо alphago2580-naramarketmcp alphago2580 MCP-сервер alphago2580-naramarketmcp для Claude Code даёт агенту доступ к данным корейских госзакупок: тендерам, контрактам и статистике. Подключается через HTTP. CX Codex +1 ★ 5звёзд репо

Из того же набора52

Весь набор →
adresy Скилл adresy для Claude Code ищет польские адреса и переводит GPS-координаты в ближайшую точку адреса. Запускается по запросам на геокодирование адреса или обратный поиск по координатам. CX Codex +1 ★ 60звёзд репо energia Скилл energia для Claude Code получает рыночные цены на электроэнергию PSE в Польше. Он находит самое дешёвое непрерывное окно потребления и сводит исторические цены. CX Codex +1 ★ 60звёзд репо otwarte-dane Скилл otwarte-dane для Claude Code ищет польские государственные наборы данных и сведения об их ресурсах. Запускается по запросу найти открытые данные, источники для анализа или API польских ведомств. CX Codex +1 ★ 60звёзд репо ostrzezenia-gis Скилл ostrzezenia-gis для Claude Code ищет предупреждения GIS на Gov.pl по названию продукта или бренда. Проверяйте публикации о снятых с продажи продуктах и сверяйте номер партии с текстом уведомления. CX Codex +1 ★ 60звёзд репо krs Получает записи польского реестра KRS через API Министерства юстиции. По запросу о компании он показывает её статус, состав органов и правила подписания договоров. CX Codex +1 ★ 60звёзд репо przetargi Скилл przetargi для Claude Code ищет польские закупки в BZP и показывает сведения об объявлении. Запросы можно фильтровать по теме, региону заказчика, CPV и датам публикации. CX Codex +1 ★ 60звёзд репо solid-jobs Ищет вакансии и статистику зарплат на SOLID.Jobs. Фильтрует предложения по запросу, городу, опыту и удалённой работе. CX Codex +1 ★ 60звёзд репо inpost Отслеживает посылки InPost и ищет постаматы с пунктами выдачи в Польше. Запускается на запрос о статусе отправления, адресе постамата или ближайшей точке. CX Codex +1 ★ 60звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой