Кратко
Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.
Пошаговая настройка
Подключи Grupo Éxito Marketplace к Meta Muse за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Grupo Éxito Marketplace в пошаговой настройке и добавь свой MCP URL в Meta Muse. Без кода и без собственного сервера.
Без банковской карты · 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 + Meta Muse
Позволь своему ИИ управлять магазином на маркетплейсе exito.com в Колумбии через API продавца Grupo Éxito: получай список товаров и статус их одобрения, создавай товары с изображениями, описаниями и атрибутами, устанавливай цены и остатки, читай заказы и выписки о выплатах.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (они видны в магазине внутри приложения, когда ты выбираешь коннектор). Для этого коннектора нужны следующие переменные окружения:
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Шаг 1 — Получи учётные данные
Настройка занимает около 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-ключом при каждом вызове. Токены обновляются автоматически, не реже чем раз в час. Пароль и ключ хранятся в зашифрованном виде и никогда не показываются ИИ.
Облако и self-hosted работают одинаково: учётные данные те же, а 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 охватывает твой доступ.
Шаг 2 — Установи адаптер
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
Шаг 3 — Добавь коннектор в Muse
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Muse добавляет удалённые MCP-серверы как пользовательские коннекторы и входит в них через OAuth.
- В Muse открой Settings → Connectors и выбери Add custom connector.
- Вставь URL MCP-сервера
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse откроет страницу входа AnythingMCP: войди и подтверди доступ.
- В чате попроси Muse о том, для чего нужны инструменты
Grupo Éxito Marketplace.
Настроить коннектор можно и из чата — в вебе, в приложениях для iOS и Android или в WhatsApp. Отправь Muse это сообщение:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Muse подключается из облака Meta, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что делает |
|---|---|
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: 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 | Выписки о выплатах (billing) продавца: номер счёта, номер заказа, платёжное поручение, назначение, дата платежа, комиссия, итог, 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 единиц и оставь цену прежней."
- "Подсчитай сумму комиссии в моих выписках о выплатах за октябрь."
FAQ
Где доступен Muse? Сейчас Meta предлагает Muse в США и Канаде — в вебе, в приложениях для iOS и Android и в WhatsApp.
Проверяет ли Meta этот коннектор? Нет. Meta не проверяет пользовательские коннекторы. Muse видит только те инструменты, которые ты включил для этого MCP-сервера в AnythingMCP, а отключить коннектор можно в любой момент в Settings → Connectors.
Следующие шаги
Это руководство помогло?