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

nfz — скилл для Claude Code: очереди и установка

Скилл для Claude Code ищет медицинские услуги NFZ и показывает очереди, сроки ожидания и учреждения. Запрашивайте данные по городу, региону или радиусу вокруг точки.

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

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

Что делает nfz

Скилл получает данные NFZ о медицинских услугах и очередях через скрипт scripts/nfz.py. Он ищет официальные названия услуг, показывает сроки ожидания и число пациентов для срочных и обычных случаев, находит учреждения поблизости и сравнивает очереди. Данные подходят для административного поиска, а не для медицинских выводов.

PCUŚ — статистическая оценка срока ожидания, а не дата ближайшего свободного приёма. Для работы нужны Python 3.8+ и сетевой доступ к API NFZ; скрипт использует стандартную библиотеку Python и не требует ключа API. Ошибка сети или сервера NFZ мешает получить свежие данные.

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

  • найти учреждения NFZ для нужного обследования
  • узнать оценочный срок ожидания в городе
  • сравнить очереди в клиниках и больницах
  • найти ближайшие учреждения в заданном радиусе

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

  • Найди очередь на МРТ в Гданьске и покажи учреждения.
  • Сравни сроки ожидания к кардиологу в Варшаве.
  • Найди учреждения для колоноскопии в радиусе 30 км от координат 54.35, 18.64.

Как установить nfz

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

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

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

2Через Skills CLI (Vercel)

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

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

~/.claude/skills/nfz/SKILL.md

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

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

Вопросы о nfz

Как установить nfz в Claude Code?

В Claude Code добавьте маркетплейс командой /plugin marketplace add b44x/ai-polish-skills, затем установите скилл: /plugin install nfz@polskie-skille.

Что делает nfz?

Скилл ищет услуги NFZ, очереди и учреждения, а также сопоставляет сроки ожидания и расстояния. Оценка PCUŚ не является датой ближайшего свободного приёма.

Что нужно для работы nfz?

Нужны Python 3.8+ и сетевой доступ к API NFZ. Ключ API не требуется; скрипт использует стандартную библиотеку Python.

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

SKILL.md · MIT
---
name: nfz
display_name: NFZ Kolejki i Czas Oczekiwania (PCUŚ)
version: 1.0.0
description: >-
  Official data from the Narodowy Fundusz Zdrowia (NFZ, Polish National Health Fund) on queues,
  medical facilities and estimated waiting times for healthcare services (PCUŚ). Search medical
  services (MRI, CT, colonoscopy, gastroscopy, cardiology clinic, orthopedist, ophthalmologist),
  check the estimated waiting time (in days and months) and the number of waiting patients for
  stable and urgent cases. Find the nearest facilities within a given radius in kilometers
  (Haversine) and compare waiting times across hospitals and clinics. No API keys, 100% official
  public data from the NFZ Terminy Leczenia API. Use whenever the user asks about: "kolejki NFZ",
  "czas oczekiwania do kardiologa", "gdzie na rezonans na NFZ", "terminy leczenia",
  "poradnia NFZ w Gdańsku", "najkrótsza kolejka do endokrynologa", "NFZ czas oczekiwania".
category: health
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: Narodowy Fundusz Zdrowia (NFZ)
source_type: official_api
official: true
homepage: https://terminyleczenia.nfz.gov.pl/
documentation: https://apinfz.nfz.gov.pl/app-itl-api-pcus/
rate_limit: fair use
last_verified: 2026-09-28
tags:
  - nfz
  - zdrowie
  - kolejki
  - pcus
  - lekarz
  - przychodnia
  - szpital
  - rezonans
  - tomografia
  - kardiolog
  - stomatolog
  - terminy
compatibility: Python 3.8+ (standard library only); network access to apinfz.nfz.gov.pl.
---

# NFZ Queues and Waiting Times (PCUŚ)

Official skill integrating open data from the Narodowy Fundusz Zdrowia (NFZ) Terminy Leczenia / PCUŚ v1.4 API
via the `scripts/nfz.py` tool. Works without registration and without API keys, uses only the Python standard
library, and returns structured JSON on `stdout`.

> **Important:** PCUŚ (*Prognozowany Czas Oczekiwania na Świadczenie*, estimated waiting time for a service)
> is a statistical estimate calculated by NFZ — it is **not** the date of the first free appointment.

## Running the script

Run from the skill directory (or from the repository root path):

| Operating system | Command |
|---|---|
| Linux / macOS | `python3 scripts/nfz.py <command> …` |
| Windows | `py scripts/nfz.py <command> …` (or `python`) |

Zero external libraries (Python 3.8+ stdlib).

## Workflow

1. **Looking up the official service name:**
   - When the user asks generally about a test or specialty (e.g. „rezonans”, „kardiolog”, „kolonoskopia”):
     `python3 scripts/nfz.py benefits rezonans`
     `python3 scripts/nfz.py benefits kardiolog`
     `python3 scripts/nfz.py benefits kolonoskopia`
   - Returns a list of official NFZ service names that can be passed to subsequent queries.

2. **Queues and waiting times in a given city / voivodeship (województwo):**
   - Checking the waiting time for a service in a specific city:
     `python3 scripts/nfz.py queues --benefit "REZONANS MAGNETYCZNY" --locality Gdańsk`
     `python3 scripts/nfz.py queues --benefit "ŚWIADCZENIA Z ZAKRESU KARDIOLOGII" --locality Warszawa`
   - Filtering for an urgent case (urgent / "cito" referral):
     `python3 scripts/nfz.py queues --benefit "REZONANS MAGNETYCZNY" --locality Gdańsk --urgent`

3. **Geographic search for facilities within a radius in kilometers (`near`):**
   - Finding facilities providing a given service within a radius of a given city or coordinates:
     `python3 scripts/nfz.py near Gdańsk --benefit "rezonans" --radius-km 50`
     `python3 scripts/nfz.py near 54.35 18.64 --benefit "kolonoskopia" --radius-km 30`
   - Sorting by shortest waiting time (`--sort time`) or smallest distance (`--sort distance`).

4. **Comparing facilities and shortest queues (`compare`):**
   - Side-by-side comparison of facilities, highlighting the facility with the shortest waiting time:
     `python3 scripts/nfz.py compare --benefit "rezonans" --locality Gdańsk`
     `python3 scripts/nfz.py compare --benefit "kardiolog" --province pomorskie`

5. **List of NFZ voivodeship codes (`provinces`):**
   - Overview of the 16 NFZ codes (e.g. `11` for pomorskie, `07` for mazowieckie):
     `python3 scripts/nfz.py provinces`

## Commands

| Command | Description | Returned data |
|---|---|---|
| `benefits <query>` | Dictionary of official service names | `query`, `count`, `benefits` |
| `queues [--benefit B] [--province P] [--locality L] [--urgent]` | Waiting times and list of facilities | `place`, `provider`, `locality`, `address`, `phone`, `waitingTime` (`pcus`, `averagePeriodDays`, `awaiting`), `accessibility` |
| `near <location\|lat> [lon] --benefit <B> [--radius-km R]` | Facilities within a radius in km, with distances | Facility objects with computed `distanceKm`, sorted by the chosen criterion |
| `compare --benefit <B> [--locality L] [--province P]` | Comparative summary of facilities | `highlights` (`shortestWaitClinic`, `fewestAwaitingClinic`, `closestClinic`), list of facilities |
| `provinces` | Dictionary of the 16 voivodeships and NFZ codes | Two-digit codes and voivodeship names (offline) |

Detailed description of JSON schemas: [references/output.md](references/output.md).

## Exit codes

Clean JSON goes to `stdout`; errors go to `stderr` as `{"error": "...", "type": "..."}`.

| Code | Meaning | Action |
|---|---|---|
| `0` | Success | Use the JSON data from `stdout` |
| `2` | Not found | No facilities or no such service in the NFZ register |
| `64` | Invalid invocation / validation | Check the parameters (min. 3-character phrase, valid voivodeship code) |
| `69` | NFZ server / network error | `apinfz.nfz.gov.pl` API error or network problem |

## Rules

- **Always cite the data source:** Narodowy Fundusz Zdrowia (NFZ / Terminy Leczenia).
- **Distinguish PCUŚ from an appointment date:** NFZ data presents the *Prognozowany Czas Oczekiwania na Świadczenie* (a statistical time calculated by NFZ based on recent months), not a guaranteed first free appointment. Explain this to the user.
- **Medical neutrality:** The tool provides administrative queue data. Do not make medical diagnoses or assess the quality of care at a given facility.
- **Recommend a phone call:** Suggest that the user contact the facility's registration desk directly by phone (number given in the `phone` field) before going there in person.

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

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

Все скиллы по теме «Бэкенд и API» →
kolejki-nfz-mcp ContentWriterco MCP-сервер kolejki-nfz-mcp для Claude Code ищет в Польше специалистов, исследования и лечение с коротким прогнозом ожидания NFZ. CX Codex +1 ★ 15звёзд репо Open Health Sync soma-intelligence Open Health Sync — MCP-сервер для Claude Code и других клиентов, который даёт read-only доступ к данным носимых устройств. Агент запрашивает пульс, сон, тренировки, питание и дневные сводки; сервер запускается у вас. CX Codex +1 ★ 72звёзд репо france-data-mcp cturkieh MCP-сервер france-data-mcp для Claude Code объединяет данные 13 государственных реестров Франции для анализа здравоохранения, демографии и рынка недвижимости. Подключается через URL или npx. CX Codex +1 ★ 5звёзд репо who-gho-mcp-server cyanheads MCP-сервер who-gho-mcp-server предоставляет доступ к базе данных Global Health Observatory Всемирной организации здравоохранения с фильтрацией по странам, полу и годам. CX Codex +1 2 866установок signal uphealth MCP-сервер signal, который подключает к агентам и IDE проверенные факты о здоровье из CDC, NIH и других федеральных источников. Работает без API-ключа и регистрации — просто установи и вызывай инструменты. CX Codex +1 4 721установок apteka-cis apteka-health MCP-сервер apteka-cis ищет лекарства по симптому или бренду, сравнивает цены и находит аптеки рядом в восьми странах СНГ. CX Codex +1 404установок

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

Весь набор →
nieruchomosci Скилл nieruchomosci для Claude Code ищет записи о сделках с недвижимостью в польском реестре RCN. Можно искать рядом с координатами или в заданной области и фильтровать результаты по дате, рынку и площади. CX Codex +1 ★ 60звёзд репо sejm Скилл sejm для Claude Code обращается к официальному API польского Сейма. Агент подключает его для поиска депутатов, голосований, законопроектов и депутатских запросов. CX Codex +1 ★ 60звёзд репо prawo Скилл prawo для Claude Code ищет польские законы через официальный API Сейма. Он находит статьи, статус акта и сведения о поправках. CX Codex +1 ★ 60звёзд репо imgw Получает данные IMGW-PIB о погоде, предупреждениях и уровнях воды в Польше. Запускается на запросы о температуре, ветре, осадках или состоянии рек. CX Codex +1 ★ 60звёзд репо apteki Скилл apteki для Claude Code ищет записи польских аптек в официальном реестре CeZ. Включается по запросам найти аптеку, адрес, телефон или статус. CX Codex +1 ★ 60звёзд репо produkty Скилл produkty для Claude Code ищет состав и пищевую ценность по штрихкоду или названию; сведения о составе и аллергенах берёт из Open Food Facts, по умолчанию — для товаров с заявленной продажей в Польше. CX Codex +1 ★ 60звёзд репо leki Скилл leki для Claude Code ищет польские лекарства в официальном реестре RPL по названию, действующему веществу или GTIN/EAN. Он возвращает варианты препарата, сведения об упаковке и ссылки на документы производителя. CX Codex +1 ★ 60звёзд репо ceny-deweloperow Скилл ceny-deweloperow для Claude Code восстанавливает историю опубликованных цен на конкретную квартиру или дом. Показывает даты наблюдений, изменения цены и пропуски в данных. CX Codex +1 ★ 60звёзд репо

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

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