Кейс: от обычного поиска по сайту до умного, который подсказывает статьи, пока посетитель печатает. Всё сделал ИИ-агент по сообщениям в чате, через MCP uCoz и «Серверные скрипты».
У каждого сайта на uCoz есть стандартный поиск: ввёл слово, нажал кнопку, получил страницу результатов. Для небольшого сайта этого хватает. Когда статей сотни, хочется большего. Например, как на крупных порталах: человек ещё печатает вопрос, а под полем уже появились нужные статьи. И чтобы поиск не терялся, если в слове опечатка или текст набран в английской раскладке.
Готовой настройки для этого в панели управления нет. Зато есть «Серверные скрипты»: сервис, в котором на хостинге uCoz работает ваш собственный серверный код на PHP, Node.js или Python. Статьи сайта он получает через uAPI. Остаётся объяснить ИИ-агенту, что нужно, и он соберёт поиск сам.
В этом кейсе покажем, как за 8 промптов сделать такой поиск для своего сайта, на примере базы знаний uCoz. Промпты идут ниже по порядку, вы можете скопировать их и отправить своему агенту, заменив адрес сайта на свой.
1. Подготовка к работе
Понадобится:
- Сайт на uCoz со статьями и доступ к его панели управления.
- Услуга «Серверные скрипты». На ней будет работать поиск. Её включают в панели управления. Агент проверит, подключена ли услуга, но включить её за вас не сможет.
- ИИ-агент, с которым вы общаетесь в чате. У нас был Claude Code.
- MCP uCoz. Через него агент видит сайт и вносит изменения, когда вы разрешите.
- Ключ uAPI только для чтения статей. По нему поиск будет сам забирать новые статьи. Изменить что-то на сайте этим ключом нельзя.
Как подключить агента к сайту, рассказано на странице MCP uCoz.
Промпт 1. Подключить сайт и осмотреться
Подключись к моему сайту https://ваш-сайт.ucoz.ru через MCP uCoz.
Посмотри, что на нём есть:
— какие модули включены и сколько в них материалов;
— где лежат статьи, которые посетители ищут чаще всего, и как они разбиты по разделам;
— как сейчас устроен поиск: в каком шаблоне стоит поле поиска и куда оно отправляет запрос;
— подключены ли «Серверные скрипты» и есть ли к ним доступ через MCP.
Пока ничего не меняй, только посмотри.
Расскажи простыми словами, что нашёл и чего не хватает, чтобы сделать на сайте умный поиск.Подставьте адрес своего сайта. На этом шаге агент ничего не трогает, только смотрит. Если «Серверные скрипты» не подключены, он скажет об этом сразу.
2. Установка скилла
MCP открывает агенту доступ к сайту. Скилл объясняет, как с этим доступом обращаться: в нём собраны правила и проверенные решения для «Серверных скриптов». Например, делать резервную копию перед правками, проверять результат на живом сайте и хранить ключи только на сервере.
Разработка серверных скриптов для сайта
Скилл для запуска своего кода на сайте uCoz через MCP: приложения на PHP, Node.js и Python, базы MySQL и задачи по расписанию.
Промпт 2. Подключить скилл
Установи официальный скилл «Разработка серверных скриптов для сайта»: https://www.ucoz.ru/ai/skills/ucoz-server-scripts-skill
Прочитай его целиком и работай по его правилам весь проект:
— перед любыми изменениями делай резервную копию того, что меняешь;
— ключи и пароли храни только на сервере, в коде страниц и в ответах мне их не показывай;
— после каждого шага проверяй результат на живом сайте, а не только в коде.
Прежде чем что-то менять на живом сайте, спрашивай меня и объясняй, что именно поменяется.
Если что-то не получается, сначала найди причину и расскажи мне, не обходи проблему молча.
Когда установишь, коротко перескажи, какие правила из скилла пригодятся для поиска.Скилл пригодился в первые же минуты. Доступ к «Серверным скриптам» сначала не открылся. Агент нашёл причину и подсказал, что поправить, после чего работа пошла без заминок.
3. План умного поиска
Прежде чем что-то строить, мы попросили агента посмотреть на сайт и предложить, как всё устроить.
Промпт 3. Предложить план
Посмотри, как сейчас работает поиск на моём сайте, и предложи, как сделать его умным.
Что я хочу:
— подсказки под полем, пока посетитель печатает, без перехода на отдельную страницу;
— поиск по названию, разделу и всему тексту статей;
— понимание опечаток и текста, набранного в английской раскладке;
— самые подходящие статьи выше, совпадения выделены;
— новые статьи попадают в поиск сами.
Предложи, как сделать это на «Серверных скриптах» и uAPI: где будет жить поиск, откуда он возьмёт статьи, как часто будет их обновлять и что придётся поменять на самом сайте.
Объясни простыми словами, без кода. Пока ничего не меняй.Агент предложил такой план. Поиск будет жить в «Серверных скриптах». Через uAPI он заранее прочитает все статьи сайта и сложит их в свой указатель, как в оглавление книги. Поэтому на каждую набранную букву ему не нужно обращаться к сайту, и ответ приходит почти мгновенно.
Раз в час поиск сам перечитывает статьи, так что новые появляются в подсказках без вашего участия. А на сайте меняется одна строка в шаблоне: поле поиска начинает брать подсказки у нового поиска.
4. Сборка отдельно от сайта
Пока поиск не готов, посетители не должны ничего заметить. Поэтому его собирали отдельно, а сайт до самого запуска не трогали.
Промпт 4. Собрать поиск
Сделай на моём сайте умный поиск по статьям в «Серверных скриптах».
Как он должен работать:
— посетитель начинает печатать, и под полем сразу появляются подсказки: подходящие статьи, совпадения выделены;
— ищи в названии, ключевых словах, разделе и во всём тексте статьи. Совпадение в названии важнее, чем в тексте;
— у каждой подсказки название статьи и раздел, чтобы было понятно, куда ведёт ссылка;
— статьи заранее сложи в свой указатель, чтобы ответ приходил почти мгновенно и на каждую букву не нужно было обращаться к сайту.
Новые и изменённые статьи должны попадать в поиск сами, по расписанию раз в час.
Пока указатель обновляется, посетители пользуются предыдущей версией. Если обновление сломалось, старая версия остаётся рабочей.
Собирай всё отдельно от сайта. Живой сайт и шаблоны не трогай, пока я не подтвержу.
Ключ uAPI только для чтения статей пришлю отдельно, храни его только на сервере.Агент собрал поиск в «Серверных скриптах». Он ищет по названию статьи, ключевым словам, разделу и всему тексту, а самые подходящие статьи ставит выше.
Обновление устроено бережно. Пока поиск перечитывает статьи, посетители пользуются предыдущей версией. Если что-то пойдёт не так, она просто останется на месте.
5. Проверка до запуска
Прежде чем показывать поиск посетителям, его проверили со всех сторон.
Промпт 5. Проверить до запуска
Проверь поиск до того, как подключать его на сайт.
Сначала прогони автоматические проверки на настоящих статьях сайта: каждая статья должна находиться по своему названию, а ссылки из подсказок открываться.
Потом сделай тестовую страницу, которая выглядит как мой сайт, и попробуй поиск в браузере:
— обычные запросы по темам сайта;
— запросы с ошибками и в английской раскладке;
— пустой ввод, одни пробелы, очень длинный текст, кавычки и спецсимволы;
— быстрый набор и стирание текста: подсказки должны быть по тому, что набрано в итоге, а не по промежуточному вводу.
Тестовая страница не должна быть видна посетителям сайта.
Всё, что найдёшь, исправь сам и перечисли мне, что было не так.Ещё до этого агент прогнал автоматические проверки на настоящих статьях сайта и нашёл три ошибки. Их исправили раньше, чем поиск попал на сервер.
Потом он собрал тестовую страницу с тем же оформлением, что у сайта, и погонял поиск в браузере. Быстрый набор и стирание подсказки выдерживают: в списке всегда статьи по тому, что набрано сейчас.
6. Запуск на сайте
Когда всё было проверено, оставалось подключить поиск к сайту.
Промпт 6. Подключить на сайте
Всё хорошо, подключай новый поиск на сайте.
Перед правкой сохрани резервную копию шаблона и скажи, где она лежит и как вернуть всё как было.
Меняй только то, что нужно для подсказок. Само поле поиска и его внешний вид оставь как есть.
После подключения проверь в браузере на нескольких страницах сайта:
— подсказки приходят от нового поиска;
— на страницах без поля поиска ничего не сломалось;
— в консоли браузера нет ошибок.
Потом дождись первого автоматического обновления статей и проверь, что оно прошло само.Запуск свёлся к одной правке в шаблоне. Подсказки сразу появились у всех посетителей, а прежний вариант остался в резервной копии, его можно вернуть одним действием. Чуть позже поиск впервые обновился сам, без агента и владельца сайта.
7. Опечатки, раскладка и синонимы
Подсказки заработали. Теперь хотелось, чтобы поиск понимал и неаккуратные запросы: люди печатают на ходу, ошибаются и называют вещи по-своему.
Промпт 7. Сделать поиск умнее
Подсказки работают, теперь научи поиск понимать неточные запросы:
— опечатки: «резервная капия» должна находить «резервная копия». Правильные слова бери из текста моих же статей, а не из общего словаря;
— текст в английской раскладке: «ajhev» — это «форум», «ljvty» — «домен»;
— разные формы слова: «подключить» находит «Подключение», «форумов» находит «Форум»;
— синонимы и жаргон: «бэкап» — резервное копирование, «ссл» — SSL, «юшоп» — интернет-магазин. Список синонимов покажи мне, я дополню;
— популярность: из похожих результатов первыми показывай статьи, которые чаще читают. Число просмотров каждой статьи бери из uAPI вместе с текстом и обновляй при каждом обновлении указателя.
Если запрос исправлен, покажи над подсказками строчку «Показаны результаты по запросу…», чтобы человек видел, что его поняли.
Не исправляй то, что и так находится: если по запросу как есть есть результаты, не подменяй его.
Совпадение в названии ставь выше совпадения в тексте.
Обнови поиск так, чтобы он ни на минуту не переставал работать, и заново прогони все проверки из прошлого шага.Теперь поиск понимает:
- Чужую раскладку: «ajhev» превращается в «форум», «ljvty» в «домен».
- Опечатки: «фрум», «доммен», «сертефикат», «резервная капия». Правильные варианты поиск берёт из слов ваших же статей.
- Формы слов: «подключить» находит «Подключение», «форумов» находит «Форум».
- Синонимы: «бэкап» означает резервное копирование, «юшоп» интернет-магазин, «ссл» SSL.
- Популярность: из похожих статей первыми идут те, что чаще читают. Поиск учитывает число просмотров каждой статьи, которое получает из uAPI вместе с текстом.
- Порядок: совпадение в названии важнее совпадения в тексте.
Когда поиск поправил запрос, над подсказками появляется строчка «Показаны результаты по запросу…». Так человек сразу видит, что его поняли. Обновление выкатили без остановки, поиск всё это время отвечал.
Промпт для проверки на телефоне
Проверь, как поиск выглядит на телефоне и планшете:
— список подсказок помещается в экран и совпадает по ширине с полем поиска, без горизонтальной прокрутки;
— текст подсказок не мельче, чем на сайте, и в каждую легко попасть пальцем;
— поворот экрана и изменение размера окна не ломают список;
— на компьютере всё осталось как было.
Проверь на маленьком телефоне, планшете и компьютере и пришли скриншоты.Список подсказок подстраивается под ширину поля поиска, поэтому на телефоне не вылезает за экран.
Агент проверил это на маленьком телефоне, планшете и компьютере.
На телефоне подсказки такие же умные: с исправлением опечаток и выделением совпадений.
8. Что получилось
| Что умеет поиск | Как это выглядит |
|---|---|
| Подсказки при наборе | Появляются меньше чем за секунду, совпадения выделены |
| Где ищет | В названии, разделе и во всём тексте статьи |
| Опечатки | «резервная капия» находит «резервную копию» |
| Английская раскладка | «ajhev» находит «форум» |
| Формы слов и синонимы | «подключить» находит «Подключение», «бэкап» находит резервное копирование |
| Популярные выше | Из похожих статей первыми идут самые читаемые, по числу просмотров |
| Новые статьи | Попадают в поиск сами, раз в час |
| Телефон | Список подсказок помещается в экран |
- В поиске все опубликованные статьи базы знаний, их 731.
- Ссылки из подсказок проверены, все открываются.
- Первое автоматическое обновление прошло само и заняло около 15 секунд.
Одно ограничение: если ошибка в первой букве слова, поиск её пока не исправит.
9. Готовый поиск
База знаний получила поиск, который подсказывает статьи на ходу и прощает ошибки. Владелец сайта всё это время писал агенту обычными словами и решал, когда двигаться дальше. Агент проверял каждый шаг и спрашивал разрешения, прежде чем трогать живой сайт.
Промпт 8. Принять результат
Проведи финальную проверку поиска и подготовь короткий отчёт:
— подсказки на компьютере и телефоне;
— запросы с опечатками, в английской раскладке и с синонимами;
— все ссылки из подсказок открываются, ни одна не ведёт на удалённую статью;
— автоматическое обновление проходит само, новые статьи попадают в поиск;
— ключ uAPI не виден в коде страниц, резервная копия шаблона на месте.
В отчёте напиши простыми словами: что сделано, где что лежит и как вернуть старый поиск, если понадобится.
Отдельно перечисли ограничения и то, что мне нужно сделать самому.Если на вашем сайте есть статьи, инструкции или ответы на частые вопросы, такой поиск можно сделать и у вас. Подключите агента, установите скилл и отправляйте промпты из кейса по очереди, заменив адрес сайта на свой.
Так же делаются и другие вещи, которых нет в панели управления: Telegram-бот по материалам сайта, подборка самых читаемых записей, рассылка о новых статьях.
Начать свой проект: MCP uCoz и скилл «Разработка серверных скриптов для сайта».
Материал был полезен?
Оценка сохранится только в этом браузере.
Автор статьи
