mcp-server-ozon-seller

MCP-сервер для Ozon Seller API. Полное покрытие API: товары, заказы FBS/FBO, финансы, аналитика, возвраты, чаты, акции, отзывы и многое другое.
Возможности
Товары (Products)
| MCP Tool | CLI | Описание |
|---|
ozon_product_list | product-list | Список товаров |
ozon_product_info | product-info | Информация о товаре |
ozon_product_info_list | product-info-list | Информация о нескольких товарах |
ozon_product_import | product-import | Импорт/создание товаров |
ozon_product_import_info | product-import-info | Статус импорта |
ozon_product_update | product-update | Обновить товары |
ozon_product_prices_update | product-prices-update | Обновить цены |
ozon_product_stocks_update | product-stocks-update | Обновить остатки FBS |
ozon_product_stocks_info | product-stocks-info | Информация об остатках |
ozon_product_prices_info | product-prices-info | Информация о ценах |
ozon_product_description | product-description | Описание товара |
ozon_product_attributes | product-attributes | Атрибуты товаров |
ozon_product_archive | product-archive | Архивировать товары |
ozon_product_unarchive | product-unarchive | Разархивировать товары |
ozon_product_delete | product-delete | Удалить товары |
ozon_product_pictures_import | — | Импорт изображений |
ozon_product_pictures_info | — | Статус загрузки изображений |
ozon_product_geo_restrictions | — | Гео-ограничения |
ozon_product_rating | product-rating | Контент-рейтинг по SKU |
ozon_product_related_sku | product-related-sku | Связанные SKU (FBO/FBS) |
ozon_product_upload_digital_codes | — | Загрузить коды активации |
FBS-отправления
| MCP Tool | CLI | Описание |
|---|
ozon_unfulfilled_orders | list | Несобранные FBS-заказы |
ozon_labels_pdf | labels | Скачать PDF-этикетки |
ozon_ship_orders | ship | Собрать заказы |
ozon_fbs_postings_list | fbs-list | Список FBS-отправлений с фильтрами |
ozon_fbs_posting_get | fbs-get | Детали отправления |
ozon_fbs_posting_ship | fbs-ship | Собрать конкретное отправление |
ozon_fbs_posting_cancel | fbs-cancel | Отменить отправление |
ozon_fbs_cancel_reasons | fbs-cancel-reasons | Причины отмены |
ozon_fbs_posting_tracking | fbs-tracking | Установить трек-номер |
ozon_fbs_posting_label | fbs-label | Скачать этикетку |
ozon_fbs_act_create | fbs-act-create | Создать акт |
ozon_fbs_act_status | fbs-act-status | Статус акта |
ozon_fbs_act_pdf | fbs-act-pdf | Скачать PDF акта |
ozon_fbs_digital_act_pdf | — | Электронный акт |
ozon_fbs_container_labels | — | Этикетки контейнера |
ozon_fbs_posting_delivered | — | Подтвердить доставку (rFBS) |
ozon_fbs_posting_last_mile | — | Отгрузить последняя миля |
ozon_fbs_timeslot_restrictions | — | Ограничения таймслота |
ozon_fbs_restrictions | fbs-restrictions | Ограничения отправления |
ozon_fbs_product_country_set | — | Установить страну |
ozon_fbs_product_country_list | fbs-country-list | Список стран |
FBO
| MCP Tool | CLI | Описание |
|---|
ozon_fbo_postings_list | fbo-list | Список FBO-отправлений |
ozon_fbo_posting_get | fbo-get | Детали FBO-отправления |
ozon_fbo_supply_create | — | Создать поставку |
ozon_fbo_supply_get | fbo-supply-get | Детали поставки |
ozon_fbo_supply_list | fbo-supply-list | Список поставок |
ozon_fbo_supply_cancel | fbo-supply-cancel | Отменить поставку |
ozon_fbo_supply_items | fbo-supply-items | Товары поставки |
ozon_fbo_supply_shipments | — | Отгрузки поставки |
ozon_fbo_warehouse_workload | — | Загруженность склада |
Категории
| MCP Tool | CLI | Описание |
|---|
ozon_category_tree | categories | Дерево категорий |
ozon_category_attributes | category-attributes | Атрибуты категории |
ozon_category_attribute_values | category-values | Значения словаря |
ozon_category_attribute_values_search | category-values-search | Поиск по словарю |
Финансы
| MCP Tool | CLI | Описание |
|---|
ozon_finance_transactions | finance-transactions | Финансовые транзакции |
ozon_finance_totals | finance-totals | Итоги по транзакциям |
ozon_finance_cash_flow | finance-cash-flow | Движение денежных средств |
ozon_finance_realization | finance-realization | Отчёт о реализации |
Аналитика
| MCP Tool | CLI | Описание |
|---|
ozon_analytics_data | analytics | Аналитические данные |
ozon_analytics_stock_on_warehouses | analytics-stock | Остатки на складах |
ozon_analytics_item_turnover | analytics-turnover | Оборачиваемость |
Склады
| MCP Tool | CLI | Описание |
|---|
ozon_warehouse_list | warehouses | Склады продавца |
ozon_warehouse_delivery_methods | delivery-methods | Способы доставки |
Возвраты
| MCP Tool | CLI | Описание |
|---|
ozon_returns_fbo | returns-fbo | Возвраты FBO |
ozon_returns_fbs | returns-fbs | Возвраты FBS |
ozon_return_get | return-get | Детали возврата |
ozon_return_rfbs_list | returns-rfbs | Возвраты rFBS |
ozon_return_rfbs_get | return-rfbs-get | Детали возврата rFBS |
ozon_return_rfbs_approve | return-rfbs-approve | Одобрить возврат |
ozon_return_rfbs_reject | return-rfbs-reject | Отклонить возврат |
ozon_return_rfbs_compensate | — | Компенсация возврата |
Чаты
| MCP Tool | CLI | Описание |
|---|
ozon_chat_list | chats | Список чатов |
ozon_chat_history | chat-history | История чата |
ozon_chat_start | chat-start | Начать чат |
ozon_chat_send_message | chat-send | Отправить сообщение |
ozon_chat_send_file | — | Отправить файл |
ozon_chat_read | — | Отметить прочитанным |
Акции и стратегии
| MCP Tool | CLI | Описание |
|---|
ozon_promo_available | promos | Доступные акции |
ozon_promo_candidates | promo-candidates | Кандидаты в акцию |
ozon_promo_products | promo-products | Товары в акции |
ozon_promo_products_add | — | Добавить товары в акцию |
ozon_promo_products_remove | — | Убрать товары из акции |
ozon_promo_hotsale_list | promo-hotsale | Hot Sale акции |
ozon_strategy_list | strategies | Ценовые стратегии |
ozon_strategy_create | strategy-create | Создать стратегию |
ozon_strategy_update | — | Обновить стратегию |
ozon_strategy_delete | strategy-delete | Удалить стратегию |
Рейтинг и качество
| MCP Tool | CLI | Описание |
|---|
ozon_rating_summary | rating | Рейтинг продавца |
ozon_rating_history | rating-history | История рейтинга |
ozon_quality_rating | quality-rating | Рейтинг качества |
Отчёты
| MCP Tool | CLI | Описание |
|---|
ozon_report_create | report-create | Создать отчёт |
ozon_report_info | report-info | Статус отчёта |
ozon_report_list | report-list | Список отчётов |
ozon_report_download | report-download | Скачать отчёт |
Отзывы
| MCP Tool | CLI | Описание |
|---|
ozon_reviews_list | reviews | Список отзывов |
ozon_review_info | review-info | Детали отзыва |
ozon_review_count | — | Количество отзывов |
ozon_review_comment | review-comment | Ответить на отзыв |
Вопросы
| MCP Tool | CLI | Описание |
|---|
ozon_questions_list | questions | Список вопросов |
ozon_question_answer | question-answer | Ответить на вопрос |
ozon_question_update | — | Обновить ответ |
Отмены
| MCP Tool | CLI | Описание |
|---|
ozon_cancellation_list | cancellations | Заявки на отмену |
ozon_cancellation_info | cancellation-info | Детали заявки |
ozon_cancellation_approve | cancellation-approve | Одобрить отмену |
ozon_cancellation_reject | cancellation-reject | Отклонить отмену |
Сертификаты
| MCP Tool | CLI | Описание |
|---|
ozon_certificate_list | certificates | Список сертификатов |
ozon_certificate_info | certificate-info | Детали сертификата |
ozon_certificate_create | — | Добавить сертификат |
ozon_certificate_delete | certificate-delete | Удалить сертификат |
ozon_certificate_bind | — | Привязать к товарам |
ozon_certificate_unbind | — | Отвязать от товаров |
Штрихкоды
| MCP Tool | CLI | Описание |
|---|
ozon_barcode_generate | barcode-generate | Сгенерировать штрихкоды |
ozon_barcode_add | barcode-add | Привязать штрихкод |
Бренды
| MCP Tool | CLI | Описание |
|---|
ozon_brand_list | brands | Список брендов |
Установка
Из PyPI
pip install mcp-server-ozon-seller
Из исходников
git clone https://github.com/dontsovcmc/mcp-server-ozon-seller.git
cd mcp-server-ozon-seller
pip install -e ".[test]"
Настройка Claude Code
claude mcp add ozon-seller \
-e OZON_CLIENT_ID=your_client_id \
-e OZON_API_KEY=your_api_key \
-- mcp-server-ozon-seller
Или вручную в ~/.claude/settings.json:
{
"mcpServers": {
"ozon-seller": {
"command": "mcp-server-ozon-seller",
"env": {
"OZON_CLIENT_ID": "your_client_id",
"OZON_API_KEY": "your_api_key"
}
}
}
}
CLI
Вторая точка входа — команда ozon-seller-cli.
Переменные окружения
export OZON_CLIENT_ID=your_client_id
export OZON_API_KEY=your_api_key
Или через файл:
ozon-seller-cli --env .env COMMAND
Примеры
# Товары
ozon-seller-cli product-list --limit 10
ozon-seller-cli product-info --offer-id SKU-001
ozon-seller-cli product-stocks-info
# FBS-отправления
ozon-seller-cli list # несобранные заказы
ozon-seller-cli labels # скачать этикетки
ozon-seller-cli ship --all # собрать все
ozon-seller-cli fbs-list # с фильтрами
ozon-seller-cli fbs-cancel-reasons # причины отмены
# FBO
ozon-seller-cli fbo-list
ozon-seller-cli fbo-supply-list
# Финансы и аналитика
ozon-seller-cli finance-transactions '{"date": {"from": "2026-04-01", "to": "2026-04-25"}}'
ozon-seller-cli analytics-stock
# Возвраты
ozon-seller-cli returns-fbs
ozon-seller-cli returns-fbo
# Другое
ozon-seller-cli warehouses
ozon-seller-cli categories
ozon-seller-cli rating
ozon-seller-cli reviews
ozon-seller-cli brands
Переменные окружения
| Переменная | Описание |
|---|
OZON_CLIENT_ID | Client-Id из личного кабинета Ozon Seller |
OZON_API_KEY | Api-Key из личного кабинета Ozon Seller |
Получить ключи: Ozon Seller -> Настройки -> API-ключи.
Лицензия
MIT