Горздрав СПб

Установка

git clone https://github.com/cucumberian/gorzdrav-spb-skill.git ~/.agents/skills/spb-gorzdrav

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Учит агента проходить цепочку публичного API Горздрава: район, поликлиника, специальность, врач и свободные слоты. Агент находит реальные талоны и формирует ссылку на портал с уже подставленными параметрами, а записывается человек сам через сайт и ЕСИА. Работает только на чтение, без авторизации и персональных данных. В SKILL.md описаны подводные камни API, проверенные на живых запросах, и таблица кодов ошибок.

Для кого. Жителям Санкт-Петербурга, которые хотят поручить агенту поиск свободного времени у врача.

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

Найди мне стоматолога на ближайшее время, я живу в Калининском районе

Ограничения

Только чтение: запросы по полису, поиск пациента, создание и отмена записи запрещены. Между запросами обязательна пауза в одну секунду, опрос не чаще раза в 30 секунд. Ошибки API приходят с HTTP 200, поэтому проверяется поле success.

Как отключить. Удалите папку ~/.agents/skills/spb-gorzdrav.

Проверка безопасности

• Агент выполняет сетевые запросы к городскому API через curl

Коротко о README

Скилл учит LLM-агента работать с публичным REST API городского портала записи к врачам Санкт-Петербурга. Он совместим со средами, которые читают ~/.agents/skills, например Claude Code. Внутри правила только чтения, рецепты запросов, нюансы идентификаторов специальностей и генерация ссылок на портал. ФИО врачей в примерах заменены плейсхолдерами. Лицензия MIT.

SKILL.md

---
name: spb-gorzdrav
description: "Работа с публичным API Горздрава СПб (gorzdrav.spb.ru): районы, медучреждения (ЛПУ), специальности, врачи, расписание, поиск свободных талонов и слотов, генерация ссылки для записи. Только чтение, без авторизации и без персональных данных. Работает через curl на Linux/macOS/Windows. Триггеры: горздрав, gorzdrav, спб, талон, талоны, запись к врачу, свободные талоны, поликлиника, ЛПУ, расписание врача, прием врача, cityhealth, gorzdrav.spb.ru."
---

# spb-gorzdrav — API Горздрава Санкт-Петербурга

Публичный REST API портала `gorzdrav.spb.ru`. Авторизации нет, отдает JSON.
Скилл покрывает **только чтение**: найти поликлинику, specialty, врача, посмотреть
слоты и дать человеку ссылку для записи.

## Железные правила

1. **Только чтение.** НИКОГДА не вызывай `patient/search`, `appointment/create`,
   `appointment/cancel` и `oms/attachment/lpus?polisN=` — это операции с
   персональными данными (СНИЛС/ЕСИА, ФИО, дата рождения, полис) и с записью
   от имени реального человека. Вне рамок явной просьбы владельца не делается.
2. **Не спамь.** Между запросами к API держи паузу `sleep 1`. Не запускай
   опрос чаще, чем раз в 30 секунд, и не гоняй параллельные запросы — API
   принадлежит городскому учреждению.
3. **User-Agent обязателен.** Без нормального UA часть запросов режется.
   Используй `User-Agent: gorzdrav-spb-bot`.
4. **Проверять `success`, а не HTTP-код.** Ошибка приходит как **HTTP 200** с
   `{"success": false, "errorCode": N, "message": "..."}`.

## База

```
BASE=https://gorzdrav.spb.ru/_api/api/v2
```

Все ответы завернуты в обертку:

```json
{ "result": <полезная нагрузка>, "success": true, "errorCode": 0,
  "message": null, "stackTrace": null }
```

### Цепочка навигации (главный принцип)

```
район(district) → медучреждение(lpu) → специальность(speciality) → врач(doctor) → слот(appointment)
```

Похожие