eMAG Marketplace в MCP: предложения, цены, остатки, заказы, AWB и возвраты в любом AI-агенте

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → eMAG Marketplace, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

eMAG Marketplace

eMAG Marketplace API для продавцов на eMAG Румыния, Болгария и Венгрия (и Fashion Days): товары и предложения, цены и остатки, заказы с подтверждением и сменой статуса, транспортные этикетки AWB, возвраты (RMA), категории и характеристики, кампании и счета. eMAG должен внести вызывающий IP в белый список.

Настройка

Настройка занимает около 10 минут плюс время, которое eMAG тратит на внесение вашего IP в белый список.

1. В кабинете продавца eMAG Marketplace используйте пользователя с правами на API (или попросите владельца аккаунта его создать).
2. Белый список IP: eMAG принимает вызовы API только с зарегистрированных у них IP-адресов. Отправьте в поддержку eMAG Marketplace публичный IP, с которого обращается этот коннектор: при self-hosted установке адрес вашего сервера, в AnythingMCP Cloud фиксированный IPv4-адрес 104.248.242.235, с которого Cloud делает все вызовы. Пока eMAG его не добавит, каждый вызов отвечает You are not allowed to use this API.
3. Укажите в EMAG_API_HOST хост вашей площадки без пути: https://marketplace-api.emag.ro (Румыния), https://marketplace-api.emag.bg (Болгария), https://marketplace-api.emag.hu (Венгрия), https://marketplace-ro-api.fashiondays.com или https://marketplace-bg-api.fashiondays.com (Fashion Days). Каждая площадка это отдельный аккаунт, поэтому ставьте по коннектору на страну.
4. Укажите пользователя API в EMAG_USERNAME, а его пароль в EMAG_PASSWORD (HTTP Basic).
5. Установите коннектор и запустите emag_marketplace_list_vat_rates: лёгкий вызов, который подтверждает учётные данные и IP.

Как устроен API: коннектор работает с eMAG Marketplace API 3 (документация v4.5.2). Каждый ресурс вызывается как POST <resource>/read, count или save. Чтение принимает фильтры и пагинацию полями верхнего уровня (currentPage, itemsPerPage не больше 100); сохранение принимает список объектов, который коннектор оборачивает в data. Чтение помечено как только чтение, хотя это POST. Каждый ответ имеет вид {"isError": false, "messages": [], "results": [...]}; isError: true сообщается как неудачный вызов с сообщениями. Исключение одно: при сохранении нового товара с проблемой в документации eMAG отвечает isError: true, но предложение всё равно сохраняется, поэтому ИИ перечитывает его через emag_marketplace_list_product_offers.

Что он читает: ваши товары и предложения с ценой, остатком по складам, сроком обработки, статусом, статусом проверки документации и предложения, doc_errors, позицией в buy button и кампанией, с фильтрами по id, артикулу, PNK или статусу и подсчётом по тем же фильтрам; есть ли товар на eMAG по EAN (до 100 за раз), чтобы привязать предложение к существующему товару; категории с характеристиками, допустимыми значениями и признаком обязательности; ставки НДС и сроки обработки; заказы с покупателем, адресом доставки, товарами, ваучерами, способом оплаты, стоимостью доставки и вложениями; габариты посылок; AWB с курьером, историей статусов, весом и наложенным платежом, в PDF (A4, A5, A6) или ZPL; заявки на возврат с причиной, адресом забора и AWB; населённые пункты, курьерские аккаунты, ваши адреса забора и возврата и заданные упаковки; кампании с правилами и сроками, допустимые предложения с максимальной ценой кампании, бейджи кампаний и цену для Smart Deals; счета, которые выставляет вам eMAG, и счета по вашим заказам.

Заказы и доставка: статус заказа 1 новый, 2 в работе, 3 подготовлен, 4 завершён, 0 отменён, 5 возвращён. Порядок: новый заказ, emag_marketplace_acknowledge_order (в 2), emag_marketplace_save_order со статусом 3, AWB через emag_marketplace_create_awb, затем статус 4. emag_marketplace_save_order требует заказ целиком в прочитанном виде, отличаться должны только изменённые поля; редактировать заказ можно только в статусе 2 или 3. Ваучеры входят в данные заказа (vouchers, product_voucher_split). Для AWB ИИ выбирает курьерский аккаунт, адрес отправителя и id населённых пунктов, а затем перечитывает этикетку.

Возвраты (RMA): request_status 2 новый, 3 подтверждён, 6 получен, 7 завершён, 4 отклонён, 5 отменён. emag_marketplace_save_return переводит возврат дальше: из 2 в 3 или 5, из 3 в 6 или 5, из 6 в 4 или 7.

Что он записывает: цены, остатки, срок обработки и статус предложений (emag_marketplace_update_offers, emag_marketplace_update_offer_stock), новые товары с предложением (emag_marketplace_save_product_offers), габариты, подтверждение и статус заказов, вложения к заказам (счёт тип 1, гарантия тип 3), разблокировку курьера, AWB, статус возвратов и предложения в кампании. Всё это действует на живой магазин и реальных курьеров. Перед каждой записью ИИ показывает, что изменится (id предложений со старой и новой ценой или остатком, заказ и новый статус, данные AWB), и ждёт вашего «да». При установке ничего не выключено; администратор может отключить любой инструмент записи, который не нужен команде.

Как читать данные: id у предложений это ваш собственный id товара продавца (ext_id); part_number_key (PNK) это ключ товара eMAG. Предложение продаётся только при остатке больше 0, status 1, offer_validation_status 1 и validation_status 3, 9, 11 или 12. Цены указаны без НДС в валюте площадки (RON в Румынии, EUR в Болгарии с 1 января 2026 года, HUF в Венгрии). Даты в формате YYYY-mm-dd HH:ii:ss по местному времени площадки.

Пагинация и лимиты: списки возвращают не больше 100 записей на страницу; ИИ сначала считает, затем листает через currentPage. Допустимые предложения кампаний листаются курсором: последний ext_id передаётся как lastId. Фильтры дат заказов при подсчёте требуют обе границы, не дальше месяца друг от друга. Вызовы сохранения принимают не больше 50 объектов (рекомендуется 10–50) и 4000 полей ввода на запрос. eMAG допускает 12 запросов в секунду для заказов и 3 в секунду для всех остальных ресурсов вместе; сверх этого отвечает 429.

Частые ошибки: You are not allowed to use this API. или 403 означает, что IP ещё не в белом списке. 401 означает неверные имя пользователя или пароль, пользователя без прав на API или хост другой площадки, чем у аккаунта. 429 это лимит частоты: подождите немного. Другие ответы с isError содержат сообщения eMAG, например о недостающих характеристиках или неверной цене.

Коннектор не открывает аккаунт продавца, не регистрирует ваш IP в eMAG и не работает сразу с несколькими площадками: один коннектор обслуживает одну страну.

Предварительные требования: EMAG_API_HOST, EMAG_USERNAME, EMAG_PASSWORD

Локальная установка коннектора

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, выберите eMAG Marketplace и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Сколько наших предложений на eMAG неактивны или имеют недействительный статус проверки предложения?»
• «Покажи новые заказы eMAG (статус 1) за сегодня с товарами и способом оплаты.»
• «Снизь цену предложения 10452 до 189,90 RON без НДС и поставь остаток 25. Сначала покажи старые и новые значения.»
• «Оформи AWB для заказа 412398765 через наш курьерский аккаунт и дай PDF в формате A6. Сначала покажи данные AWB.»
• «Какие наши предложения могут участвовать в кампании Black Friday и какая у них максимальная цена кампании?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT