Перейти к содержимому

MCP поиска по каталогу

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

Параметр Значение
Endpoint https://api.searchbooster.net/mcp
Авторизация UUID проекта в заголовке X-MCP-Project-UUID
Данные Товары, цены, наличие, категории, подсказки и рекомендации

Сервер использует JSON-RPC 2.0 и транспорт Streamable HTTP.

UUID выбирает каталог и не является секретом. MCP поиска не открывает настройки личного кабинета. Поиск учитывает настроенные регионы, синонимы и правила мерчандайзинга.

Откройте проект в личном кабинете и перейдите в раздел «Поиск для ИИ-агентов (MCP)». Страница покажет адрес сервера, UUID проекта и готовую конфигурацию.

Окно терминала
claude mcp add --transport http searchbooster-catalog https://api.searchbooster.net/mcp \
--header "X-MCP-Project-UUID: PROJECT_UUID"

Замените PROJECT_UUID на UUID из личного кабинета. Если в тарифе проекта нет API-доступа, оставьте заявку на странице MCP в кабинете.

Инструмент Что делает Основные аргументы
search_products Поиск товаров с фильтрами и сортировкой query, limit, skip, categoryId[], regionId, sortBy, sortDest, params[], userId
get_completions Подсказки по началу запроса query, limit, regionId
find_by_id Товар по ID id
search_grouped Варианты одной модели id, regionId, params
search_by_category Выдача по нескольким категориям structureByCategoryId[], query, limit
get_popular_products Популярные товары limit, categoryId[], regionId
get_similar_products Похожие товары id, limit, regionId
get_widget Рекомендации виджета id, userId, limit, regionId, categoryId[]
get_categories_settings Дерево категорий parentId, level, maxLevel
search_site_content Поиск по доставке, оплате, контактам, статьям и FAQ, если подключён поиск по сайту query, limit

Чтобы агент видел только выбранные инструменты, добавьте их в адрес подключения:

https://api.searchbooster.net/mcp?tools=search_products,search_site_content

Остальные инструменты не попадут в tools/list, а попытка вызвать их завершится ошибкой. Запросы MCP помечаются как client=mcp, поэтому их можно отличить от запросов поискового виджета.

Попросите агента:

Покажи доступные инструменты SearchBooster и найди три товара по тестовому запросу.

Если подключение не работает, проверьте endpoint, заголовок X-MCP-Project-UUID, UUID проекта и статус API-доступа в тарифе. В обращении в поддержку укажите время запроса, MCP-клиент и текст ошибки.

Вернуться к обзору MCP →