Nova Amazon MCP Server

Подключите данные Amazon Seller Central, Vendor Central, Amazon Ads и DSP к Claude, ChatGPT, Microsoft Copilot, Grok, Gemini или Cursor через Model Context Protocol и задавайте вопросы обычным языком.

Which SKUs lost the most net profit versus last month, and why?
Which search terms spent more than $100 last week with zero sales?
What runs out of stock in the next three weeks across all marketplaces?

В этом репозитории собраны инструкции по настройке и справочные материалы для Nova MCP — размещённого MCP-сервера. Здесь есть готовые для вставки конфигурации клиентов, справочник инструментов и библиотека примеров запросов. Сам сервер — коммерческий сервис компании Nova; исходный код сервера в этом репозитории не содержится.

---

Что это такое

Конечная точка	https://mcp.novadata.io/api/mcp
Транспорт	Удалённый, Streamable HTTP
Аутентификация	OAuth 2.0 с динамической регистрацией клиента; отдельно для каждой учётной записи Amazon. Доступ можно отозвать в Nova
Данные Amazon	Seller Central (3P), Vendor Central (1P), Amazon Ads, Amazon DSP, Search Query Performance, отзывы, Subscribe & Save
Торговые площадки	23 торговые площадки Amazon
Актуальность данных	Заказы и количество проданных единиц обновляются в течение нескольких секунд после продажи. Финансовые транзакции — каждый час, расходы на рекламу — каждые два часа, поисковые запросы — трижды в день, остальные отчёты — ежедневно
Ассистенты	Claude, ChatGPT, Microsoft Copilot, Grok, Gemini, Cursor и любой MCP-клиент
Стоимость	Коммерческий сервис. От $49 в месяц за учётную запись Amazon; 14-дневный бесплатный пробный период, банковская карта не требуется

Зачем нужен слой данных вместо исходных API Amazon

Selling Partner, Vendor и Advertising API Amazon возвращают исходные отчёты из множества отдельных конечных точек и не сводят их между собой. Подключённый к ним ассистент тратит контекст на постраничную загрузку и объединение данных, а ответы на один и тот же вопрос могут различаться.

Вместо этого Nova MCP предоставляет предварительно смоделированный слой данных: заказы, расчёты и все комиссии Amazon, сведённые на уровне SKU, с учётом ваших собственных расходов (COGS, доставка FBM, VAT); данные Sponsored Ads вплоть до поискового запроса покупателя; данные DSP по заказам и позициям; запасы FBA и AWD с указанием дней до исчерпания; состояние листингов, Buy Box и Best Seller Rank. Фильтрация и сортировка выполняются на сервере, поэтому для ответа на вопрос продавца обычно достаточно одного вызова инструмента, а результат совпадает с данными на панели Nova.

Настройка

Понадобится учётная запись Nova, к которой подключена хотя бы одна учётная запись Amazon. Если у вас её ещё нет, начните пробный период на сайте novadata.io.

• Claude (веб-версия и настольное приложение)

• Claude Code

• ChatGPT

• Microsoft Copilot

• Grok

• Gemini

• Cursor

• Корпоративные AI-решения: подойдёт любой MCP-клиент с поддержкой удалённых серверов и OAuth. Подробнее: novadata.io/amazon-ai-agents/connect-enterprise-ai

URL сервера одинаков для всех клиентов. Добавьте его в настройках подключений выбранного клиента.

Инструменты

47 инструментов. Полный справочник см. в docs/tools.md.

Инструмент	Что возвращает
query_metrics	Любые показатели за любой период (продажи, комиссии, прибыль, реклама, сессии и др.) с разбивкой по SKU, ASIN, торговой площадке, учётной записи или временному интервалу
find_movers	Наибольший рост и снижение выбранного показателя относительно базового периода
query_pnl_bridge	P&L на основе заказов и денежных потоков за одни и те же месяцы — рядом и с пояснением различий
explain_movement	Причины изменения показателей товара: трафик, конверсия, цена, Buy Box, реклама, позиция в рейтинге
query_advertising	Данные Sponsored Products, Brands и Display — от кампании до ключевого слова и ASIN
query_search_terms	Поисковые запросы покупателей, связанные с расходами на рекламу; помогают находить минус-слова и новые возможности
query_dsp	Расходы и результаты Amazon DSP с разбивкой по рекламодателю, заказу, позиции, товару, устройству, креативу или аудитории
query_sqp	Search Query Performance: объём поисковых запросов, доля показов и покупок по запросу — ваши показатели в сравнении со всем рынком
query_inventory	Запасы FBA и AWD, скорость продаж, количество дней до исчерпания запасов, риск отсутствия товара и объёмы для повторного заказа
query_listing_health	Листинги со скрытым статусом, недоступные для покупки товары, потерянные позиции Buy Box, проблемы каталога
query_reviews	Отзывы, критические отзывы и рейтинг в звёздах по каждому ASIN
query_subscribe_and_save	Состояние Subscribe & Save, предложения и соответствие требованиям программы
query_vendor_purchase_orders / query_vendor_inventory / query_vendor_invoices / query_vendor_remittances	Vendor Central: заказы на закупку от Amazon, запасы Amazon, ваши счета, платежи и удержания Amazon
get_listing_content / update_listing_content	Просмотр и редактирование содержимого листинга на Amazon (название, пункты описания, backend keywords, атрибуты) с предварительным просмотром изменений до подтверждения
import_cogs / import_fbm_costs / import_vat_categories	Управление данными о расходах из диалога с предварительным просмотром изменений до их сохранения

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

Расширенная библиотека запросов, организованная по задачам, доступна в prompts/ и на сайте novadata.io/amazon-mcp-prompts.

Прибыль

• Составь P&L за прошлую неделю с разбивкой по торговым площадкам и назови три самых значительных изменения.

• У каких SKU чистая прибыль снизилась сильнее всего по сравнению с прошлым месяцем и почему?

• Каков мой фактический TACoS по ASIN за этот квартал?

Реклама

• По каким поисковым запросам на прошлой неделе были самые большие расходы без продаж?

• Найди SKU, у которых расходы на рекламу выросли на 30%, а количество проданных единиц не изменилось или снизилось.

• Сколько стоила реклама Amazon DSP в прошлом месяце и каких результатов она принесла?

Vendor Central

• Сколько товаров Amazon заказала у нас на этой неделе по сравнению с прошлой?

• Сравни выручку от отгрузок через Vendor Central с продажами Seller Central за этот месяц по одним и тем же товарам.

Запасы

• Какие SKU закончатся в ближайшие 30 дней при текущей скорости продаж?

• Какие товары стоит заказать повторно на этой неделе с учётом сроков поставки?

Отличия от собственных MCP-серверов Amazon

Amazon — первоисточник предоставляемых им данных, а его MCP-серверы хорошо подходят для задач, которые они поддерживают: Amazon Ads MCP server — для управления кампаниями, а Selling Partner plugin от Amazon — для работы с Seller Central (на момент запуска поддерживаются магазины в США).

Nova добавляет к данным дополнительную обработку: предварительно объединяет отчёты, чтобы один вызов возвращал согласованный результат; учитывает ваши расходы, чтобы показывать прибыль, а не только продажи; включает расходы на рекламу и DSP в P&L; объединяет данные Vendor Central и Seller Central; позволяет задавать вопросы сразу по всем учётным записям и торговым площадкам. Агентства и команды, работающие с несколькими брендами, могут запрашивать данные всех своих учётных записей одновременно.

Подробнее: novadata.io/amazon-seller-central-mcp-server

Безопасность и разрешения

• OAuth-аутентификация выполняется через Nova. Пароль от Amazon никогда не передаётся MCP

• Доступ предоставляется отдельно для каждой учётной записи Amazon; его можно в любой момент отозвать в Nova

• Участники рабочего пространства видят только те учётные записи, к которым им предоставлен доступ

• Инструменты для работы с расходами изменяют только вашу конфигурацию Nova (COGS, расходы FBM, VAT, теги, настройки запасов) и не вносят изменений в Amazon. Перед сохранением всегда можно просмотреть изменения

• Если эта функция включена для рабочего пространства, редактирование содержимого листинга в Seller Central (название, пункты описания, описание, backend keywords и атрибуты товара; но не цена и количество) доступно только владельцу учётной записи. Перед подтверждением можно просмотреть изменения и результаты их проверки средствами Amazon

• Функции управления кампаниями находятся в разработке. Для них будет использоваться тот же порядок предварительного просмотра и подтверждения

Ссылки

• Amazon MCP server: novadata.io/amazon-mcp-server

• MCP для Seller Central: novadata.io/amazon-seller-central-mcp-server

• Инструкции по подключению: novadata.io/amazon-ai-agents/connect

• Список инструментов: novadata.io/amazon-mcp-tools

• Библиотека запросов: novadata.io/amazon-mcp-prompts

• Для агентств: novadata.io/amazon-mcp-for-agencies

Участие в разработке

Будем рады вашим Issues и pull requests с предложениями по конфигурациям, документации и библиотеке запросов. По вопросам о размещённом сервисе свяжитесь с Nova через сайт.

Лицензия

На содержимое этого репозитория распространяется лицензия MIT. См. LICENSE. Сам сервис Nova MCP является коммерческим.