headless-intelligent-search — скилл для Claude Code: поиск VTEX
Скилл помогает подключить поиск VTEX Intelligent Search к headless-магазину: от подсказок и фильтров до событий аналитики. Пригодится при разработке собственной витрины.
npx skills add vtex/skills --skill headless-intelligent-search -a claude-codeЧто делает headless-intelligent-search
Скилл описывает работу с поиском товаров, фасетами, автодополнением, исправлением опечаток, популярными запросами и баннерами VTEX Intelligent Search. Он также охватывает события поиска и клики по товарам, которые нужны для аналитики и ранжирования.
Запросы можно отправлять напрямую из фронтенда: API публичный и не требует аутентификации. Для сортировки и фильтрации используются параметры API, а не клиентская обработка результатов. В каждом запросе нужны page и locale; при переходе на следующую страницу следует сохранять значения operator и fuzzy, полученные в первом ответе. Без событий аналитики поисковое ранжирование со временем ухудшается — их нужно подключать вместе с поиском.
Скилл относится к headless-витрине VTEX. Для серверного рендеринга допускается проксирование через BFF, но оно добавляет задержку при частых запросах.
Какие задачи решает
- подключить поиск товаров к headless-витрине VTEX
- добавить автодополнение к полю поиска
- собрать фасетные фильтры по категориям и брендам
- сохранить параметры поиска при пагинации
- отправлять события показа результатов и кликов
Примеры запросов агенту
- Подключи поиск товаров VTEX Intelligent Search к моей headless-витрине и добавь фильтры.
- Добавь подсказки при вводе запроса и отправку событий аналитики.
- Проверь пагинацию поиска: сохраняются ли
operatorиfuzzyиз первого ответа?
Как установить headless-intelligent-search
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-intelligent-search -a claude-code2Вручную: положить файлы
~/.claude/skills/headless-intelligent-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/headless-intelligent-search/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-intelligent-search -a codex2Вручную: положить файлы
.agents/skills/headless-intelligent-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-intelligent-search -a cursor2Вручную: положить файлы
.cursor/skills/headless-intelligent-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills headless-intelligent-search2Вручную: положить файлы
.github/skills/headless-intelligent-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-intelligent-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/headless-intelligent-searchВручную: положить файлы
.devin/skills/headless-intelligent-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill headless-intelligent-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о headless-intelligent-search
Как установить headless-intelligent-search в Claude Code?
Выполни npx skills add vtex/skills --skill headless-intelligent-search -a claude-code. Файл скилла находится по пути ~/.claude/skills/headless-intelligent-search/SKILL.md.
Что делает headless-intelligent-search?
Помогает интегрировать VTEX Intelligent Search в headless-витрину: настроить поиск и фасеты, автодополнение, а также события аналитики.
Как сохранять параметры при пагинации поиска?
Для следующих страниц используй значения operator и fuzzy, полученные в ответе на первый запрос. API определяет их с учётом поискового запроса.
