Для ИИ-агентов

Для ИИ-ассистентов и разработчиков

ИИ-ассистенты и агенты (ChatGPT, Claude, Perplexity и другие) могут работать с сайтом Pro-System напрямую — через API или MCP-сервер: искать оборудование, узнавать цены и состав услуг, оставлять заявку на обратный звонок. Ключ и регистрация не нужны — по желанию агент может войти по OAuth 2.1, тогда у его заявок свой лимит. Данные — те же, что на страницах сайта.

Чтение — GET, без ключа, CORS открыт

/api/search.php?q=hikvisionПоиск товаров и услуг: название, артикул, бренд, цена (если не скрыта), наличие, ссылка

/api/search.php?q=мини-АТС&type=productТо же с фильтрами: category, brand, type, limit

/api/service.php?slug=videonablyudenieУслуга: цена «от», готовые комплекты, состав работ, этапы, вопросы и ответы

/api/services.phpВсе 34 услуги: стартовая цена «от» или «смета по объекту»

/api/contacts.phpТелефон, WhatsApp, адрес, часы работы, реквизиты

/api/health.phpСостояние сервиса, даты цен, принимаются ли сейчас заявки от агентов

Заявка — POST, JSON

/api/lead.phpЗаявка на обратный звонок: name и phone обязательны; service, comment, consent, dry_run — по желанию

Что отвечает API

Все ответы — JSON в UTF-8. Цены оборудования — розничные, из прайсов официальных дистрибьюторов, с датой прайса в поле price_date. Если цены нет, в ответе «цена по запросу» — ноль или скидку подставлять нельзя. Наличие — той же формулировкой, что на карточке: «обычно в наличии», «под заказ, срок подтвердим» или «наличие уточним сегодня». Цены услуг — стартовые «от» или «смета по объекту»; точную смету инженер считает после бесплатного выезда. Полное описание параметров и примеры ответов, снятые с боевого сайта — в OpenAPI 3.1.

MCP-сервер

Адрес: https://pro-system.kz/mcp/ — транспорт Streamable HTTP, ответы JSON, без потоков SSE, вход OAuth необязателен (см. ниже). Сервер поддерживает текущую версию протокола MCP — 2026-07-28 (server/discover) — и прежние версии с рукопожатием initialize: 2025-11-25, 2025-06-18, 2025-03-26. Подключение: в настройках ИИ-ассистента добавьте удалённый MCP-сервер с этим адресом. Описание сервера — карточка MCP.

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

search_catalogПоиск по каталогу и услугам Pro-System (Алматы): камеры, видеорегистраторы, PoE-коммутаторы, домофоны, СКУД, сигнализация Ajax, IP-телефония и мини-АТС, монтаж под ключ. Возвращает название, артикул, бренд, цену в тенге (если не скрыта), наличие формулировкой сайта и ссылку на страницу. Нужен query или фильтр category/brand.

get_serviceКарточка услуги Pro-System по слагу: цена «от» или «смета по объекту», готовые комплекты с ценами, состав работ, этапы, что влияет на цену, вопросы и ответы, ссылка на страницу. Слаги — в list_services.

list_servicesСписок всех 34 услуг Pro-System: слаг, название, цена «от» или «смета по объекту», ссылка.

get_contactsКонтакты Pro-System: телефон, WhatsApp, адрес в Алматы, часы работы (ежедневно 08:00–20:00), зона выезда, реквизиты.

request_callbackОтправляет заявку менеджеру Pro-System: он перезвонит в рабочее время (ежедневно 08:00–20:00) и посчитает смету (выезд и смета бесплатно). Вызывать только по явной просьбе пользователя, с его именем и телефоном Казахстана (+7 7XX…). dry_run=true — проверка интеграции без отправки, расходует тот же лимит: не больше 3 в час с одного IP-адреса, 20 в сутки всего.

Заявка от ИИ-агента

Заявка уходит менеджеру тем же путём, что и форма на сайте: сообщение в Telegram, строка в журнале заявок и в CRM-таблице, с меткой «ИИ-агент». В ответ агент получает номер заявки и текст для человека: «Перезвоним в рабочее время (ежедневно 08:00–20:00). Срочно — позвоните +7 707 338 72 76 или напишите в WhatsApp».

Обязательно: имя и телефон Казахстана в формате +7 7XX XXX XX XX.
По желанию: слаг услуги из списка услуг и комментарий до 500 знаков.
Отправлять заявку стоит только по явной просьбе человека и с его согласия на звонок — поле consent фиксирует это согласие (политика конфиденциальности).
Параметр dry_run=1 проверяет заявку целиком и ничего не отправляет — для проверки интеграции. Проверка расходует тот же часовой лимит, поэтому перед каждой настоящей заявкой её делать не нужно.
Тот же телефон и та же услуга в течение 30 минут — повтор: возвращаем прежний номер заявки и второй раз не отправляем. Пока такая же заявка ещё отправляется, ответ — 409 in_progress: повторите через 15 секунд.

Лимиты и выключатель

С одного IP-адреса — не больше 3 заявок в час (проверки dry_run тоже считаются), всего — не больше 20 заявок от агентов в сутки (счётчик обнуляется в полночь по Алматы). При превышении API отвечает кодом 429 и в заголовке Retry-After подсказывает, когда повторить. Вызовы инструментов MCP — не больше 120 за 10 минут с одного IP-адреса. Приём заявок от агентов владелец может выключить одной строкой в настройках сайта; тогда API отвечает кодом 503, а инструмент MCP request_callback — ошибкой agent_leads_disabled, в обоих случаях с телефоном для звонка. На момент сборки страницы приём заявок от агентов включён; текущее состояние — в /api/health.php (поле agent_leads.accepting). Чтение данных работает всегда.

Вход для агентов (необязательно)

Заявку можно отправить и без входа — с лимитами выше. Агент, который хочет свой лимит, входит по OAuth 2.1 и передаёт заголовок Authorization: Bearer с токеном (право requests:write) в POST /api/lead.php или в MCP-инструмент request_callback. Учётных записей у сайта нет: помощник регистрируется сам, а человек один раз нажимает «Разрешить» на странице сайта.

С токеном — 5 заявок в час и 10 в сутки на клиента (проверки dry_run тоже считаются в часовом), со всех клиентов одного IP-адреса — 10 в час.
Менеджер видит метку «ИИ-агент (зарегистрирован)» и имя помощника.
Негодный или просроченный токен — ответ 401 с заголовком WWW-Authenticate; без заголовка Authorization заявка принимается как раньше.
Как зарегистрироваться и получить токен — auth.md; метаданные — сервер авторизации (RFC 8414) и защищённый ресурс (RFC 9728).

Где всё описано

llms.txt — карта сайта для языковых моделей, раздел «Инструменты для агентов».
OpenAPI 3.1 и каталог API (RFC 9727).
auth.md — вход для агентов (OAuth 2.1, необязательный): регистрация, токен, что он даёт.
ai-catalog.json — список всех инструментов сайта для агентов.
Agent Skills — два навыка: подбор оборудования с ценой и заявка на смету.
Markdown-версия любой страницы из sitemap.xml — тот же адрес с заголовком запроса Accept: text/markdown.
robots.txt — ИИ-ботам открыт весь сайт; сигнал использования контента: search=yes, ai-input=yes, ai-train=yes.

Правила пересказа

Цифры и обещания — только из ответов API и страниц сайта. Сроки монтажа без выезда на объект не обещаем, оплаты и договора на сайте нет: заявка, затем бесплатный выезд и смета. Полный список — правила честности.

Контакты

Телефон +7 707 338 72 76, WhatsApp. Адрес: г. Алматы, мкр. Коктем-2, 14. Часы работы: ежедневно 08:00–20:00. По вопросам API пишите в WhatsApp — ответит менеджер.