MCP поиска по каталогу
MCP поиска предназначен для консультанта на сайте, бота в мессенджере, голосового помощника или другого внешнего агента, который помогает покупателю выбирать товары.
| Параметр | Значение |
|---|---|
| Endpoint | https://api.searchbooster.net/mcp |
| Авторизация | UUID проекта в заголовке X-MCP-Project-UUID |
| Данные | Товары, цены, наличие, категории, подсказки и рекомендации |
Сервер использует JSON-RPC 2.0 и транспорт Streamable HTTP.
UUID выбирает каталог и не является секретом. MCP поиска не открывает настройки личного кабинета. Поиск учитывает настроенные регионы, синонимы и правила мерчандайзинга.
Где взять UUID
Заголовок раздела «Где взять UUID»Откройте проект в личном кабинете и перейдите в раздел «Поиск для ИИ-агентов (MCP)». Страница покажет адрес сервера, UUID проекта и готовую конфигурацию.
Подключение
Заголовок раздела «Подключение»claude mcp add --transport http searchbooster-catalog https://api.searchbooster.net/mcp \ --header "X-MCP-Project-UUID: PROJECT_UUID"{ "mcpServers": { "searchbooster-catalog": { "url": "https://api.searchbooster.net/mcp", "headers": { "X-MCP-Project-UUID": "PROJECT_UUID" } } }}curl -X POST https://api.searchbooster.net/mcp \ -H 'Content-Type: application/json' \ -H 'X-MCP-Project-UUID: PROJECT_UUID' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Замените 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-клиент и текст ошибки.