Кратко
Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.
Пошаговая настройка
Подключи Grupo Éxito Marketplace к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Grupo Éxito Marketplace
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Grupo Éxito Marketplace, вставь свои учётные данные, создай API-ключ MCP — и готово. Без Docker, без
git clone, без локального сервера.
Grupo Éxito Marketplace
Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, задавай цены и остатки, читай заказы и выписки о выплатах.
Настройка
Настройка занимает около 10 минут после того, как Éxito предоставит тебе доступ к API. Вместе с доступом Éxito присылает инструкции по аутентификации: имя пользователя, пароль, API-ключ и адрес, по которому выдаётся токен. Также тебе понадобится числовой идентификатор продавца.
Песочницы нет: Éxito её не документирует, поэтому каждый вызов, включая запись, действует на твой реальный магазин.
- Вставь пользователя API (адрес электронной почты) в
EXITO_USERNAME, а пароль API — вEXITO_PASSWORD; оба значения возьми из инструкций Éxito. - Вставь
x-api-keyиз тех же инструкций вEXITO_API_KEY. - Вставь полный адрес запроса токена, начинающийся с
https://, вEXITO_LOGIN_URL. Он не опубликован на developers.exito.com, поэтому скопируй его из документа, который прислал Éxito. - Укажи свой числовой идентификатор продавца (idSeller, например
11795) вEXITO_SELLER_ID.exito_marketplace_get_bulk_upload_statusтакже показывает его какdata.idSeller. - Установи коннектор. Запусти
exito_marketplace_list_categories, чтобы проверить подключение.
Как происходит вход: коннектор запрашивает токен по адресу выдачи токена, используя твоё имя пользователя, пароль и API-ключ, и отправляет его вместе с API-ключом при каждом вызове. Токены обновляются автоматически, самое позднее — раз в час. Пароль и ключ хранятся в зашифрованном виде и никогда не показываются ИИ.
В облаке и при самостоятельном хостинге всё работает одинаково: учётные данные те же, а redirect URL настраивать не нужно.
Продажи на Éxito асинхронны:
- Выбери самую точную категорию с помощью
exito_marketplace_list_categoriesи прочитай её характеристики черезexito_marketplace_get_category_features. Обязательные характеристики нужно передавать; характеристика со списком значений принимает только их. - Создавай товары с помощью
exito_marketplace_create_products, до 400 EAN за вызов. Изображения — это публичные URL размером 1000x1000 px (733x1000 px для одежды). Бренд уже должен существовать в Éxito; отсутствующий бренд создаёт твой аккаунт-менеджер в Éxito. - Отслеживай пакет через
exito_marketplace_get_bulk_upload_status. Пока предыдущий пакет запускается или обрабатывается, новый не принимается. - Контент-команда Éxito проверяет каждый товар.
exito_marketplace_get_products_waitingпоказывает товары на проверке,exito_marketplace_get_products_rejected— отклонённые с указанием причины, аexito_marketplace_get_products_pending_seller_approval— те, что отличаются от такого же товара, уже представленного на маркетплейсе. После одобрения товару требуется до часа, прежде чем для него можно создать предложение. - Задай одобренным товарам цену и остаток через
exito_marketplace_upsert_offersили, для одного EAN, черезexito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offersотправляет товары и предложения одним запросом. Предложения появляются на сайтах примерно в течение 4 часов.
Цены и остатки: цены — целые колумбийские песо больше 8000, без разделителей (45000). Цена со скидкой должна быть ниже обычной цены. Чтобы изменить только цену, отправь текущий остаток с IsUpdatedStock 0. Изменение цены более чем на 30% возвращается с кодом PEX и должно быть отправлено повторно с подтверждением цены: перед этим ИИ спросит тебя. Чтобы прекратить продажу товара, установи его остаток в 0: удаления в API нет.
Заказы и выплаты: exito_marketplace_get_orders показывает заказы с exito.com, carulla.com и других сайтов Éxito со статусом, суммами, комиссией и типом доставки. exito_marketplace_get_bills показывает выписки о выплатах. Списки листаются с помощью paginationToken.
Отключено при установке: exito_marketplace_set_order_tracking (отметить товары заказа как отправленные с указанием перевозчика и трек-номера) и exito_marketplace_upload_order_invoice (прикрепить счёт к заказу). Включи их на странице коннектора, если ИИ должен работать с заказами; ИИ попросит тебя подтвердить каждый вызов. Создание товаров и установка цен и остатков включены (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Читай каждый ответ: пакетные операции записи отвечают HTTP 200 с отдельным сообщением по каждому отклонённому EAN, поэтому код 200 не означает, что все товары или предложения приняты. Запросы и ответы — на испанском языке.
Не охвачено: транспортные этикетки, модерация Éxito и уведомления о предложениях, а также всё, что веб-приложение Seller Center умеет, а API не предоставляет.
Частые ошибки: если токен не выдаётся, сверь имя пользователя, пароль и API-ключ с инструкциями Éxito и убедись, что EXITO_LOGIN_URL — это адрес токена из этого документа. 401 означает, что токен отклонён. 403 обычно означает, что API-ключ отсутствует или указан неверно либо API не включён для твоего пользователя: уточни у Éxito, какие API входят в твой доступ.
Требования: EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Локальная установка коннектора
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, выбери Grupo Éxito Marketplace и вставь переменные окружения, перечисленные в разделе «Требования».
Доступные инструменты
| Tool | What it does |
|---|---|
exito_marketplace_get_products | Список товаров продавца на маркетплейсе Éxito с названием, EAN, VTEX PLU, изображением, датами создания и обновления, ценой, ценой со скидкой, остатком… |
exito_marketplace_get_products_waiting | Товары, ожидающие одобрения контент-командой Éxito (модерация), с EAN, названием, изображением, датой обработки и родительской ссылкой |
exito_marketplace_get_products_rejected | Товары, отклонённые контент-командой Éxito и требующие исправления, с EAN, названием, изображением, причиной (Reason) и комментарием (Comment) к отклонению |
exito_marketplace_get_products_pending_seller_approval | Товары, по которым нужно твоё решение, так как они отличаются от такого же товара, уже представленного на маркетплейсе: в каждой строке есть oldProduct и… |
exito_marketplace_get_bulk_upload_status | Статус последнего пакета создания товаров (exito_marketplace_create_products). data.status: 4 запускается, 1 обрабатывается, 2 завершён… |
exito_marketplace_list_categories | Все категории маркетплейса Éxito с Id, IdParent, Name и ProductType (Technology или Clothing) |
exito_marketplace_get_category | Одна категория по идентификатору: Id, IdParent, Name и ProductType |
exito_marketplace_get_category_features | Группы характеристик категории: для каждой характеристики specName, label, признак обязательности и допустимые значения (values[].label; an… |
exito_marketplace_get_orders | Заказы, полученные через сайты Éxito (exito.com, carulla.com и другие), с номером заказа, каналом, датами, статусом, суммами, комиссией… |
exito_marketplace_get_bills | Выписки о выплатах (биллинг) продавца: номер счёта, номер заказа, платёжное поручение, назначение, дата платежа, комиссия, итог, IVA и… |
exito_marketplace_create_products | Создание товаров (или изменение существующих: отправь тот же EAN повторно; ModifyImage "1" заменяет изображения) с названием, HTML-описанием… |
exito_marketplace_load_products_and_offers | Отправка товаров вместе с их предложениями одним запросом: каждый элемент содержит Product (поля exito_marketplace_create_products) и… |
exito_marketplace_upsert_offers | Создание или обновление предложений (цена, цена со скидкой, остаток, доставка и срок доставки) для EAN, уже одобренных Éxito, на всех сайтах Éxito… |
exito_marketplace_update_offer_price_stock | Изменение цены и/или остатка одного существующего предложения (один EAN). Éxito требует EAN, Stock и Price при каждом обновлении: чтобы изменить только цену… |
exito_marketplace_set_order_tracking | Отметить товары заказа как отправленные с указанием перевозчика и трек-номера (заказы со стандартной доставкой) |
exito_marketplace_upload_order_invoice | Прикрепить счёт к заказу в виде PDF или ZIP в формате base64 |
Примеры запросов
- "Какие из моих товаров отклонил Éxito и почему?"
- "Покажи заказы, назначенные мне на этой неделе, которые ещё нужно отправить."
- "Какая цена и остаток у EAN 7701234567890 на exito.com?"
- "Установи остаток EAN 7701234567890 в 25 единиц и оставь цену прежней."
- "Подсчитай сумму комиссии в моих выписках о выплатах за октябрь."
Дальнейшие шаги
Это руководство помогло?