DataDoe

официальный

Размещённый MCP-сервер для Amazon Seller Central, Vendor Central и Amazon Ads: ИИ-агенты читают актуальные данные и обновляют листинги, заказы и рекламные кампании

Что можно делать с DataDoe MCP?

  • Запрос данных о продажах на Amazon — запрашивайте заказы, продажи, трафик, запасы, возвраты или расчёты на уровне SKU по маркетплейсам и периодам времени.
  • Создание пользовательских экспортов — создавайте экспорты с фильтрами в стиле SQL, GROUP BY, агрегациями и интервалами дат, возвращаемые в формате CSV или JSON.
  • Анализ Amazon Ads — просматривайте эффективность кампаний, ключевых слов и поисковых запросов, включая метрики ACoS, ROAS и доли показов.
  • Обновление листингов и заказов — изменяйте заголовки, пункты списка, цены и изображения, а также отменяйте заказы и подтверждайте отправки через Actions.
  • Управление кампаниями Ads — добавляйте, обновляйте, удаляйте или приостанавливайте кампании, группы объявлений, таргетинги и объявления с шагом валидации dryRun.
  • Выполнение запросов AMC — валидируйте, запускайте и получайте результаты запросов и рабочих процессов Amazon Marketing Cloud.

Документация

Amazon Seller MCP Server - DataDoe

Хостинговый MCP-сервер для Amazon Seller Central и Vendor Central с доступом на чтение и запись. Подключите Claude, ChatGPT, Cursor, Codex, Gemini и GitHub Copilot к живым данным Amazon SP-API и Amazon Ads API, а затем позвольте вашему ИИ-агенту действовать на их основе: обновлять листинги, управлять заказами и оптимизировать кампании Amazon Ads. DataDoe берёт на себя одобрение разработчика SP-API, OAuth и лимиты запросов, чтобы ваш ИИ-агент начал работать менее чем за минуту.

Amazon Seller & Vendor SP-API Selling Partner API Amazon Ads API MCP Server Read and Write AI clients supported smithery badge License: MIT

🔗 Начать 14-дневный бесплатный пробный период · 📘 Документация · ⚡ Actions · 📊 Схема данных Amazon · 🎥 Видеодемонстрация


🚀 Быстрый старт

  1. Зарегистрируйтесь на DataDoe и подключите свой аккаунт Amazon Seller Central или Vendor Central.

  2. Создайте API-ключ DataDoe MCP в разделе DataDoe MCP Integrations.

  3. Вставьте приведённую ниже конфигурацию в свой ИИ-клиент (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT или любой инструмент с поддержкой MCP):

    {
      "mcpServers": {
        "datadoe": {
          "url": "https://mcp.datadoe.com/mcp/v1",
          "headers": {
            "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
          }
        }
      }
    }
    
  4. Спросите своего ИИ-агента: «Покажи мои топ-10 ASIN по выручке за прошлый месяц по всем маркетплейсам Amazon».

Вот и всё. DataDoe запускает MCP-сервер на хостинговой инфраструктуре, поэтому вашей команде не нужно ничего разворачивать локально или ждать одобрения разработчика Amazon SP-API.


Что такое DataDoe MCP?

DataDoe MCP — это хостинговый сервер Model Context Protocol (MCP) для продавцов, вендоров и агентств Amazon. Он предоставляет ваши живые данные Amazon Selling Partner API (SP-API) и Amazon Ads API через инструменты MCP, которые работают с Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw и любым другим клиентом с поддержкой MCP.

DataDoe MCP даёт вашему ИИ-агенту два уровня доступа к вашему аккаунту Amazon:

  • Уровень чтения — заказы на уровне SKU, продажи, расходы на рекламу, трафик, запасы, листинги, возвраты, расчёты, аналитика бренда и каталог, возвращаемые в виде структурированных ответов инструментов или загружаемых экспортов CSV и JSON.
  • Уровень записи (Actions) — ваш агент может изменять ваш аккаунт Amazon через SP-API и Amazon Ads API: обновлять листинги, отменять заказы, подтверждать отправки и управлять кампаниями Amazon Ads, группами объявлений, таргетингами и объявлениями.

Создание собственной интеграции с Amazon SP-API обычно требует регистрации разработчика SP-API, потока refresh-токенов OAuth, эндпоинтов для конкретных маркетплейсов, логики троттлинга и 2–4 недель на одобрение Amazon. DataDoe берёт всё это на себя. Вы получаете единый аутентифицированный URL MCP как для чтения, так и для действий с вашими данными Amazon.

DataDoe MCP - Amazon Seller Central, Vendor Central, and Amazon Ads data for AI agents via SP-API

Для кого предназначен DataDoe MCP?

  • Продавцы Amazon (FBA, FBM, мультимаркетплейс) — получайте мгновенные ответы по своим данным продавца, не переключаясь в Seller Central.
  • Агентства Amazon, управляющие несколькими клиентскими аккаунтами — выполняйте запросы по всем подключённым аккаунтам Seller Central / Vendor Central с одного MCP-сервера.
  • Вендоры с Vendor Central — читайте данные 1P наряду с данными 3P с помощью тех же инструментов.
  • Разработчики ИИ и создатели решений — выпускайте ИИ-агентов, дашборды и внутренние инструменты с поддержкой Amazon, не написав собственную интеграцию с SP-API.
  • Операционные команды — автоматизируйте регулярные отчёты через Claude Code, Cursor, n8n или любой инструмент рабочих процессов с поддержкой MCP.

Зачем использовать DataDoe MCP?

  • ✅ Одобрение SP-API не требуется — DataDoe берёт на себя регистрацию разработчика SP-API, OAuth, refresh-токены и лимиты запросов от вашего имени.
  • ✅ Настройка за 30 секунд — вставьте URL MCP и ваш API-ключ в конфигурацию ИИ-клиента. DataDoe запускает сервер на хостинговой инфраструктуре.
  • ✅ Более 20 документированных интеграций из коробки: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, Claude & OpenAI Agent SDK, Excel / Word / PowerPoint через Claude и любой другой клиент с поддержкой MCP.
  • ✅ Детализация до уровня SKU — углубляйтесь в отдельные ASIN, родительские листинги, маркетплейсы, периоды времени, рекламные кампании, отчёты по ключевым словам, расчёты, возвраты.
  • ✅ Мультимаркетплейс, мультиаккаунт — один MCP-сервер охватывает все маркетплейсы Amazon (US, UK, DE, FR, IT, ES, CA, AU, JP, MX и другие) в рамках Seller Central и Vendor Central.
  • ✅ ИИ-ориентированный по дизайну — exports_create принимает SQL-подобные группы фильтров, GROUP BY, агрегации и интервалы дат, поэтому ваш ИИ-агент может строить сложные отчёты за один вызов инструмента.
  • ✅ Один план, одна цена — $97 в месяц с 14-дневным бесплатным пробным периодом. См. цены.
  • ✅ Чтение и запись — с Actions ваш агент не просто отчитывается, а обновляет листинги, управляет заказами и оптимизирует Amazon Ads, с шагом валидации dryRun и управлением по типам.
  • ✅ Постоянно работающая хостинговая инфраструктура — DataDoe управляет лимитами запросов SP-API, ротацией токенов и текущим обслуживанием.

Что можно спросить у DataDoe MCP?

Примеры вопросов, на которые ваш ИИ-агент может ответить с подключённым DataDoe MCP:

  • «Какие мои топ-20 ASIN по выручке за прошлый месяц по всем маркетплейсам Amazon?»
  • «Сверь мои расчёты Amazon с заказами за Q1 и покажи любые расхождения».
  • «Какие кампании Amazon Ads имели ACoS выше 40% на прошлой неделе и каковы были их общие расходы?»
  • «Покажи единицы запасов, которым грозит дефицит в ближайшие 14 дней».
  • «Построй мне ежедневный дашборд KPI с продажами, трафиком и расходами на рекламу за последние 90 дней».
  • «Какие поисковые запросы в моих отчётах PPC принесли больше всего кликов, но ноль конверсий?»
  • «Выгрузи все возвраты Amazon по SKU ABC-123 за последние 60 дней и обобщи причины возвратов».
  • «Сравни долю голоса по поисковым запросам в аналитике бренда месяц к месяцу».

А с включёнными Actions ваш агент может действовать на основе найденного:

  • «Увеличь дневной бюджет моей кампании Sponsored Products с самым высоким ACoS на 20%».
  • «Приостанови все кампании с ACoS выше 50% на прошлой неделе».
  • «Обнови цену SKU ABC-123 до 19.99 и обнови его пункты списка».
  • «Подтверди отправку заказа 123-4567890-1234567 с трекингом UPS 1Z999...»

Actions: запись в Amazon

Actions позволяют вашему ИИ-агенту вносить изменения в подключённые аккаунты Amazon Seller Central, Vendor Central и Amazon Ads через SP-API и Amazon Ads API. Каждое действие записывается и поддаётся аудиту.

Что может делать ваш агент:

  • Листинги — обновлять заголовок, пункты списка, описание, общее ключевое слово, ключевое слово типа товара и изображения (AMAZON_LISTINGS_UPDATE), обновлять цены для аккаунтов Seller Central (AMAZON_LISTINGS_PRICING_UPDATE) и предварительно просматривать запись листинга с помощью соответствующего Action *_VERIFY перед отправкой.
  • Заказы — отменять позицию заказа, подтверждать отправку, покупать доставку, запрашивать отзыв, писать покупателю или искать текущие заказы (AMAZON_ORDERS_FIND) и метрики заказов (AMAZON_ORDERS_GET_METRICS).
  • Vendor Central — подтверждать заказы на закупку, отправлять поставки и получать этикетки, упаковочные листы и статус транзакций.
  • Amazon Ads — добавлять, обновлять, удалять и находить кампании, группы объявлений, таргетинги, объявления, связи объявлений и правила ставок Sponsored Products в рамках Sponsored Products, Brands, Display, TV и Amazon DSP.

Как это работает — агент выполняет каждое Action через следующие инструменты MCP:

  1. actions_details_schema_get — получить схему полезной нагрузки для типа Action.
  2. actions_start с dryRun=true — проверить полезную нагрузку без выполнения.
  3. actions_start — выполнить Action и получить идентификатор действия.
  4. actions_get — опрашивать до завершения, затем прочитать result.

Используйте actions_list для просмотра прошлых Actions (фильтр по статусу, типу, создателю и дате).

Типы Action по умолчанию отключены и включаются по типам в Settings > Actions. Когда тип отключён, actions_start отклоняет реальные запуски, но по-прежнему разрешает валидацию dryRun.

Пример полезной нагрузки details для AMAZON_LISTINGS_UPDATE:

{
  "type": "AMAZON_LISTINGS_UPDATE",
  "sellerOrVendorId": "<SELLER_OR_VENDOR_UUID>",
  "dryRun": true,
  "details": {
    "changes": [
      {
        "sku": "ABC-123",
        "language_tag": "en_US",
        "name": "Stainless Steel Water Bottle 750ml",
        "bulletPoints": ["Keeps drinks cold for 24 hours", "Leak-proof lid"]
      }
    ]
  }
}

Выполнение Action стоит 3 AI Tokens за до 100 изменений плюс 1 AI Token за каждые дополнительные 100 изменений. Полный каталог и схемы полезных нагрузок см. в документации Actions.

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

DataDoe MCP предоставляет вашему ИИ-клиенту следующие инструменты:

ИнструментКатегорияЧто делает
sellers_and_vendors_listАккаунтПеречисляет продавцов и вендоров Amazon, подключённых к вашей организации DataDoe, с типом аккаунта, маркетплейсом и данными подключения.
sellers_and_vendors_getАккаунтВозвращает одного продавца или вендора, включая информацию о том, требует ли подключение повторной авторизации.
sellers_and_vendors_renameАккаунтПереименовывает продавца или вендора. Имена уникальны в пределах организации.
sellers_and_vendors_invitation_createАккаунтСоздаёт одноразовую ссылку для подключения нового аккаунта Amazon или повторного подключения существующего.
sellers_and_vendors_invitations_getАккаунтПеречисляет ожидающие приглашения или возвращает одно приглашение и его статус.
sellers_and_vendors_invitation_revokeАккаунтОтзывает ожидающее приглашение, после чего его ссылку больше нельзя использовать.
organization_and_subscription_details_getАккаунтВозвращает профиль вашей организации DataDoe, план подписки, состояние биллинга и балансы AI Token.
exports_sources_getДанныеИщет по ключевому слову в каталоге DataDoe источников экспорта данных Amazon (заказы, продажи и трафик, эффективность рекламы, запасы, листинги, расчёты, возвраты, бренд-аналитика и другое).
exports_source_getДанныеВозвращает столбцы (с постраничной разбивкой) и метаданные одного источника экспорта, включая информацию о том, требуется ли период дат.
exports_createДанныеСоздаёт экспорт данных Amazon из любого источника. Поддерживает SQL-подобные фильтры, HAVING, GROUP BY, агрегации (sum / avg / count / countDistinct / min / max), интервалы дат (DAY / WEEK / MONTH), постраничную разбивку и вывод в CSV или JSON.
exports_getДанныеВозвращает статус и метаданные выполняемой или завершённой задачи экспорта.
exports_listДанныеПеречисляет задачи экспорта для организации с постраничной разбивкой и необязательными фильтрами по ID экспорта.
exports_raw_url_getДанныеВозвращает URL для скачивания завершённого экспорта, действительный в течение 15 минут после создания экспорта.
exports_raw_downloadДанныеВозвращает необработанное содержимое экспорта (CSV или JSON) непосредственно в ответе инструмента.
exports_deleteДанныеУдаляет экспорт по его ID.
files_createФайлыСоздаёт и загружает служебный файл (изображения листингов, изображения A+, файлы сообщений о заказах) в виде содержимого в кодировке base64.
files_listФайлыПеречисляет служебные файлы организации с постраничной разбивкой и фильтрами.
files_getФайлыВозвращает метаданные служебного файла по id.
files_download_url_getФайлыВозвращает URL для скачивания загруженного файла, действительный в течение 15 минут после создания файла.
files_deleteФайлыУдаляет служебный файл и связанный с ним сохранённый объект, если он есть.
datadoe_user_docs_table_of_contents_getДокументацияВозвращает оглавление пользовательской документации DataDoe, полезное, когда агенту нужно по запросу найти функции или возможности.
datadoe_user_docs_page_getДокументацияВозвращает полное содержимое указанной страницы документации DataDoe.
actions_details_schema_getДействияВозвращает JSON Schema полезной нагрузки details, режим доступа (READ или WRITE), информацию о том, включён ли этот тип Action, и стартовый инструмент.
actions_startДействияЗапускает READ- или WRITE-Action в вашем аккаунте Amazon (листинги, заказы, A+ Content, Multi-Channel Fulfillment, Amazon Ads). Установите dryRun=true для проверки без выполнения. Возвращает id действия.
actions_getДействияВозвращает статус и result действия по id; опрашивайте после actions_start.
actions_listДействияВозвращает историю действий с постраничной разбивкой, с фильтрацией по статусу, типу, создателю и дате.
cogs_upsertCOGSСоздаёт или обновляет строки себестоимости проданных товаров для аккаунта Seller Central.
cogs_deleteCOGSУдаляет строки COGS для аккаунта Seller Central с необязательными фильтрами.
vendor_code_upsertКоды вендораСоздаёт или обновляет строки кодов вендора для аккаунта с подключением Vendor Central.
vendor_code_deleteКоды вендораУдаляет строки кодов вендора для аккаунта с подключением Vendor Central, с необязательными фильтрами.
sqp_asins_getSQPВозвращает список ASIN Search Query Performance (SQP) для аккаунта Seller Central. DataDoe хранит до 252 ASIN.
sqp_asins_addSQPДобавляет до 252 ASIN за вызов в список SQP аккаунта Seller Central.
sqp_asins_removeSQPУдаляет до 252 ASIN за вызов из списка SQP аккаунта Seller Central.
plugins_getПлагиныВозвращает Memories и Skills, сохранённые в организации, а также готовые Files для пользователя.
plugins_memories_createПлагиныСоздаёт плагин памяти для пользователя или организации.
plugins_memories_editПлагиныОбновляет плагин памяти для пользователя или организации.
plugins_memories_deleteПлагиныУдаляет плагин памяти для пользователя или организации.
plugins_skills_getПлагиныВозвращает элемент Skill (SKILL.md или вспомогательный файл), указанный в plugins_get.
plugins_files_getПлагиныВозвращает преобразованное содержимое Markdown для плагина File, указанного в plugins_get.
amc_workflows_findAMCПеречисляет активные рабочие процессы Amazon Marketing Cloud (AMC) с их расписаниями и хешем состояния.
amc_workflows_createAMCСоздаёт рабочий процесс AMC (SQL с необязательными расписаниями Daily или Weekly) без его запуска.
amc_workflows_updateAMCОбновляет SQL и/или расписания рабочего процесса AMC.
amc_workflows_deleteAMCУдаляет рабочий процесс AMC и его расписания.
amc_query_validateAMCВыполняет пробный запуск рабочего процесса, необработанного SQL или шаблона запроса в Amazon без запуска выполнения.
amc_query_startAMCЗапускает запрос AMC по требованию из рабочего процесса, необработанного SQL или шаблона запроса.
amc_query_cancelAMCОтменяет ожидающий или выполняющийся запрос AMC.
amc_query_results_findAMCПеречисляет историю результатов запросов AMC с фильтрами.
amc_query_result_getAMCВозвращает один результат запроса AMC, включая недолговечные URL для скачивания, когда он доступен.
amc_schema_findAMCЧитает актуальную схему AMC: индекс таблиц или поля одного источника данных.
amc_operation_getAMCВозвращает статус асинхронной операции AMC, например изменения рабочего процесса или неопределённого запуска запроса.
amc_query_templates_findAMCПеречисляет готовые шаблоны запросов AMC и, если выбран аккаунт, информацию о том, может ли этот аккаунт запускать каждый из них.
amc_query_template_getAMCВозвращает один шаблон запроса AMC, включая его SQL.
datadoe_support_ticket_createПоддержкаОтправляет запрос в службу поддержки команде DataDoe.
datadoe_support_ticket_checkПоддержкаЧитает запрос в службу поддержки и любой ответ. Опрашивайте примерно раз в час.
datadoe_support_ticket_updateПоддержкаДобавляет дополнительную информацию к существующему запросу в службу поддержки.

Инструменты Amazon Marketing Cloud (AMC) доступны только по запросу и отображаются на живом сервере только после предоставления доступа. См. Amazon Marketing Cloud.


Быстрая настройка для каждого AI-клиента

Приведённые ниже фрагменты — это минимальная конфигурация, которая вам нужна. Пошаговые руководства для каждого AI-клиента см. в списке Руководства по настройке для каждого клиента в конце этого раздела.

Claude.ai · Claude Desktop

Добавьте DataDoe как пользовательский коннектор: откройте Customize > Connectors, нажмите Add и вставьте https://mcp.datadoe.com/mcp/v1 в качестве URL MCP-сервера. Claude входит в DataDoe через OAuth, поэтому API-ключ не нужен. См. Использование Claude.

Claude Code

claude mcp add datadoe "https://mcp.datadoe.com/mcp/v1" --transport http --header "datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>"

Имя сервера и URL должны идти перед --header. Вы также можете опустить --header и войти через OAuth, выполнив /mcp в Claude Code и выбрав Authenticate.

Cursor

Добавьте в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json (для проекта):

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

GitHub Copilot (VS Code)

Добавьте в .vscode/mcp.json (для проекта) или в вашу пользовательскую конфигурацию MCP (MCP: Open User Configuration):

{
  "servers": {
    "datadoe": {
      "type": "http",
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

Codex CLI · Gemini CLI · ChatGPT · n8n · NanoClaw · любой другой MCP-клиент

DataDoe MCP работает как универсальный удалённый MCP-сервер. Настройте ваш клиент с помощью:

  • URL: https://mcp.datadoe.com/mcp/v1
  • Транспорт: HTTP Streamable
  • Заголовок авторизации: datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY> (создайте ключ в DataDoe MCP Integrations)

Руководства по настройке для каждого клиента

Пошаговые руководства по настройке для каждого AI-клиента см. на отдельных страницах документации DataDoe:

Полная документация: www.datadoe.com/hub/docs


Какие данные Amazon доступны?

DataDoe MCP предоставляет доступ ко всем таблицам данных Amazon, доступным в DataDoe, — более 130 таблиц по Seller Central, Vendor Central и Amazon Ads, включая:

  • Заказы и продажи: позиции заказов, эффективность заказов, продажи и трафик, возвраты
  • Amazon Ads: кампании, группы объявлений, ключевые слова, поисковые запросы, sponsored products / brands / display, метрики ACoS / ROAS / доли показов
  • Запасы: запасы FBA, рекомендации по пополнению, зависшие запасы, возраст, единицы под риском
  • Листинги и каталог: каталог ASIN, атрибуты товаров, владение buy box, вариации
  • Финансы: расчёты, комиссии, резервы, возмещения, депозиты
  • Возвраты: возвраты клиентов, причины возвратов, возвраты FBA
  • Бренд-аналитика: эффективность поисковых запросов, рыночная корзина, повторные покупки, демография
  • Трафик: сессии, просмотры страниц, коэффициент конверсии, по ASIN, по маркетплейсу

Полная схема: www.datadoe.com/hub/data-scheme


Чем DataDoe MCP НЕ является

Чтобы избежать путаницы при оценке MCP-серверов для Amazon:

  • ❌ Это не самостоятельно размещаемый MCP-сервер. DataDoe MCP размещён по адресу mcp.datadoe.com. Этот репозиторий GitHub — это фасад схемы, используемый для публикации DataDoe MCP в публичных реестрах MCP (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai и других).
  • ❌ Это не обёртка над SP-API, которую вы обслуживаете сами. DataDoe владеет регистрацией разработчика SP-API, OAuth-потоком, ротацией refresh-токенов, эндпоинтами маркетплейсов и обработкой ограничений скорости. Вы предоставляете свой аккаунт Amazon; остальное мы берём на себя.
  • ❌ Это не бесплатный open-source сервер. DataDoe MCP входит в подписку DataDoe: $97 в месяц, с 14-дневным бесплатным пробным периодом.

Документация и ресурсы


Лицензия

MIT. Фасад схемы DataDoe MCP в этом репозитории является open-source. Размещённый MCP-сервер, приложение DataDoe и инфраструктура DataDoe являются проприетарными и предоставляются DataDoe, Inc.


Как запустить и подключиться локально (для индексации и листинга)

Этот сервер — всего лишь фасад схемы реального MCP-сервера DataDoe, созданный для предоставления DataDoe MCP различным реестрам MCP. Это no-op сервер: он не делает ничего, кроме предоставления схемы DataDoe MCP. Если вы хотите действительно использовать DataDoe MCP, см. документацию DataDoe MCP.

1. Установите зависимости

yarn install

2. Соберите локальный сервер

yarn build

Это компилирует исходный код TypeScript в dist/index.js.

3. Запустите сервер

yarn start

Сервер взаимодействует через stdio, поэтому процесс предназначен для запуска вашим MCP-клиентом, а не для открытия в браузере.

4. Подключение из MCP-клиента

Для локальной настройки укажите в клиенте путь к собранной точке входа. Типичная конфигурация mcp.json выглядит так:

{
  "mcpServers": {
    "datadoe": {
      "command": "node",
      "args": ["/absolute/path/to/datadoe-mcp/dist/index.js"]
    }
  }
}

Если ваш клиент поддерживает пути к рабочей области через переменные окружения, обычно можно заменить абсолютный путь на фактическое расположение клона на вашей машине.


DataDoe — продукт DataDoe, Inc. · datadoe.com