AIKraft Agents
ВойтиТарифы и покупка

pipeboard-co/meta-ads-mcp

MCP-сервер для управления рекламой Facebook и Instagram (Meta Ads)

MCP⭐ 1 354Pythonпоследний релиз: 1.0.128
Открыть на GitHub ↗

Что это за инструмент

Это MCP-сервер для управления рекламой в Facebook и Instagram через естественный язык. Он является частью экосистемы Pipeboard, позволяя AI-ассистентам запускать кампании, загружать креативы и анализировать эффективность.

Зачем нужен

Инструмент решает задачу автоматизации рутинных операций в Meta Ads (Facebook, Instagram) с помощью AI. Он полезен маркетологам и разработчикам, так как позволяет управлять бюджетами, таргетингом и отчетностью через диалог, а не через ручной ввод в интерфейсах платформ.

Что можно реализовать

  • Запуск новых рекламных кампаний и групп объявлений через текстовые команды
  • Загрузка изображений и видео для креативов в аккаунты Meta
  • Анализ производительности рекламы и получение инсайтов через запросы на естественном языке
  • Настройка таргетинга по интересам, поведению, демографии и географии
  • Тестирование динамических креативов (dynamic creative testing)

Ключевые возможности

  • Интеграция с Meta Ads API через протокол MCP для работы с AI-ассистентами
  • Единая точка входа для 5 платформ (Meta, Google, TikTok, Snap, Reddit) через Pipeboard
  • Наличие CLI-утилиты для автоматизации через shell-скрипты
  • Поддержка безопасности с явными подтверждениями для записей (write-confirmation)
  • Официальный статус Meta Business Partner для хостинг-сервиса Pipeboard

👤 Кому подойдёт: маркетологи, использующие AI-ассистентов; разработчики, интегрирующие MCP-серверы в свои агенты; специалисты по performance-маркетингу, работающие с несколькими рекламными платформами

Релизы

1.0.128majorbreaking
🕐 1 мес назад · релиз на GitHub ↗

Критическое исправление безопасности: утечка токена Graph API в логи. Обновите версию и смените токен.

  • Breaking: Обновление не очищает старые логи; необходимо вручную удалить meta_ads_debug.log и сменить токен в настройках Facebook.
  • Fixed: Устранена уязвимость GHSA-r3r9-3mrh-x966: токены больше не записываются в открытые файлы логов.
  • Fixed: Логи httpx и httpcore теперь изолированы и не попадают в общий логгер, а чувствительные данные маскируются.
  • Fixed: Уровни доступа к лог-файлам и директориям жестко ограничены (0600/0700), права расширяются только при необходимости.
  • Added: Уровень логирования по умолчанию изменен с DEBUG на INFO; для отладки установите переменную META_ADS_LOG_LEVEL=DEBUG.
1.0.125patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена уязвимость SSRF в обработчике изображений: добавлена проверка ip.is_global и блокировка диапазона 100.64.0.0/10.

  • Fixed: Исправлена уязвимость GHSA-cx77-j6h8-3382 (SSRF) при загрузке изображений на сервере.
  • Fixed: Добавлена проверка ip.is_global и явный список небезопасных сетей, включая 100.64.0.0/10.
  • Fixed: Улучшена защита от обхода: IPv4-адреса в IPv6-формате и редиректы теперь корректно блокируются.
1.0.123patchbreaking
🕐 1 мес назад · релиз на GitHub ↗

Исправление уязвимости: удалён неиспользуемый глобальный кэш изображений креативов и связанные ресурсы MCP.

  • Fixed: Устранена потенциальная уязвимость (GHSA-25fp-988j-w29f) путём удаления мёртвого кода и глобального кэша изображений креативов.
  • Breaking: Удалён файл core/resources.py и регистрация ресурсов meta-ads://, что ломает совместимость с клиентами, читавшими этот путь.
  • Deprecated: Чтение meta-ads://resources больше не поддерживается; для получения данных следует использовать функции get_ad_image и get_ad_creatives.
1.0.122patchbreaking
🕐 1 мес назад · релиз на GitHub ↗

Удалены неработающие инструменты openai_deep_research из-за уязвимости кэширования в многопользовательской среде.

  • Breaking: Удалён модуль openai_deep_research и инструменты search/fetch, так как они не работали и содержали уязвимость.
  • Fixed: Исправлена критическая уязвимость GHSA-j7p8-g5m6-3wv5: кэш записей Meta Ads теперь не доступен другим пользователям в multi-caller среде.
  • Deprecated: Вместо удалённых инструментов рекомендуется использовать типизированные методы: get_ad_accounts, get_campaigns, get_campaign_details, get_adsets, get_ads, get_ad_details.
1.0.121patch
🕐 1 мес назад · релиз на GitHub ↗

Исправлена критическая уязвимость XSS в OAuth-сервере и удалён небезопасный эндпоинт /token.

  • Fixed: Устранена уязвимость XSS в странице ошибок OAuth-сервера и добавлены заголовки безопасности (CSP, nosniff и др.).
  • Fixed: Удалён небезопасный эндпоинт /token, который мог передать код авторизации сторонним скриптам.
  • Fixed: Исправлена ошибка 500, из-за которой код авторизации не сохранялся при успешном входе.
  • Added: Обновлена зависимость mcp[cli] с версии 1.23.0 до 1.28.1.
1.0.120majorbreaking
🕐 2 мес назад · релиз на GitHub ↗

Удалена поддержка PIPEBOARD_API_TOKEN из-за проблем с безопасностью; добавлены альтернативные способы аутентификации.

  • Breaking: Удалена поддержка PIPEBOARD_API_TOKEN: эндпоинт для получения токена Meta удалён из-за нарушения ограничений доступа.
  • Added: Добавлена возможность использования хостингового MCP-сервера для безопасной работы через Pipeboard API token.
  • Added: Поддержка использования собственного токена Meta через переменные META_ACCESS_TOKEN или META_APP_ID.
  • Fixed: Предупреждения теперь выводятся в stderr, чтобы не мешать JSON-RPC каналу при использовании stdio.
1.0.119patch
🕐 3 мес назад · релиз на GitHub ↗

Критическое исправление уязвимости: неавторизованный доступ к инструментам MCP при использовании флага --sse-response.

  • Fixed: Устранена критическая уязвимость (CVSS 9.1), позволявшая выполнять инструменты MCP без аутентификации при запуске с флагом --sse-response.
  • Fixed: Исправлена ошибка привязки middleware: теперь защита от несанкционированного доступа корректно применяется ко всем режимам ответа, включая SSE.
  • Added: Добавлены регрессионные тесты, подтверждающие блокировку неавторизованных запросов как в режиме JSON, так и в режиме --sse-response.
  • Рекомендуется обновиться до версии 1.0.119 и, если использовалась уязвимая конфигурация, сменить токен META_ACCESS_TOKEN.
1.0.117patch
🕐 5 мес назад · релиз на GitHub ↗

Исправлена ошибка Meta (#100) в get_insights: теперь breakdown по platform_position корректно возвращает метрики действий по размещениям.

  • Fixed: get_insights с breakdown=platform_position теперь возвращает поля действий (actions, action_values, conversions, cost_per_action_type) для каждого размещения, включая лиды и CPL.
  • Fixed: Устранена ошибка Meta (#100), возникавшая из-за отсутствия publisher_platform; инструмент теперь автоматически добавляет этот параметр при работе с platform_position.
  • Added: Добавлены регрессионные тесты для проверки корректной работы разбивки по размещениям.