Amazon Ads MCP Server

Сервер Model Context Protocol (MCP), предоставляющий инструменты для взаимодействия с Amazon Advertising API. Этот сервер позволяет AI-ассистентам получать доступ к кампаниям Amazon Ads, ключевым словам, данным о производительности и управлять ими.

Возможности

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

• get_profiles: Список всех доступных профилей/аккаунтов Amazon Ads

• get_campaigns: Получение рекламных кампаний с возможностью фильтрации по статусу и типу

• get_campaign_performance: Получение метрик производительности кампаний (показы, клики, стоимость, продажи)

• get_keywords: Получение ключевых слов для кампаний или групп объявлений

• update_keyword_bid: Обновление ставок для конкретных ключевых слов

• create_campaign: Создание новых рекламных кампаний

• get_product_ads: Получение рекламных объявлений о товарах для кампаний или групп объявлений

Related MCP server: TikTok Ads MCP Server

Предварительные требования

1. Аккаунт Amazon Ads: Вам нужен активный аккаунт Amazon Ads

2. Учетные данные API: Зарегистрируйтесь для доступа к Amazon Ads API и получите:

   • Client ID

   • Client Secret

   • Refresh Token

Получение учетных данных Amazon Ads API

Шаг 1: Зарегистрируйте свое приложение

1. Перейдите на Amazon Advertising API

2. Войдите в свой аккаунт Amazon Ads

3. Перейдите в Центр разработчика и создайте новое приложение

4. Вы получите Client ID и Client Secret — сохраните их!

Шаг 2: Получите свой Refresh Token

Мы предоставляем вспомогательный скрипт для получения refresh token через поток OAuth:

1. Создайте файл .env в корне проекта:

   AMAZON_ADS_CLIENT_ID=your_client_id_here
   AMAZON_ADS_CLIENT_SECRET=your_client_secret_here

2. Запустите вспомогательный скрипт OAuth:

   npm run get-token

3. Ваш браузер откроет страницу авторизации Amazon

4. Войдите и авторизуйте приложение

5. Скрипт отобразит ваш refresh token — скопируйте его в файл .env

Шаг 3: Определите свой регион

Определите свой рекламный регион:

• NA: Северная Америка (amazon.com)

• EU: Европа (amazon.co.uk, amazon.de и т.д.)

• FE: Дальний Восток (amazon.co.jp и т.д.)

Установка

1. Клонируйте этот репозиторий:

git clone <your-repo-url>
cd amazonads-mcp

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

npm install

3. Соберите проект:

npm run build

Конфигурация

Переменные окружения

Создайте файл .env или задайте следующие переменные окружения:

AMAZON_ADS_CLIENT_ID=your_client_id
AMAZON_ADS_CLIENT_SECRET=your_client_secret
AMAZON_ADS_REFRESH_TOKEN=your_refresh_token
AMAZON_ADS_REGION=NA  # Options: NA, EU, FE
AMAZON_ADS_SANDBOX=false  # Set to true for testing with sandbox API

Конфигурация Claude Desktop

Добавьте этот сервер в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazonads": {
      "command": "node",
      "args": ["/absolute/path/to/amazonads-mcp/build/index.js"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "your_client_id",
        "AMAZON_ADS_CLIENT_SECRET": "your_client_secret",
        "AMAZON_ADS_REFRESH_TOKEN": "your_refresh_token",
        "AMAZON_ADS_REGION": "NA"
      }
    }
  }
}

Примеры использования

После настройки в Claude Desktop вы можете попросить Claude:

• «Покажи все мои кампании Amazon Ads»

• «Каковы метрики производительности для кампании с ID 12345 с 1 по 31 января?»

• «Перечисли все ключевые слова для кампании 12345»

• «Обнови ставку для ключевого слова 67890 до $1.50»

• «Создай новую кампанию Sponsored Products с дневным бюджетом $50»

• «Покажи все рекламные объявления о товарах в кампании 12345»

Разработка

Структура проекта

amazonads-mcp/
├── src/
│   ├── index.ts              # Main MCP server implementation
│   └── amazon-ads-client.ts  # Amazon Ads API client
├── build/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Сборка

npm run build

Режим разработки

Отслеживайте изменения и пересобирайте автоматически:

npm run watch

Тестирование сервера

Запустите сервер напрямую:

npm start

Сервер взаимодействует через stdio и ожидает сообщения протокола MCP.

Покрытие API

Этот сервер в настоящее время поддерживает:

• Sponsored Products: Полная поддержка кампаний, ключевых слов и рекламных объявлений о товарах

• Sponsored Brands: Управление кампаниями (частичная поддержка)

• Sponsored Display: Управление кампаниями (частичная поддержка)

• Отчетность: Базовые метрики производительности (упрощенная реализация)

Важные замечания

1. Ограничение частоты запросов: Amazon Ads API имеет ограничения на частоту запросов. Клиент в настоящее время не реализует логику ограничения частоты запросов.

2. Reporting API: Инструмент get_campaign_performance использует упрощенную реализацию. Для производственного использования следует реализовать полный асинхронный поток отчетности:

   • Создание запроса отчета

   • Опрос о завершении отчета

   • Загрузка и разбор отчета

3. Обработка ошибок: Ошибки API возвращаются вызывающему коду. Убедитесь в правильной настройке учетных данных, чтобы избежать ошибок аутентификации.

4. Регионы: Убедитесь, что вы установили правильный регион (NA, EU, FE) в соответствии с вашим аккаунтом Amazon Ads.

Безопасность

• Никогда не коммитьте файл .env и не раскрывайте учетные данные API

• Refresh token должны храниться в безопасном месте

• Рассмотрите возможность реализации ротации учетных данных для производственного использования

Ресурсы

• Документация Amazon Ads API

• Документация Model Context Protocol

• MCP TypeScript SDK

Лицензия

MIT

Вклад в проект

Вклад приветствуется! Не стесняйтесь отправлять Pull Request.