Горздрав СПб — скилл
spb-gorzdrav
Скилл ищет свободные талоны к врачам Санкт-Петербурга через публичный API gorzdrav.spb.ru и дает ссылку для записи
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент выполняет сетевые запросы к городскому API через curl
Установка
- Работает в
Ручная установка
git clone https://github.com/cucumberian/gorzdrav-spb-skill.git ~/.agents/skills/spb-gorzdravДля сред, которые читают каталог ~/.agents/skills.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент выполняет сетевые запросы к городскому API через curl
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Учит агента проходить цепочку публичного API Горздрава: район, поликлиника, специальность, врач и свободные слоты. Агент находит реальные талоны и формирует ссылку на портал с уже подставленными параметрами, а записывается человек сам через сайт и ЕСИА. Работает только на чтение, без авторизации и персональных данных. В SKILL.md описаны подводные камни API, проверенные на живых запросах, и таблица кодов ошибок.
Для кого. Жителям Санкт-Петербурга, которые хотят поручить агенту поиск свободного времени у врача.
Подходит, если
- Нужно найти ближайший свободный талон к врачу нужной специальности
- Нужно сравнить поликлиники района по доступным слотам
- Нужно разобрать ссылку на расписание с портала Горздрава
Не подходит, если
- Нужно записаться или отменить запись: скилл это намеренно запрещает
- Нужны медучреждения за пределами Санкт-Петербурга
Пример запроса к агенту
Найди мне стоматолога на ближайшее время, я живу в Калининском районеОграничения
Только чтение: запросы по полису, поиск пациента, создание и отмена записи запрещены. Между запросами обязательна пауза в одну секунду, опрос не чаще раза в 30 секунд. Ошибки API приходят с HTTP 200, поэтому проверяется поле success.
Как отключить. Удалите папку ~/.agents/skills/spb-gorzdrav.
Частые вопросы
Какие зависимости нужны?
Только curl. Python и jq не требуются. В PowerShell нужно вызывать curl.exe, потому что curl там это алиас.
Может ли агент записать меня к врачу?
Нет. Агент отдает ссылку на портал, а запись делается на сайте через ЕСИА.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыПоиск туров, отелей, авиабилетов, поездов и экскурсий через Aviasales, Travelata, Level.Travel, Tutu.ru, Tripster и Sputnik8
Набор бытовых скиллов для агента: веб-поиск, автоматизация браузера, Gmail, Google Календарь и Диск, расшифровка речи и субтитры YouTube
Неофициальный Python-клиент и скилл для личного кабинета СберМобайл: тариф, остатки пакетов, услуги и бонусы
Поиск работы в кодовом агенте: оценка вакансии по резюме от 1 до 5, CV в PDF под каждую роль, черновики писем и трекер откликов
Скиллы для агента: поиск и бронирование отелей и авиабилетов по всему миру через API TourMind, сравнение цен, оплата и управление заказами
Набор скиллов для резюме и поиска работы: адаптация под вакансию, проверка на прохождение ATS, сопроводительные письма и подготовка к собеседованию
Коротко о README
Скилл учит LLM-агента работать с публичным REST API городского портала записи к врачам Санкт-Петербурга. Он совместим со средами, которые читают ~/.agents/skills, например Claude Code. Внутри правила только чтения, рецепты запросов, нюансы идентификаторов специальностей и генерация ссылок на портал. ФИО врачей в примерах заменены плейсхолдерами. Лицензия MIT.
Бейдж для README
Исходный 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)
```