PropellerAds MCP Server

Демократизация программной рекламы с помощью ИИ

Позвольте ИИ-ассистентам, таким как Claude, автоматически управлять вашими рекламными кампаниями на PropellerAds.

Быстрый старт • Доступные инструменты • Примеры использования • Конфигурация MCP

Что это такое?

PropellerAds MCP — это сервер протокола контекста модели (Model Context Protocol), который напрямую подключает ИИ-ассистентов (Claude и любой другой клиент, совместимый с MCP) к API рекламной платформы PropellerAds. Вместо того чтобы вручную заходить в дашборды, выгружать отчеты и переключаться между настройками, вы просто общаетесь со своим ИИ-ассистентом на обычном языке, и он делает всё за вас.

Создавайте кампании, анализируйте эффективность, добавляйте неэффективные зоны в черный список, находите возможности для масштабирования, сравнивайте периоды — всё это в ходе обычного диалога.

Создано для:

• Медиабайеров и performance-маркетологов

• Арбитражников в нишах iGaming и установки приложений

• Growth-хакеров и цифровых агентств

• Всех, кто запускает кампании в PropellerAds и хочет работать быстрее

Функции

• Полный жизненный цикл кампании — Создание, обновление, запуск, остановка и клонирование кампаний, не покидая чат

• Аналитика эффективности в реальном времени — Автоматический расчет показов, кликов, конверсий, CTR, CVR, CPC, CPA и ROI

• Сравнение периодов — Сравнение любых двух диапазонов дат с индикаторами изменений

• Оптимизация на уровне зон — Поиск неэффективных зон, расходующих бюджет, и лучших зон, которые стоит добавить в белый список

• Автоматический черный список — Одна команда для поиска и блокировки плохих зон (с безопасным режимом предварительного просмотра)

• Интеллектуальное масштабирование — Автоматический поиск кампаний с высоким ROI и объемом конверсий, готовых к масштабированию

• Анализ эффективности креативов — Узнайте, какие креативы приносят результат, а какие требуют замены

• Безопасность по дизайну — API-токен хранится в переменных окружения и никогда не раскрывается в диалоге

• Безопасный режим (Dry Run) — Деструктивные операции по умолчанию работают в режиме предварительного просмотра перед выполнением

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

Управление кампаниями

Фильтры для list_campaigns: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (частичное совпадение)

Статистика и аналитика

Общие опциональные параметры: date_from, date_to (ГГГГ-ММ-ДД, по умолчанию последние 7 дней), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)

Оптимизация

Таргетинг

Аккаунт

Технологический стек

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

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

1. Аккаунт PropellerAds с доступом к API

   • Минимальное требование: $1,000 общего расхода или депозита

   • Получите ваш API-токен: https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop или Claude Code (или любой клиент, совместимый с MCP)

Установка

Вариант 1: Установка из PyPI (рекомендуется)

pip install propellerads-mcp

Вариант 2: Установка из исходного кода

git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .

Установка API-токена

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

export PROPELLERADS_API_TOKEN="your_api_token_here"

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

Управление кампаниями

"Show me all my active campaigns sorted by ROI"

"Create a push campaign for gaming offers in Brazil with $100 daily budget"

"Pause all campaigns with negative ROI in the last 7 days"

"Clone my best performing campaign to Mexico, Colombia, and Peru"

Анализ эффективности

"What's my campaign performance for the last week?"

"Compare this week's performance vs last week"

"Show me the top 10 zones by conversions for campaign 12345"

"Which creatives have CTR below 0.5%?"

Рабочие процессы оптимизации

"Find all zones spending over $50 without conversions and blacklist them"

"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"

"Find top performing zones for my dating campaigns and add them to a whitelist"

Ежедневная рутина оптимизации

1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"

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

Claude Desktop

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propellerads": {
      "command": "python",
      "args": ["-m", "propellerads_mcp"],
      "env": {
        "PROPELLERADS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения конфигурации.

Claude Code

Добавьте MCP-сервер в Claude Code через CLI:

claude mcp add propellerads -- python -m propellerads_mcp

Убедитесь, что PROPELLERADS_API_TOKEN задан в переменной окружения вашей оболочки перед запуском Claude Code.

Другие MCP-клиенты

Этот сервер использует stdio transport, стандартный метод связи MCP. Любой клиент, совместимый с MCP, может подключиться, запустив процесс:

python -m propellerads_mcp

Сервер считывает PROPELLERADS_API_TOKEN из окружения. Передайте его через конфигурацию env вашего MCP-клиента или установите в своей оболочке.

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

propellerads-mcp/
├── src/
│   └── propellerads_mcp/
│       ├── __init__.py       # Package init, version, exports
│       ├── __main__.py       # Module entry point (python -m)
│       ├── client.py         # PropellerAds API client (httpx-based)
│       └── server.py         # MCP server, tool definitions & handlers
├── .env.example              # Environment variable template
├── .gitignore
├── LICENSE                   # MIT License
├── pyproject.toml            # Build config, dependencies, metadata
└── README.md

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

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

Мы приветствуем любой вклад! Вот как вы можете помочь:

1. Сделайте форк репозитория

2. Создайте ветку для функции (git checkout -b feature/my-feature)

3. Закоммитьте изменения (git commit -m "Add my feature")

4. Отправьте изменения в свою ветку (git push origin feature/my-feature)

5. Откройте Pull Request

По вопросам багов и предложений по функциям, пожалуйста, откройте issue.

Автор

Ян Нафтанаила — Медиабайер и специалист по ИИ-автоматизации

Создаю инструменты, которые сокращают разрыв между ИИ и программной рекламой. Фокусируюсь на том, чтобы сделать AdTech доступным, автоматизированным и интеллектуальным.

Лицензия

Этот проект лицензирован под лицензией MIT. Подробности см. в файле LICENSE.

PropellerAds MCP — Open source. Создано для сообщества программной рекламы.