Кратко
Salsify PXM API для одной организации: продукты и их значения свойств, цифровые активы, определения свойств, членство в списках, экспорты, запуски импорта и запуски каналов. API ключ (bearer) и идентификатор организации.
Пошаговая настройка
Подключи Salsify к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Salsify в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Salsify
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Salsify, вставь свои учетные данные, создай MCP API ключ и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Salsify
Salsify PXM API для одной организации: продукты и их значения свойств, цифровые активы, определения свойств, членство в списках, экспорты, запуски импорта и запуски каналов. API ключ (bearer) и идентификатор организации.
Настройка
Настройка занимает около 3 минут.
- Войди в Salsify (желательно как выделенный пользователь интеграции с только необходимыми правами) и открой свой профиль, API доступ (https://app.salsify.com/app/profile/edit/api). Скопируй API ключ (сгенерируй один, если пусто) в
SALSIFY_API_TOKEN. Он действует с правами этого пользователя и остается действительным, пока не будет сгенерирован заново. - Скопируй идентификатор организации из адресной строки: часть после
/orgs/, начинающуюся сs-(например,s-1a2b3c4d-...). Вставь его вSALSIFY_ORG_ID.
Доступ к API зависит от твоей лицензии Salsify; спроси своего контактного лица в Salsify, если в профиле нет API ключа. Токен отправляется как bearer токен.
С чего начать: salsify_list_products (с фильтром или без для всех) и salsify_get_product для одного продукта. Идентификаторы свойств — это ключи, которые ты видишь на продуктах; salsify_get_property объясняет одно.
Продукты: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Значения индексируются по идентификатору свойства (например, Brand, Product Name); свойство с несколькими значениями принимает список; null очищает значение. Неизвестные идентификаторы свойств создаются как текстовые свойства, поэтому проверь написание. salsify_upsert_products (пакетный) и salsify_delete_product установлены выключенными.
Цифровые активы: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (из публичного URL; обрабатывается в фоновом режиме), salsify_update_digital_asset. Свяжи актив с продуктом, установив свойство актива продукта на идентификатор актива.
Свойства и списки: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. Нет задокументированного вызова для перечисления каждого свойства: экспортируй с атрибутом entity_type.
Экспорты и импорты: salsify_start_export, затем salsify_get_export, пока не завершится; URL — это временная ссылка на файл. salsify_get_import_run читает запуск импорта; salsify_start_import_run (запускает настроенный импорт, возможно, по многим продуктам) выключен.
Каналы: salsify_get_latest_channel_run и salsify_get_channel_run показывают состояние и ссылку на ленту канала; salsify_start_channel_run выключен, потому что запуск может публиковать в ритейлер. Маршруты канала используются собственными интеграциями Salsify, но описаны только частично в публичной справке.
Фильтры: Язык фильтров Salsify: ='Brand':'Acme' (равно), ='Product Name':^'Mug' (начинается с), ='Price':>'10', =list:12345 (члены списка); соединяй условия с запятой для AND. Имена свойств и значения находятся в одинарных кавычках.
Пагинация и лимиты: страница с 1 и per_page до 100; meta.total_entries дает общее количество. Пагинация останавливается на 10,000-м результате (422): используй экспорт для больших наборов. Организация может делать 10,000 запросов в час для всех своих пользователей (429 выше; заголовки x-ratelimit-remaining и x-ratelimit-reset). Ошибки приходят как 422 с списком ошибок; 401 означает, что API ключ неверен; 400 со списком организаций означает, что идентификатор организации отсутствует или неверен.
Предварительные требования: SALSIFY_ORG_ID, SALSIFY_API_TOKEN
Установи коннектор локально
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Открой http://localhost:3000/connectors/store, выбери Salsify и вставь переменные окружения, указанные в Предварительных требованиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
salsify_list_products | Перечисляет продукты, при необходимости сужая по фильтру Salsify: каждое значение свойства каждого продукта в виде пар идентификатор свойства и значение, плюс системные… |
salsify_get_product | Получает один продукт по его идентификатору: все значения свойств (пары идентификатор свойства и значение, списки для свойств с несколькими значениями), системные поля… |
salsify_create_product | Создает продукт из пар идентификатор свойства и значения; свойство идентификатора продукта обязательно. Идентификатор свойства, который еще не существует, создается как… |
salsify_update_product | Обновляет значения свойств одного продукта: только отправленные свойства изменяются; каждое отправленное значение заменяет сохраненное, null удаляет его.… |
salsify_upsert_products | Создает или обновляет до 100 продуктов за один вызов из списка объектов значений свойств (каждый с обязательным свойством идентификатора продукта). Ответ с… |
salsify_delete_product | Удаляет один продукт навсегда, вместе с его значениями свойств. Не может быть отменено. Установлен выключенным |
salsify_list_digital_assets | Перечисляет цифровые активы (изображения, видео, документы), при необходимости сужая по фильтру: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Получает один цифровой актив: salsify:id, salsify:name, salsify:url (ссылка для загрузки), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Добавляет цифровой актив из публичного URL; Salsify загружает его в фоновом режиме (salsify:status in_progress, затем завершено). Необязательный идентификатор… |
salsify_update_digital_asset | Обновляет цифровой актив: пользовательские метаданные, salsify:name или salsify:source_url для замены файла (что создает новую ссылку). Только… |
salsify_get_property | Получает одно определение свойства (атрибута): salsify:id, salsify:name, salsify:data_type (строка, rich_text, число, дата, логическое, перечисленное… |
salsify_add_list_members | Добавляет продукты (или другие сущности) в существующий список Salsify по их идентификаторам. Идентификатор списка — это номер в URL списка в Salsify |
salsify_remove_list_members | Удаляет продукты (или другие сущности) из списка Salsify. Продукты остаются |
salsify_start_export | Запускает экспортный файл продуктов, цифровых активов, свойств (атрибут), перечисленных значений (attribute_value) или всего (all). Возвращает… |
salsify_get_export | Получает состояние запуска экспорта: статус (в процессе, завершено, не удалось), прогресс, estimated_time_remaining, failure_reason и, как только… |
salsify_start_import_run | Запускает импорт, который уже настроен в Salsify (например, JSON или CSV импорт из точки монтирования). Он может изменить много продуктов… |
salsify_get_import_run | Получает состояние запуска импорта: статус (в процессе, завершено, не удалось, отменено, остановлено), прогресс и ошибки. Не опрашивай чаще, чем каждые 15… |
salsify_get_latest_channel_run | Получает последний запуск канала (поток продуктов или публикация в ритейлере или на сайте): id, статус (в процессе, завершено, не удалось), временные метки… |
salsify_get_channel_run | Получает один запуск канала: статус, временные метки и product_export_url после завершения |
salsify_start_channel_run | Запускает новый запуск канала, который регенерирует его ленту и, для публикуемых каналов, отправляет его ритейлеру или на сайт. Установлен выключенным… |
Примеры запросов
- "Какие продукты Salsify бренда Northwind не имеют названия продукта?"
- "Покажи продукт 00012345678905 с его значениями свойств."
- "Начни экспорт списка Holiday Catalog и сообщи мне, когда он будет готов."
- "Когда завершился последний запуск канала нашего ритейлера и с какими ошибками?"
- "Добавь продукты 00012345678905 и 00012345678912 в список Spring Launch."
Следующие шаги
Это руководство помогло?