Как установить хороший поиск на сайт интернет-магазина: самому, через SaaS или с помощью AI-агента

Коротко

• Простой поиск по названию товара пишется за вечер: LIKE, полнотекстовый индекс в базе или Meilisearch. Но он не исправляет опечатки и раскладку, не понимает синонимов и запросов своими словами и ничего не знает о том, что покупают.
• Поиск, который реально продаёт, собирают из многих частей: морфология, векторный (семантический) поиск, гибридное ранжирование, реранкер, обучение на кликах и покупках, подсказки, фильтры, мерчандайзинг и аналитика. Свой такой поиск — это месяцы работы команды, а потом его ещё надо постоянно поддерживать.
• Для интернет-магазина обычно выгоднее взять готовый сервис поиска для e-commerce. В SearchBooster хватает трёх шагов: передать товарный фид, вставить скрипт виджета и подключить трекер событий.
• Если сайт сделан через вайбкодинг (Cursor, Claude Code, Codex, Windsurf, Lovable и т. п.), подключение можно поручить AI-агенту. Готовый промпт — в разделе ниже.

Почему поиск на сайте магазина так важен

Человек, который открыл строку поиска, обычно уже знает, что ему нужно: модель, артикул, бренд или хотя бы задачу вроде «чем отмыть плитку от известкового налёта». Это самый «тёплый» трафик на сайте. Если поиск ничего не находит, покупатель уходит к конкурентам или на маркетплейс.

Типичные ситуации, на которых простой поиск теряет заказы:

• опечатки — «кросовки», «айфон 15 про макс» вместо iPhone 15 Pro Max;
• неправильная раскладка — rhjccjdrb вместо «кроссовки»;
• морфология — «красное платье» и «красных платьев» должны находить одно и то же;
• синонимы и сленг — «худи» и «толстовка», «пылик» и «пылесос»;
• артикулы и модели — SM-S928, «кофемашина 3200» и т. п.;
• запросы своими словами — «подарок папе-рыбаку до 5000», «куртка, чтобы не промокла на велосипеде»;
• нулевая выдача — вместо «ничего не найдено» надо показать похожие или популярные товары.

Простой поиск: что можно сделать самому за вечер

Базовый поиск действительно несложный. Есть несколько типичных вариантов.

1. Запрос к базе данных. Самый быстрый вариант:

SELECT id, name, price
FROM products
WHERE name ILIKE '%' || :query || '%'
LIMIT 24;

2. Полнотекстовый индекс в базе. В PostgreSQL это tsvector с русским словарём, в MySQL — FULLTEXT. Так появляются морфология и ранжирование по совпадению слов.

3. Поисковый движок. Meilisearch, Typesense, OpenSearch или Elasticsearch: исправление опечаток, фасеты и быстрые подсказки здесь есть из коробки.

Для блога, документации или каталога на пару сотен позиций этого хватит. Для интернет-магазина с тысячами товаров, вариантами, регионами и акциями — нет. Движок ищет по словам, но не знает, какие товары покупают, какие закончились на складе и что на самом деле имел в виду человек, написавший «что-то тёплое на дачу».

Из чего состоит полноценный поиск для e-commerce

Современный товарный поиск — это несколько слоёв, и каждый закрывает свою часть задачи.

Векторный поиск и реранкер простыми словами

Векторный поиск превращает текст запроса и описания товаров в числовые векторы (эмбеддинги) и ищет ближайшие по смыслу. Поэтому запрос «кофта на молнии с капюшоном» находит «худи на zip», хотя общих слов в них почти нет.

Но если ограничиться одними векторами, поиск начнёт путать артикулы и модели: iPhone 15 и iPhone 13 для эмбеддинга почти одно и то же. Поэтому в e-commerce используют гибридный поиск: лексические и векторные кандидаты объединяются, а потом реранкер (обычно cross-encoder) пересортировывает несколько десятков лучших результатов с учётом запроса целиком.

Поверх этого работает обучение на поведении: клики, добавления в корзину и покупки показывают, какие товары на самом деле отвечают на запрос. Без этих данных даже хорошая модель ранжирует «правильно по тексту», а не «правильно для продаж».

Как эти слои устроены внутри SearchBooster, со схемами, — в статье «Как работает поиск SearchBooster: от опечатки до покупки».

Почему самостоятельная разработка обходится дороже, чем кажется

Запустить прототип с эмбеддингами можно за неделю. Дорого обходится всё, что начинается потом:

• Команда. Нужны инженер по поиску или ML, бэкенд-разработчик, фронтенд для подсказок и выдачи, аналитик для оценки качества. Сроки до стабильной версии обычно измеряются месяцами.
• Инфраструктура. Векторная база, инференс эмбеддингов и реранкера (часто на GPU), очереди переиндексации, кэш. Всё это должно отвечать за десятки миллисекунд, иначе подсказки начнут «тормозить».
• Качество. Нужно размечать релевантность, вести набор контрольных запросов, проводить A/B-тесты и следить, чтобы новая модель не сломала выдачу по старым запросам.
• Поддержка. Каталог меняется каждый день: новые товары, остатки, цены, сезонность. Синонимы и правила нужно пополнять, модели — переобучать, а интерфейс для менеджеров — развивать.
• Риски. Когда поиск падает или выдаёт мусор, магазин теряет деньги прямо сейчас, а не когда-нибудь потом.

Свой поиск стоит строить, если поиск — это ваш основной продукт или у вас очень специфические данные. Для остальных интернет-магазинов разумнее отдать поиск специализированному сервису и тратить время разработчиков на то, что отличает магазин от конкурентов.

Как работает готовый поиск на примере SearchBooster

SearchBooster — сервис поиска, подсказок, рекомендаций и аналитики для интернет-магазинов. Схема простая: вы передаёте каталог, сервис строит поисковый индекс и отдаёт выдачу через готовый виджет или API, а события покупателей возвращаются и улучшают ранжирование и персонализацию.

Интеграция состоит из трёх частей:

1. Каталог. Товары передаются фидом в формате YML (Yandex Market Language) или Google Merchant. Цены и остатки между выгрузками можно обновлять через API индексации.
2. Выдача. Поисковый виджет подключается одним скриптом. Если нужна своя вёрстка и SEO-страницы результатов — используется API поиска, подсказок и фильтров.
3. События. Трекер собирает просмотры, корзины и покупки из dataLayer (тот же формат, что у GA4). Это включает персонализацию и статистику выручки от поиска.

Что уже работает «из коробки»: исправление опечаток и раскладки, морфология, синонимы, поиск по артикулам, подсказки с товарами и категориями, фасетные фильтры, поиск по фото, AI-понимание запроса («белая собака до 5000» превращается в фильтры по цвету и цене), рекомендации при нулевой выдаче, мерчандайзинг и аналитика.

Как установить поиск на сайт: пошаговая инструкция

Шаг 1. Создайте проект и добавьте фид

Зарегистрируйтесь в личном кабинете и добавьте проект: адрес сайта и ссылку на товарный фид. Небольшой каталог индексируется за несколько минут.

Фид почти любая CMS умеет выгружать штатно или через модуль для Яндекс Маркета. Минимальный оффер выглядит так:

<offer id="110166" available="true">
  <url>https://shop.ru/p/110166</url>
  <name>Самоедская собака, щенок</name>
  <price>960</price>
  <currencyId>RUR</currencyId>
  <categoryId>8145</categoryId>
  <picture>https://shop.ru/img/110166.jpg</picture>
</offer>

Чем полнее фид, тем лучше поиск: vendor даёт фасет и подсказки по брендам, param превращается в фильтры, oldprice показывает скидку, group_id объединяет размеры и цвета одной модели. Перед подключением прогоните фид через валидатор — он работает в браузере и показывает ошибки по каждому товару.

Шаг 2. Скопируйте UUID проекта

UUID лежит в настройках проекта и в коде виджета. Это публичный ключ для API поиска: секретный ключ для выдачи не нужен, запросы можно отправлять прямо из браузера.

Шаг 3. Вставьте код поискового виджета

В личном кабинете откройте раздел «Виджет», укажите CSS-селектор поля поиска (например, #search-input), выберите режим (всплывающее окно, встроенная выдача или только подсказки) и вставьте код в <head> всех страниц:

<link rel="preconnect" href="https://api.searchbooster.net" crossorigin />
<link rel="preconnect" href="https://cdn2.searchbooster.net" crossorigin />
<script data-skip-moving="true">
  var sbRegionId = '';   // регион посетителя, как в фиде
  var sbUserId = '';     // ваш ID пользователя (необязательно)
  var sbSegmentId = '';  // сегмент (необязательно)
  var sbScript = document.createElement('script');
  sbScript.src = 'https://cdn2.searchbooster.net/scripts/widget/PROJECT_UUID/main.js';
  sbScript.setAttribute('data-sb-init-script', 1);
  sbScript.async = true;
  document.head.appendChild(sbScript);
</script>

Атрибут data-skip-moving="true" нужен для 1С-Битрикс, иначе Битрикс перенесёт скрипт в конец страницы. Цвета, шрифты, количество товаров и язык интерфейса настраиваются в личном кабинете. Изменения появляются на сайте примерно через минуту, код при этом менять не нужно.

Шаг 4. Подключите трекер событий

<script defer src="https://cdn2.searchbooster.net/scripts/tracker/PROJECT_UUID/searchbooster.js"></script>

Трекер читает ecommerce-события из dataLayer: view_item, add_to_cart, add_to_wishlist, begin_checkout, purchase. Если на сайте уже настроена ecommerce-разметка для GA4 или Google Tag Manager, дополнительно ничего делать не нужно. Главное, чтобы item_id в событиях совпадал с offer id в фиде.

Шаг 5. Проверьте и запустите

• В браузере ставится cookie searchbooster_v2_user_id.
• Запросы к api.searchbooster.net во вкладке Network возвращают 200.
• При вводе в поле поиска появляются подсказки.
• Режим интеграции позволяет проверить поиск на живом сайте до запуска: виджет увидят только те, кто открыл сайт с параметром ?sbdemo=true.
• Параметр ?no_search=1 временно отключает виджет — так удобно проверить, не он ли мешает.

Шаг 6. Настройте под свой ассортимент

После запуска загляните в аналитику: запросы без результатов подскажут, какие синонимы добавить. В разделе «Мерчандайзинг» можно закрепить нужные товары по запросу, поднять акционные позиции или настроить редирект: например, по запросу «доставка» отправлять на страницу с условиями доставки.

Вайбкодите? Отдайте установку поиска AI-агенту

Если сайт собран в Cursor, Claude Code, Codex, Windsurf, Lovable, Bolt или другом AI-инструменте, подключение поиска не потребует ручной работы с кодом. Агенту нужны три вещи: UUID проекта, понятная задача и ссылка на документацию. Документация SearchBooster (docs.searchbooster.io) написана так, что агент может прочитать её сам и проверить запросы к API.

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

1. Создайте проект в личном кабинете и скопируйте UUID.
2. Если фид уже есть, добавьте его в проект. Если нет — агент сделает его по промпту, и вы добавите ссылку позже.
3. Скопируйте промпт ниже, подставьте UUID и селектор поля поиска и выберите режим.

Промпт для AI-агента: «Подключи поиск SearchBooster»

Подключи к моему сайту умный поиск SearchBooster.
Документация: https://docs.searchbooster.io — сверяйся с ней, а не с памятью.
Ключевые страницы:
- https://docs.searchbooster.io/start/quickstart/
- https://docs.searchbooster.io/catalog/feed/
- https://docs.searchbooster.io/widgets/search-widget/
- https://docs.searchbooster.io/widgets/tracker/
- https://docs.searchbooster.io/recipes/custom-serp/
 
Данные проекта:
- UUID проекта: <ВСТАВЬТЕ_UUID>
- CSS-селектор поля поиска: <например, #search-input> (если поля нет — добавь его в шапку сайта в текущем стиле)
- Режим: <ВИДЖЕТ | СВОЯ ВЫДАЧА>
  ВИДЖЕТ — подсказки и выдача от SearchBooster, быстрый запуск.
  СВОЯ ВЫДАЧА — подсказки от виджета, а страница /search рендерится на сервере в дизайне сайта (нужно для SEO).
 
Сделай по шагам и после каждого шага коротко отчитайся:
 
1. Разведка. Определи стек (Next.js, Nuxt, Remix, Astro, 1С-Битрикс, WordPress/WooCommerce, Tilda, свой бэкенд), где общий layout и <head>, где поле поиска, как устроены карточка товара, корзина и оформление заказа. Ничего не меняй, пока не покажешь мне план.
 
2. Товарный фид. Проверь, есть ли фид в формате YML или Google Merchant. Если нет — сделай эндпоинт /feed.xml по https://docs.searchbooster.io/catalog/feed/.
   Обязательно: offer@id, available, url, name, price, currencyId, categoryId, picture и дерево <categories>.
   Желательно: vendor, oldprice, param (характеристики для фильтров), description, group_id для вариантов одной модели.
   ID — стабильные строки, URL и картинки — абсолютные. Кэшируй фид, не строй его на каждый запрос.
   Дай мне ссылку на фид — я добавлю её в личном кабинете.
 
3. Поисковый виджет. Вставь в <head> всех страниц код из https://docs.searchbooster.io/widgets/search-widget/ (preconnect + скрипт main.js) с моим UUID.
   - В SPA/SSR-фреймворке подключи его один раз в корневом layout штатным способом (например, next/script), чтобы скрипт не дублировался при навигации.
   - Для 1С-Битрикс сохрани data-skip-moving="true".
   - Если на сайте есть регионы с разными ценами — передавай sbRegionId (ID региона как в фиде).
   - Если есть авторизация — передавай sbUserId с непрозрачным ID пользователя. Никогда не передавай email или телефон.
 
4. Трекер событий. Подключи https://cdn2.searchbooster.net/scripts/tracker/<UUID>/searchbooster.js в <head> всех страниц.
   Проверь, что в window.dataLayer уходят события в формате GA4: view_item (карточка товара), add_to_cart, add_to_wishlist, begin_checkout, purchase. Если их нет — добавь разметку.
   item_id в событиях должен совпадать с offer@id в фиде.
 
5. Только для режима СВОЯ ВЫДАЧА. Сделай серверную страницу /search?q=... по рецепту https://docs.searchbooster.io/recipes/custom-serp/:
   - виджет переключи в режим «только подсказки», по Enter веди на /search?q=...;
   - на сервере вызывай GET https://api.searchbooster.net/api/<UUID>/search с query, limit, skip, userId, queryId, client;
   - если в ответе есть redirect — отвечай 302 на этот адрес;
   - показывай forceCorrectedQuery («Показаны результаты по запросу…»), товары из offers, фильтры из params, пагинацию по hits;
   - userId бери из cookie searchbooster_v2_user_id, чтобы он совпадал с виджетом и трекером;
   - фильтры и страницу храни в URL; добавь <title>, meta description и canonical для страницы результатов;
   - поставь таймаут на запрос к API и аккуратную заглушку, если API недоступен.
 
6. Если у тебя подключён MCP-сервер searchbooster (https://docs.searchbooster.io/integrations/mcp/), прогони через search_products 10 типичных запросов по моему каталогу, включая запрос с опечаткой и запрос в неправильной раскладке, и покажи мне результаты.
 
7. Проверка. Собери и запусти проект. Убедись, что:
   - ставится cookie searchbooster_v2_user_id;
   - запросы к api.searchbooster.net возвращают 200;
   - при вводе в поле поиска появляются подсказки;
   - нет ошибок в консоли и сборка проходит без предупреждений, которые появились из-за твоих правок.
 
Ограничения:
- Не меняй дизайн и логику сайта сверх того, что нужно для поиска.
- Старый поиск не удаляй — отключи его за флагом, чтобы можно было откатиться.
- Для поиска секретный ключ не нужен, хватает UUID. Если понадобится API-ключ (API индексации или статистики), используй его только на сервере и храни в переменных окружения.
 
В конце дай: список изменённых файлов, что мне проверить руками и что нужно сделать в личном кабинете SearchBooster (добавить фид, указать селектор, включить режим интеграции для проверки через ?sbdemo=true).

Как дать агенту доступ к каталогу через MCP

У SearchBooster есть MCP-сервер каталога. Через него AI-агент может сам искать товары, получать подсказки и похожие товары. Это удобно для проверки выдачи во время интеграции, а потом — для AI-консультанта на сайте или в мессенджере.

Claude Code:

claude mcp add --transport http searchbooster https://api.searchbooster.net/mcp \
  --header "X-MCP-Project-UUID: PROJECT_UUID"

Cursor и другие клиенты с JSON-конфигом:

{
  "mcpServers": {
    "searchbooster": {
      "url": "https://api.searchbooster.net/mcp",
      "headers": { "X-MCP-Project-UUID": "PROJECT_UUID" }
    }
  }
}

Есть и второй MCP-сервер — для управления проектом: синонимы, правила мерчандайзинга, статистика («какие запросы чаще всего не находят товары на этой неделе?»). Он работает по API-ключу с правами вашего пользователя, поэтому для него лучше завести отдельного пользователя и не публиковать конфиг с ключом. Подробнее — в документации по MCP.

Что проверить после работы агента

AI-агенты хорошо справляются с такой интеграцией, но результат всё равно стоит проверить вручную по чек-листу:

• Фид проходит валидатор без ошибок.
• Во всех запросах передаётся один и тот же userId.
• Для магазинов с регионами передаётся regionId.
• Обрабатывается redirect из ответа поиска.
• Клики и покупки уходят в события, item_id совпадает с ID в фиде.
• Скрипт виджета подключён один раз, а не на каждом переходе между страницами.

Виджет или API: что выбрать

Часто эти варианты комбинируют: подсказки показывает виджет, а страница результатов собирается на API в дизайне сайта. Если вы только начинаете, ставьте виджет: так поиск заработает уже сегодня, а свою выдачу можно сделать потом, не меняя каталог и события.

Частые ошибки при установке поиска

• Разные userId в разных запросах. Из-за этого не работают персонализация и статистика. Берите значение из cookie searchbooster_v2_user_id или передавайте свой ID везде одинаково.
• item_id в событиях не совпадает с ID в фиде. Например, в dataLayer уходит артикул, а в фиде — внутренний ID. Тогда события не свяжутся с товарами.
• Не обрабатывается redirect. Если для запроса настроен редирект на категорию, а вы рендерите обычную выдачу, правило не сработает.
• Скрипт перенесён в конец страницы. В 1С-Битрикс без data-skip-moving="true" виджет может инициализироваться с задержкой.
• Нет регионов там, где они нужны. Покупатель видит чужие цены и наличие.
• Фид без характеристик. Без param не будет фильтров, а без vendor — подсказок по брендам.
• Персональные данные в ID. В userId нельзя передавать email или телефон, только непрозрачный идентификатор.

Частые вопросы

Как установить поиск на сайт интернет-магазина быстрее всего?

Подключите готовый поисковый виджет. В SearchBooster для этого нужны товарный фид (YML или Google Merchant), код виджета в <head> и скрипт трекера. По документации такой запуск занимает около одного дня, программировать выдачу не нужно.

Чем умный поиск отличается от обычного поиска по сайту?

Обычный поиск ищет совпадение слов в названии. Умный поиск исправляет опечатки и раскладку, учитывает морфологию и синонимы, понимает запросы своими словами за счёт векторного поиска, ранжирует товары с учётом кликов и покупок, показывает подсказки, фильтры и рекомендации при нулевой выдаче.

Что такое векторный поиск и зачем он магазину?

Векторный (семантический) поиск сравнивает смысл запроса и описания товара, а не отдельные слова. Он находит товары по запросам вроде «куртка, чтобы не промокнуть на велосипеде», даже если таких слов нет в карточке. В e-commerce его объединяют с обычным лексическим поиском, чтобы не терять точность по артикулам и моделям.

Что такое реранкер в поиске?

Реранкер — это модель, которая заново сортирует лучшие результаты поиска, сравнивая каждый товар с запросом целиком. Он работает точнее, чем первичный поиск, но медленнее, поэтому его применяют только к верхушке выдачи.

Можно ли сделать хороший поиск самому?

Можно, но это проект на месяцы: векторная база, модели эмбеддингов и реранкера, сбор событий, обучение ранжирования, интерфейс для синонимов и мерчандайзинга, аналитика. Всё это надо поддерживать и после запуска. Свой поиск оправдан, если поиск — ваш ключевой продукт. Магазину обычно выгоднее взять готовый сервис.

Как подключить поиск, если сайт сделан через вайбкодинг?

Передайте вашему AI-агенту (Cursor, Claude Code, Codex, Windsurf и др.) промпт из этой статьи с UUID проекта SearchBooster. Агент проверит или создаст фид, подключит виджет и трекер, при необходимости сделает серверную страницу результатов и проверит выдачу через MCP-сервер.

Нужен ли секретный API-ключ для поиска SearchBooster?

Нет. API поиска, подсказок, рекомендаций и событий публичное: проект определяется по UUID, а запросы можно отправлять прямо из браузера или мобильного приложения. API-ключ нужен только для методов индексации и статистики, и хранить его надо на сервере.

Будет ли поиск работать на Тильде, Битриксе, WordPress или Next.js?

Да. Виджет подключается обычным скриптом в <head>, поэтому подходит для любой платформы, на которой можно добавить свой код. Для 1С-Битрикс в скрипте нужен атрибут data-skip-moving="true", для SPA-фреймворков скрипт лучше подключить один раз в корневом layout.

Как часто обновляются товары, цены и остатки?

Фид скачивается и переиндексируется по расписанию. Если цены и остатки меняются чаще, их можно передавать между выгрузками через API индексации, чтобы в выдаче не было товаров, которых уже нет в наличии.

Поможет ли свой поиск SEO сайта?

Сам виджет на индексацию не влияет. Если вам нужны индексируемые страницы результатов, сделайте серверную страницу /search на API поиска: с нормальными URL фильтров, заголовками и canonical. Для этого в документации есть отдельный рецепт.

Сколько стоит подключение SearchBooster?

Цена зависит от размера каталога и трафика. Посчитать её можно на странице тарифов. Поиск можно попробовать 14 дней бесплатно.

Итог

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

Если вы вайбкодите, скопируйте промпт для AI-агента, подставьте UUID и отдайте его агенту. Если удобнее с поддержкой — оставьте заявку, и мы поможем с интеграцией. Технические подробности — на странице для разработчиков и в документации.