Catalog Attribute Normalizer — MCP-сервер для Claude Code
Приводит атрибуты товаров из разных источников к единому виду и подбирает категории по реальным таксономиям Google и Shopify.
claude mcp add --transport http catalog-normalizer https://catalog-normalizer.acjlabs.com/mcpЧто делает Catalog Attribute Normalizer
Сервер принимает партию товаров с полями title, description и raw_attributes и возвращает нормализованные значения: размеры, цвета, единицы измерения. Категории подбираются не по памяти модели, а по актуальным файлам таксономий Google Product Taxonomy и Shopify — кандидаты извлекаются из них и предлагаются модели как подсказки. Поэтому leaf_id почти всегда указывает на существующий узел. Amazon остаётся без такой опоры: публичного справочника для извлечения кандидатов нет, так что там классификация идёт по памяти.
Атрибуты надёжны по построению: значения берутся из вашего же ввода и только приводятся к канонической форме. Если значение выведено из заголовка или описания, в provenance стоит "extracted" — это подсказка, а не факт. Ключи словаря фиксированы (size, color, material, gender, sleeve_length), незнакомые отбрасываются.
Работает как MCP-сервер с инструментом normalize_catalog или как обычный HTTPS API. Ключ выдаётся самостоятельно через POST /v1/signup с адресом почты в теле — он приходит в ответе и показывается один раз, восстановить его нельзя. Бесплатный тариф даёт 500 товаров в месяц. Считается товар, а не вызов: партия из 40 позиций списывает 40. Партия обрабатывается целиком или никак — если она больше остатка, запрос отклоняется с 402, и ничего не классифицируется.
Какие задачи решает
- свести размеры и цвета из выгрузки Shopify, CSV поставщика и скрапа маркетплейса к одному написанию
- получить категорию товара с проверенным
leaf_idвместо выдуманного моделью - привести единицы измерения к канонической форме перед загрузкой в фид
- отличить значение, взятое из исходных данных, от выведенного моделью
- разметить партию товаров сразу по таксономиям Google и Shopify
Примеры запросов агенту
- Нормализуй атрибуты этой партии товаров и подбери категории для google и shopify
- Прогони
raw_attributesчерезnormalize_catalogи покажи, гдеprovenanceравенextracted - Проверь, какие
leaf_idвернулись пустыми, и объясни, почему
Как установить Catalog Attribute Normalizer
Командой платформы: удалённый сервер
claude mcp add --transport http catalog-normalizer https://catalog-normalizer.acjlabs.com/mcpКомандой платформы: удалённый сервер
codex mcp add catalog-attribute-normalizer --url https://catalog-normalizer.acjlabs.com/mcpФайл настроек
{
"mcpServers": {
"catalog-attribute-normalizer": {
"url": "https://catalog-normalizer.acjlabs.com/mcp"
}
}
}Файл настроек
{
"servers": {
"catalog-attribute-normalizer": {
"type": "http",
"url": "https://catalog-normalizer.acjlabs.com/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http catalog-attribute-normalizer https://catalog-normalizer.acjlabs.com/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Catalog Attribute Normalizer
Как установить Catalog Attribute Normalizer в Claude Code?
Выполните claude mcp add --transport http catalog-normalizer https://catalog-normalizer.acjlabs.com/mcp. Для авторизации добавьте заголовок Authorization: Bearer YOUR_API_KEY.
Что делает Catalog Attribute Normalizer?
Принимает партию товаров и возвращает канонические атрибуты вместе с путями категорий по запрошенным таксономиям. Работает как MCP-сервер или как HTTPS API.
Чем отличается нормализация атрибутов от классификации категорий?
Атрибуты приводятся к канонической форме из ваших же данных, поэтому ошибок распознавания тут нет. Категории подбираются через извлечение кандидатов из файлов таксономий, и для Amazon такой опоры нет — там результат слабее.
