4cms-products

⚡ Этот скилл — для вызова через тул Skill(4cms-products), не через Read .../SKILL.md.

4cms Products

Поиск и резолв товаров витрины через аутентифицированный API api.4partners.io/v1. В отличие от брендов/рубрик, у товаров есть серверный поиск и фильтры — поэтому работу отдаём API, локально ничего не сканируем.

Граница доменов. Это 4cms — реальные товары витрины (id/ссылки для привязок). Создание/публикация страниц — PageCraft. Отдельный товар по имени можно резолвить и через 4cms-resolve (публичный suggest даёт id товара сразу) — сюда идём за выборками (фильтр по бренду/рубрике/цене) и деталями.

Предусловие

FOURCMS_API_KEY с доступом к товарам (Skill(4cms-env)). Установка зависимостей (один раз): npm install --prefix .claude/skills/4cms-products

Рейт-лимит ~600 req/min, HTTP всегда 200 (статус в теле). При 100002 «Доступ запрещён» чаще всего это лимит — разнеси запросы и повтори (api.js авто-ретраит 1 раз). Если устойчиво даже одиночным запросом — у токена может не быть скоупа на товары.

Инструмент

node .claude/skills/4cms-products/scripts/products.js [команда] [флаги]

Команда	Что делает
--search "<текст>"	Поиск товаров по названию (+ фильтры ниже). Без текста — просто выборка по фильтрам
--info <ids>	Детали товаров по списку id через запятую (макс 50)
--ids	Все id товаров сайта (постранично)

Фильтры поиска: --brand <csv id>, --rubric <csv id>, --price-from N, --price-to N, --discount, --order <поле>, --page N, --per-page N. Для --info: --country, --currency, --locale. Везде — --variation <code> (дефолт default).

Типичные сценарии

• Товары бренда в рубрике (для лендинга-сравнения): сперва зарезолвь id бренда и рубрики (4cms-resolve или 4cms-catalog), затем products.js --search "" --brand 1120443 --rubric 1288087 --per-page 12.
• Конкретные товары по id в блок: products.js --info 68993288,68995300.
• Подбор по теме: products.js --search "кроссовки nike" --per-page 8.

Формат

{ request, meta, count, products: [{ id, name, link, slug, price, old_price, currency, rubric:{id,name,slug} }] }

• id — в привязки блока (если источник принимает id товаров) или для --info.
• link — в ссылки плейсхолдеров.
• meta — служебные поля ответа (пагинация/фильтры), если API их вернул.

Кладём в bindings только то, что просит paramsSchema источника блока (узнаётся в PageCraft). 4cms-выборка помогает найти нужные id; что именно подставлять — диктует источник.

Если скрипт не отдаёт ожидаемое — проверь живой API

Открой Swagger UI 4cms: https://api.4partners.io/ → Authorize (X-Auth-Token = ключ) → product/list (или product/info) → Try it out. Это реальный запрос — сравни ответ со скриптом.

• HTTP всегда 200 — смотри тело (status, status_code, message).
• 100002 чаще всего = рейт-лимит (~600 req/min): подожди ~минуту и повтори.
• Док (Notion): https://help.4partners.io/partner-site-api-v1

Что не делает

• Не перечисляет рубрики/бренды — это 4cms-catalog.
• Не резолвит одиночное имя/URL без ключа — это 4cms-resolve.
• Не создаёт страницы — это PageCraft.
• Не настраивает .env — это 4cms-env.