# Catalog Attribute Normalizer

Приводит атрибуты товаров из разных источников к единому виду и подбирает категории по реальным таксономиям Google и Shopify.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Автор: ACJLabs
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ACJLabs/catalog-normalizer
- Обновлён: 2026-08-08
- HTML: https://affpapa.org/nevibecode/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`, и ничего не классифицируется.

## Требования
- Удалённый сервер: `https://catalog-normalizer.acjlabs.com/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http catalog-normalizer https://catalog-normalizer.acjlabs.com/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add catalog-attribute-normalizer --url https://catalog-normalizer.acjlabs.com/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "catalog-attribute-normalizer": {
            "url": "https://catalog-normalizer.acjlabs.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "catalog-attribute-normalizer": {
            "type": "http",
            "url": "https://catalog-normalizer.acjlabs.com/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http catalog-attribute-normalizer https://catalog-normalizer.acjlabs.com/mcp
```

## Когда брать
- свести размеры и цвета из выгрузки Shopify, CSV поставщика и скрапа маркетплейса к одному написанию
- получить категорию товара с проверенным `leaf_id` вместо выдуманного моделью
- привести единицы измерения к канонической форме перед загрузкой в фид
- отличить значение, взятое из исходных данных, от выведенного моделью
- разметить партию товаров сразу по таксономиям Google и Shopify

## Примеры запросов агенту
- Нормализуй атрибуты этой партии товаров и подбери категории для google и shopify
- Прогони `raw_attributes` через `normalize_catalog` и покажи, где `provenance` равен `extracted`
- Проверь, какие `leaf_id` вернулись пустыми, и объясни, почему

## Похожие
- [marketplace-catalog-sync](https://affpapa.org/nevibecode/skills/marketplace-catalog-sync.md) — скилл · 1000 установок
- [catalog-cli-pro](https://affpapa.org/nevibecode/mcp/catalog-cli-pro.md) — MCP-сервер · ★ 17
- [clean-data-xls](https://affpapa.org/nevibecode/skills/clean-data-xls.md) — скилл · 2100 установок
- [omnistudio-epc-catalog-generate](https://affpapa.org/nevibecode/skills/omnistudio-epc-catalog-generate.md) — скилл · 4800 установок
- [database-schema-design](https://affpapa.org/nevibecode/skills/database-schema-design.md) — скилл · 591 установка
- [google-cloud-solution-agentic-analytics-spark-knowledge-catalog](https://affpapa.org/nevibecode/skills/google-cloud-solution-agentic-analytics-spark-knowledge-catalog.md) — скилл · 5000 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md