AIKraft/Skills/headless интеллектуальный поиск

headless интеллектуальный поиск

Apply when implementing search functionality, faceted navigation, or autocomplete in a headless VTEX storefront. Covers product_search, autocomplete_suggestions, facets, banners, correction_search, and top_searches endpoints, plus analytics event collection. Use for any custom frontend that integrates VTEX Intelligent Search API for product discovery and search result rendering.

vtex official Дизайн

Что делает навык

Навык обеспечивает интеграцию с Intelligent Search API для реализации поиска товаров, автодополнения и фасетной навигации в headless-витринах VTEX. Он охватывает работу с эндпоинтами product_search, autocomplete_suggestions, facets, banners, correction_search и top_searches, а также сбор аналитических событий для ранжирования.

Когда применять

  • Создание страницы результатов поиска с выводом списка товаров
  • Реализация фасетной навигации (фильтры по категории, бренду, цене, цвету)
  • Добавление подсказок автодополнения в поле поиска
  • Настройка отправки аналитических событий поиска для Intelligent Search ranking

Как работает

  1. Определить необходимость использования API для задач поиска, просмотра категорий, автодополнения или фасетной фильтрации
  2. Использовать эндпоинт product_search для получения результатов поиска товаров
  3. Применить autocomplete_suggestions для реализации подсказок в поле ввода
  4. Использовать эндпоинты facets, banners, correction_search и top_searches для расширенных функций интерфейса
  5. Настраивать сбор аналитических событий для оптимизации ранжирования Intelligent Search

Примеры запросов агенту

Реализуй страницу результатов поиска товаров с использованием product_search
Добавь автодополнение в поле поиска через autocomplete_suggestions
Настрой фасетную навигацию по брендам и ценам с помощью эндпоинта facets

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «headless-intelligent-search» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r headless-intelligent-search/ ~/.claude/skills/headless-intelligent-search/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.