MPStats

Приложение MPStats подключает аналитический API для исследования рынков Wildberries и Ozon. Агент может сравнивать категории, ниши, бренды, продавцов и товары, исследовать продажи, ключевые слова, тренды, ценовые сегменты и сезонность.

Подключение

1. Войдите в MPStats.
2. Откройте настройки API и скопируйте ключ.
3. В Promto откройте приложение MPStats и нажмите Подключить.
4. Вставьте ключ и дождитесь проверки доступной квоты.

Подключать и отключать интеграцию может только владелец рабочего пространства. Ключ хранится на сервере и не передаётся агенту. Квота общая с использованием API из интерфейса MPStats; один API-запрос расходует одну единицу.

Интерфейс приложения

На главном экране доступны сценарии:

Сценарий	Результат
Ниши и категории	Размер, динамика и конкуренция в сегменте
Товары и конкуренты	Сравнение карточек, продавцов и брендов
Ключевые слова	Запросы, позиции и идеи для SEO карточки
Подключение	Ввод API-ключа

В Настройках показываются маска ключа, использованная и оставшаяся квота, состояние подключения и действие отключения.

Работа с агентом

Основной агент использует инструмент promto_mpstats. Это встроенный инструмент чата, а не команда терминала.

Область	Действия инструмента
Квота	get_api_limit
Категории и предметы	list_categories, get_category, list_subjects, get_subject
Бренды и продавцы	list_brands, get_brand, list_sellers, get_seller
Товары	list_items, get_item, get_item_sales, get_item_keywords
Поиск и аналитика	search, get_trends, get_price_segmentation, get_seasonality
Дополнительный метод API	request

Параметр market принимает wb для Wildberries и oz для Ozon; если его не указать, используется wb. Сезонность поддерживается только для Wildberries.

Практические сценарии

Оценить нишу

Сначала проверьте квоту, затем задайте маркетплейс, путь категории и период. Агент соберёт основные метрики, динамику, ценовые сегменты и заметных продавцов, сохранив исходные даты.

Сравнить товары

Передайте артикулы или результаты поиска. Агент сопоставит продажи, цену, рейтинг и ключевые слова в одинаковом периоде. Данные следует описывать как оценку MPStats, а не как подтверждённый отчёт кабинета.

Найти идеи для карточки

Агент получает ключевые слова товара и поисковые тренды, группирует запросы по намерению и предлагает изменения текста. Публикацию карточки выполняйте отдельно через кабинет или соответствующую интеграцию.

Ограничения и безопасность

• Инструмент работает только на чтение и ничего не меняет в маркетплейсах.
• Рыночные продажи и остатки — аналитическая оценка MPStats; они могут отличаться от кабинета продавца.
• Сезонность доступна только при market=wb.
• Квота расходуется совместно с запросами из веб-интерфейса MPStats. Перед широким анализом вызывайте get_api_limit.
• При mpstats_rate_limited учитывайте retry_after_seconds и не запускайте цикл немедленных повторов.
• Ответ 401 может означать как неверный ключ, так и недоступный путь API; сначала проверьте простое чтение квоты.
• Не передавайте API-ключ в чат, проект или параметры request.

Если не работает

Симптом	Что проверить
Квота закончилась	get_api_limit, тариф и использование API в интерфейсе MPStats
401	Начать с get_api_limit; затем проверить ключ, рынок и путь отчёта
mpstats_rate_limited	Подождать указанное retry_after_seconds, сократить число запросов
Нет сезонности Ozon	Это ограничение метода; сезонность доступна для wb
Цифры расходятся с кабинетом	Сравниваются ли оценка MPStats и фактические данные одного периода
Ничего не найдено	Проверить market, путь категории, артикул и диапазон дат

Связанные материалы

• Wildberries
• Ozon
• Настройки рабочего пространства
• Как получать лучший результат

Готовый промпт

Через promto_mpstats сначала проверь квоту get_api_limit. Затем для market=<wb|oz> исследуй категорию <КАТЕГОРИЯ> за <ПЕРИОД>: объём, динамику, ценовые сегменты, заметные бренды и продавцов. Делай только необходимые запросы и называй показатели оценкой MPStats, а не данными моего кабинета.