marketplace-catalog-sync — скилл для Claude Code
Помогает писать коннектор продавца, который отправляет товары в маркетплейс VTEX и держит цены с остатками в актуальном состоянии.
npx skills add vtex/skills --skill marketplace-catalog-sync -a claude-codeЧто делает marketplace-catalog-sync
Скилл включается, когда вы делаете seller-коннектор для VTEX: регистрация и обновление SKU через Change Notification, жизненный цикл SKU Suggestion (отправка, ожидание, одобрение или отказ), маппинг полей товара на схему каталога VTEX, отдельные уведомления по цене и остаткам. Внутри — правила выбора маршрута и разбор частой путаницы: у changenotification есть два POST-маршрута, и они не взаимозаменяемы. Форма пути говорит платформе, какой идентификатор вы передаёте.
Коннектор продавца обязан использовать маршрут с двумя сегментами — {sellerId} и собственным кодом SKU продавца. Односегментный вариант ждёт ID SKU из каталога маркетплейса, и подставить туда код продавца нельзя. Ответ 200 OK означает, что SKU уже есть у этого продавца, и идёт обновление; 404 Not Found — что записи нет и нужно отправить suggestion. Сами suggestions уходят на https://api.vtex.com/{accountName}/suggestions/{sellerId}/{sellerSkuId}, а не на хост магазина, с теми же App Key и App Token.
Есть жёсткие ограничения. Прямые записи в Catalog API (POST /api/catalog/pvt/product, POST /api/catalog/pvt/stockkeepingunit) продавцу недоступны: каталогом он не владеет, поэтому такие вызовы вернут 403 Forbidden или создадут записи в обход одобрения. Правки suggestion возможны только в статусе pending — после решения маркетплейса изменить его нельзя.
Какие задачи решает
- зарегистрировать новый SKU продавца в каталоге маркетплейса
- различить маршруты changenotification по числу сегментов в пути
- провести SKU через отправку suggestion и одобрение
- отправлять отдельные уведомления по цене и остаткам
- уложить ответ Fulfillment Simulation в лимит времени
Примеры запросов агенту
- Напиши коннектор продавца, который отправляет SKU в маркетплейс VTEX через Change Notification
- Проверь, что для регистрации SKU используется маршрут с
{sellerId}и кодом SKU продавца, а не одиночный{skuId} - Добавь уведомления о цене и остатках и обработку Fulfillment Simulation
Как установить marketplace-catalog-sync
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-catalog-sync -a claude-code2Вручную: положить файлы
~/.claude/skills/marketplace-catalog-sync/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/marketplace-catalog-sync/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-catalog-sync -a codex2Вручную: положить файлы
.agents/skills/marketplace-catalog-sync/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-catalog-sync -a cursor2Вручную: положить файлы
.cursor/skills/marketplace-catalog-sync/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vtex/skills marketplace-catalog-sync2Вручную: положить файлы
.github/skills/marketplace-catalog-sync/SKILL.md1Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-catalog-sync -a gemini-cli2Командой платформы
gemini skills install https://github.com/vtex/skills --path skills/marketplace-catalog-syncВручную: положить файлы
.devin/skills/marketplace-catalog-sync/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vtex/skills --skill marketplace-catalog-sync -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о marketplace-catalog-sync
Как установить marketplace-catalog-sync в Claude Code?
Выполните npx skills add vtex/skills --skill marketplace-catalog-sync -a claude-code. Скилл появится в ~/.claude/skills/marketplace-catalog-sync/SKILL.md.
Что делает marketplace-catalog-sync?
Даёт агенту правила для seller-коннектора VTEX: маршруты Change Notification, работа с SKU Suggestion, маппинг товара, синхронизация цены и остатков, Fulfillment Simulation.
Можно ли создавать товары напрямую через Catalog API?
Нет. Прямые записи в POST /api/catalog/pvt/product и POST /api/catalog/pvt/stockkeepingunit — сторона маркетплейса; у продавца они вернут 403 Forbidden или создадут записи в обход одобрения.
