marketplace-rate-limiting — скилл для Claude Code: ретраи и лимиты

Что делает marketplace-rate-limiting

Скилл включается, когда вы пишете интеграцию с VTEX API — синхронизацию каталога, обработку заказов, обновление цен и остатков. Агент получает набор правил: на 429 ждать, а не долбить эндпоинт повторно, читать Retry-After и брать большее из него и расчётной задержки. Формула задержки — min(maxDelay, baseDelay * 2^attempt) с джиттером от 0.5 до 1.0, чтобы несколько клиентов не ринулись одновременно после сброса окна.

Внутри описан разбор заголовков X-RateLimit-Remaining и X-RateLimit-Reset: по ним агент советует притормаживать ещё до того, как придёт 429. Отдельно разобраны лимиты Pricing API и Orders API, механика burst credits — превышение тратит кредиты, и когда они кончаются, запрос блокируется. Есть пример на TypeScript с axios: обёртка requestWithRetry, повтор только на 429 и 503, конфиг с maxRetries, baseDelayMs, maxDelayMs.

Скилл не покрывает логику синхронизации каталога, обработку событий заказов и отправку счетов — для этого в том же репозитории есть отдельные скиллы. Если в вашей интеграции уже стоит while(true) с повтором без задержки, это повод проверить: такие циклы жгут burst credits и продлевают блокировку.