# confcal, полная выгрузка для агентов

> Каталог ИТ-конференций и митапов России с подписными календарями ICS. Этот файл собран для машин: он повторяет содержимое страницы https://confcal.rpa.icu/agents и добавляет справочники целиком, чтобы агенту хватило одного GET.

## Что это за сервис

Пользователь задаёт фильтр из городов и тем, получает ссылку на календарь и подписывается на неё в Google Calendar, Apple Calendar или Outlook. Календарь обновляется сам, новые события появляются в нём в течение суток.

Каталог наполняется автоматически: детерминированные фетчеры читают публичные доски событий, агент-кравлер разбирает остальные источники, а решение о склейке дублей принимает детерминированный резолвер, не языковая модель. Данные обновляются раз в сутки, поэтому свежесозданное событие появляется не мгновенно.

## MCP-сервер

Адрес: https://confcal.rpa.icu/mcp
Транспорт: streamable HTTP
Авторизация: нет, всё только на чтение
Карточка сервера: https://confcal.rpa.icu/mcp/server-card
Каталог домена: https://confcal.rpa.icu/.well-known/ai-catalog.json

Конфиг для клиента MCP:

    {
      "mcpServers": {
        "confcal": {
          "type": "http",
          "url": "https://confcal.rpa.icu/mcp"
        }
      }
    }

Claude Code добавляет сервер одной командой:

    claude mcp add --transport http confcal https://confcal.rpa.icu/mcp

## Инструменты

list_cities(limit, offset)
Города справочника со счётчиком будущих событий. Отдельным полем online_count приходит число будущих онлайн-событий. Страница до 100 элементов, в ответе items, total, limit, offset и has_more.

list_topics(limit, offset)
Темы справочника со счётчиком будущих событий. Постранично так же, как города.

search_events(cities, topics, date_from, date_to, event_format, only_free, limit, offset)
Поиск будущих событий. Несколько городов или тем объединяются по или. Города и темы принимаются в любом написании, Москва, мск и moscow это одно и то же. Ключевое слово online в списке городов добавляет события без привязки к городу. Даты в формате YYYY-MM-DD, event_format принимает offline, online или hybrid. Описания в выдаче обрезаны, полный текст лежит на странице события по ссылке из поля url.

calendar_link(topics, cities, include_online)
Ссылка на Telegram-бота с уже разобранным фильтром. Возвращает telegram_url, разобранный filter и человекочитаемое calendar_name. Пустой список городов означает всю страну.

Нераспознанные город или тема возвращаются ошибкой со списком допустимых слагов, а не отбрасываются молча.

## Как получается календарь

Подписку заводит только Telegram-бот, MCP-сервер в каталог ничего не пишет. Агент собирает фильтр, вызывает calendar_link и отдаёт пользователю ссылку вида https://t.me/confcal_bot?start=moscow_spb_online__ai_devops. Пользователь открывает её в Telegram, бот показывает распознанный фильтр и по кнопке выдаёт ссылки ics, webcal и для Google Calendar.

Payload диплинка ограничен 64 символами, это лимит Telegram. Слишком широкий фильтр инструмент не кодирует, а просит сузить, вместо того чтобы молча его обрезать.

## Ограничения

- не чаще одного запроса в секунду с одного адреса, с запасом на рукопожатие сессии. Перебор возвращает 429 и заголовок Retry-After;
- выдача поиска ограничена сверху, весь каталог одним вызовом не выгружается;
- данные обновляются раз в сутки.

## Публичное API

GET https://confcal.rpa.icu/api/events, параметры city, topic, format, free, date_from, date_to, limit, offset
GET https://confcal.rpa.icu/api/events/{id}, одно событие
GET https://confcal.rpa.icu/api/meta, справочники городов и тем
GET https://confcal.rpa.icu/api/stats/cities, счётчики по городам и темам
GET https://confcal.rpa.icu/api/calendars/{slug}, календарь по слагу и его события

## Справочники

Городов 19, тем 13, онлайн-событий в каталоге 24. Слаг online в списке городов означает события без привязки к городу.

### Города

- vladivostok: Владивосток, будущих событий 0
- voronezh: Воронеж, будущих событий 0
- ekaterinburg: Екатеринбург, будущих событий 1
- innopolis: Иннополис, будущих событий 0
- kazan: Казань, будущих событий 1
- kaliningrad: Калининград, будущих событий 0
- krasnodar: Краснодар, будущих событий 0
- krasnoyarsk: Красноярск, будущих событий 0
- moscow: Москва, будущих событий 57
- nizhny-novgorod: Нижний Новгород, будущих событий 1
- novosibirsk: Новосибирск, будущих событий 3
- perm: Пермь, будущих событий 0
- rostov: Ростов-на-Дону, будущих событий 0
- samara: Самара, будущих событий 1
- spb: Санкт-Петербург, будущих событий 14
- sochi: Сочи, будущих событий 2
- tomsk: Томск, будущих событий 0
- ufa: Уфа, будущих событий 0
- chelyabinsk: Челябинск, будущих событий 0

### Темы

- ai: Нейросети и ML, будущих событий 29
- backend: Бэкенд, будущих событий 13
- frontend: Фронтенд, будущих событий 4
- mobile: Мобильная разработка, будущих событий 3
- devops: DevOps и SRE, будущих событий 19
- data: Данные и аналитика, будущих событий 17
- security: Информационная безопасность, будущих событий 26
- qa: Тестирование, будущих событий 4
- management: Управление и тимлиды, будущих событий 20
- product: Продукт и дизайн, будущих событий 3
- gamedev: Геймдев, будущих событий 3
- hardware: Железо и embedded, будущих событий 8
- science: Наука и R&D, будущих событий 5

## Страницы сайта

- https://confcal.rpa.icu/ - каталог с фильтрами по городу, теме, формату и датам
- https://confcal.rpa.icu/city/{slug} - события города
- https://confcal.rpa.icu/topic/{slug} - события по теме
- https://confcal.rpa.icu/event/{id} - карточка события с разметкой schema.org Event
- https://confcal.rpa.icu/agents - инструкция по MCP для людей
- https://confcal.rpa.icu/sitemap.xml - карта сайта