Meta Ads MCP

Мета-реклама MCP

Сервер Model Context Protocol (MCP) для взаимодействия с Meta Ads API. Этот инструмент позволяет моделям ИИ получать доступ, анализировать и управлять рекламными кампаниями Meta через стандартизированный интерфейс, что позволяет LLM извлекать данные об эффективности, визуализировать рекламные креативы и предоставлять стратегические идеи для Facebook, Instagram и других платформ Meta.

ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ: Это неофициальный сторонний инструмент, который не связан, не одобрен и не аффилирован с Meta каким-либо образом. Этот проект поддерживается независимо и использует публичные API Meta в соответствии с их условиями обслуживания. Meta, Facebook, Instagram и другие бренды Meta являются товарными знаками своих владельцев.

Скриншот : Использование степени магистра права для оценки эффективности вашей рекламы:

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

1. Зарегистрируйтесь в Pipeboard , чтобы пройти аутентификацию с помощью Meta (в качестве альтернативы вы можете настроить свое собственное приложение Meta )
2. Получите свой токен Pipeboard на pipeboard.co/api-tokens
3. Добавьте эту конфигурацию в свой клиент MCP:

Вот и все! Теперь вы можете использовать Meta Ads MCP в своем любимом клиенте MCP.

Примечание : Если вы предпочитаете использовать собственное приложение Meta Developer вместо аутентификации Pipeboard, см. инструкции в CUSTOM_META_APP.md .

Функции

• Анализ кампаний на основе искусственного интеллекта : позвольте вашему любимому специалисту LLM проанализировать ваши кампании и предоставить полезную информацию об эффективности
• Стратегические рекомендации : получайте основанные на данных предложения по оптимизации расходов на рекламу, таргетинга и креативного контента.
• Автоматизированный мониторинг : попросите любого совместимого с MCP LLM отслеживать показатели производительности и оповещать вас о существенных изменениях.
• Оптимизация бюджета : получите рекомендации по перераспределению бюджета в пользу более эффективных групп объявлений.
• Улучшение креатива : получайте отзывы о рекламном тексте, изображениях и призывах к действию.
• Управление кампаниями : запрос изменений в кампаниях, наборах объявлений и объявлениях (все изменения требуют явного подтверждения)
• Кроссплатформенная интеграция : работает с Facebook, Instagram и всеми рекламными платформами Meta.
• Универсальная поддержка LLM : совместимо с любым клиентом MCP, включая Claude Desktop, Cursor, Cherry Studio и др.
• Простая аутентификация : простая настройка с безопасной аутентификацией OAuth
• Кроссплатформенная поддержка : работает на Windows, macOS и Linux.

Расширенная настройка

Разработка Установка

Если вы вносите свой вклад в проект или хотите управлять им напрямую:

Конфиденциальность и безопасность

Meta Ads MCP следует лучшим практикам безопасности:

1. Токены кэшируются в безопасном месте, привязанном к конкретной платформе:
   • Windows: %APPDATA%\meta-ads-mcp\token_cache.json
   • macOS: ~/Library/Application Support/meta-ads-mcp/token_cache.json
   • Linux: ~/.config/meta-ads-mcp/token_cache.json
2. Вам не нужно указывать свой токен доступа для каждой команды; он будет автоматически извлечен из кэша.

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

Тестирование интерфейса LLM

При использовании Meta Ads MCP с интерфейсом LLM (например, Claude):

1. Убедитесь, что переменная среды PIPEBOARD_API_TOKEN установлена.
2. Проверьте доступ к аккаунту, вызвав mcp_meta_ads_get_ad_accounts
3. Проверьте данные конкретной учетной записи с помощью mcp_meta_ads_get_account_info

Поиск неисправностей

Проблемы с аутентификацией

Если у вас возникли проблемы с аутентификацией:

1. Проверьте настройку Pipeboard:
   • Проверьте правильность настройки PIPEBOARD_API_TOKEN
   • Проверьте свой токен на панели инструментов Pipeboard
   • Попробуйте принудительно выполнить новый вход: python test_pipeboard_auth.py --force-login
2. При использовании интерфейса LLM:
   • Убедитесь, что переменная среды PIPEBOARD_API_TOKEN установлена.
   • Проверьте правильность работы сервера обратного вызова.

Ошибки API

Если вы получаете ошибки от Meta API:

1. Убедитесь, что у пользователя есть соответствующие разрешения на рекламные аккаунты.
2. Проверьте, есть ли ограничения по скорости или другие ограничения
3. Убедитесь, что срок действия вашего токена Pipeboard не истек

Расположение журнала

Файлы журналов хранятся в месте, зависящем от платформы:

• macOS : ~/Library/Application Support/meta-ads-mcp/meta_ads_debug.log
• Windows : %APPDATA%\meta-ads-mcp\meta_ads_debug.log
• Linux : ~/.config/meta-ads-mcp/meta_ads_debug.log

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

Аутентификация Pipeboard

Самый простой способ использования Meta Ads MCP — это аутентификация Pipeboard:

1. Зарегистрируйтесь на Pipeboard.co и сгенерируйте токен API
2. Установите переменную среды:
   export PIPEBOARD_API_TOKEN=your_pipeboard_token
3. Запустите meta-ads-mcp — он выполнит аутентификацию автоматически.

Использование с курсором или Claude Desktop

Добавьте это в ваш claude_desktop_config.json для интеграции с Claude или ~/.cursor/mcp.json для интеграции с Cursor:

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

1. mcp_meta_ads_get_ad_accounts
   • Получите рекламные аккаунты, доступные пользователю
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • user_id : мета-идентификатор пользователя или «я» для текущего пользователя
     • limit : Максимальное количество возвращаемых аккаунтов (по умолчанию: 10)
   • Возвращает: Список доступных рекламных аккаунтов с их данными.
2. mcp_meta_ads_get_account_info
   • Получите подробную информацию о конкретном рекламном аккаунте
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
   • Возвращает: Подробную информацию об указанном счете
3. mcp_meta_ads_get_account_pages
   • Получить страницы, связанные с учетной записью Meta Ads
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX) или «me» для страниц текущего пользователя
   • Возвращает: список страниц, связанных с аккаунтом, полезный для создания и управления рекламой.
4. mcp_meta_ads_get_campaigns
   • Получите кампании для учетной записи Meta Ads с дополнительной фильтрацией
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
     • limit : Максимальное количество возвращаемых кампаний (по умолчанию: 10)
     • status_filter : Фильтр по статусу (пустой для всех или «АКТИВЕН», «ПАУЗА» и т. д.)
   • Возвращает: Список кампаний, соответствующих критериям
5. mcp_meta_ads_get_campaign_details
   • Получите подробную информацию о конкретной кампании
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • campaign_id : идентификатор кампании Meta Ads
   • Возвращает: Подробная информация о указанной кампании
6. mcp_meta_ads_create_campaign
   • Создайте новую кампанию в аккаунте Meta Ads
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
     • name : Название кампании
     • objective : Цель кампании (ОСОЗНАВАНИЕ, ТРАФИК, ВОВЛЕЧЕНИЕ и т. д.)
     • status : Начальный статус кампании (по умолчанию: ПРИОСТАНОВЛЕНО)
     • special_ad_categories : Список специальных категорий объявлений, если применимо
     • daily_budget : Дневной бюджет в валюте счета (в центах)
     • lifetime_budget : Бюджет на весь срок службы в валюте счета (в центах)
   • Возврат: подтверждение с подробностями новой кампании
7. mcp_meta_ads_get_adsets
   • Получите наборы объявлений для учетной записи Meta Ads с дополнительной фильтрацией по кампаниям
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
     • limit : Максимальное количество возвращаемых наборов объявлений (по умолчанию: 10)
     • campaign_id : Необязательный идентификатор кампании для фильтрации
   • Возвращает: Список наборов объявлений, соответствующих критериям
8. mcp_meta_ads_get_adset_details
   • Получите подробную информацию о конкретном наборе объявлений
   • Входные данные:
     • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
     • adset_id : идентификатор набора объявлений Meta Ads
   • Возвращает: Подробную информацию об указанном наборе объявлений.
9. mcp_meta_ads_create_adset
   • Создайте новый набор объявлений в аккаунте Meta Ads
   • Входные данные:
     • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
     • campaign_id : идентификатор кампании Meta Ads, к которой принадлежит этот набор объявлений
     • name : Имя набора объявлений
     • status : Начальный статус набора объявлений (по умолчанию: ПРИОСТАНОВЛЕНО)
     • daily_budget : Ежедневный бюджет в валюте счета (в центах) в виде строки
     • lifetime_budget : бюджет на весь срок службы в валюте счета (в центах) в виде строки
     • targeting : характеристики таргетинга (например, возраст, местоположение, интересы)
     • optimization_goal : Цель оптимизации конверсии (например, «LINK_CLICKS»)
     • billing_event : Как с вас взимаются средства (например, «ПОКАЗЫ»)
     • bid_amount : Сумма ставки в валюте счета (в центах)
     • bid_strategy : стратегия ставок (например, «LOWEST_COST»)
     • start_time , end_time : Необязательное время начала/окончания (ISO 8601)
     • access_token (необязательно): токен доступа Meta API
   • Возврат: подтверждение с подробностями нового набора объявлений
10. mcp_meta_ads_get_ads

• Получайте рекламу для учетной записи Meta Ads с возможностью фильтрации
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
  • limit : Максимальное количество возвращаемых объявлений (по умолчанию: 10)
  • campaign_id : Необязательный идентификатор кампании для фильтрации
  • adset_id : Необязательный идентификатор набора объявлений для фильтрации
• Возвращает: Список объявлений, соответствующих критериям

11. mcp_meta_ads_create_ad

• Создайте новое объявление с существующим креативом
• Входные данные:
  • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
  • name : Название объявления
  • adset_id : идентификатор набора объявлений, в котором будет размещено это объявление
  • creative_id : идентификатор существующего креатива для использования
  • status : начальный статус объявления (по умолчанию: ПРИОСТАНОВЛЕНО)
  • bid_amount : Необязательная сумма ставки (в центах)
  • tracking_specs : Дополнительные характеристики отслеживания
  • access_token (необязательно): токен доступа Meta API
• Возврат: подтверждение с новыми данными объявления

12. mcp_meta_ads_get_ad_details

• Получите подробную информацию о конкретном объявлении
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • ad_id : идентификатор объявления Meta Ads
• Возвращает: Подробную информацию об указанном объявлении

13. mcp_meta_ads_get_ad_creatives

• Получите креативные детали для конкретной рекламы
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • ad_id : идентификатор объявления Meta Ads
• Возвращает: креативные детали, включая текст, изображения и URL-адреса.

14. mcp_meta_ads_create_ad_creative

• Создайте новый рекламный креатив, используя хэш загруженного изображения
• Входные данные:
  • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
  • name : Творческое имя
  • image_hash : хэш загруженного изображения
  • page_id : идентификатор страницы Facebook для рекламы
  • link_url : URL-адрес назначения
  • message : Рекламный текст/копия
  • headline : Заголовок объявления
  • description : Описание объявления
  • call_to_action_type : тип кнопки CTA (например, «УЗНАТЬ_БОЛЬШЕ»)
  • instagram_actor_id : Необязательный идентификатор аккаунта Instagram
  • access_token (необязательно): токен доступа Meta API
• Возврат: подтверждение с новыми творческими подробностями

15. mcp_meta_ads_upload_ad_image

• Загрузите изображение для использования в креативах Meta Ads
• Входные данные:
  • account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)
  • image_path : Путь к файлу изображения для загрузки.
  • name : Необязательное имя для изображения.
  • access_token (необязательно): токен доступа Meta API
• Возвращает: ответ JSON с данными изображения, включая хэш.

16. mcp_meta_ads_get_ad_image

• Получите, загрузите и визуализируйте метарекламное изображение за один шаг
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • ad_id : идентификатор объявления Meta Ads
• Возвращает: рекламное изображение готово к прямому визуальному анализу.

17. mcp_meta_ads_update_ad

• Обновите объявление с новыми настройками
• Входные данные:
  • ad_id : идентификатор объявления Meta Ads
  • status : Обновить статус объявления (АКТИВНО, ПРИОСТАНОВЛЕНО и т. д.)
  • bid_amount : Сумма ставки в валюте счета (в центах для долларов США)
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
• Возврат: подтверждение с обновленными данными объявления и ссылкой для подтверждения.

18. mcp_meta_ads_update_adset

• Обновите набор объявлений, добавив новые настройки, включая ограничения частоты показов.
• Входные данные:
  • adset_id : идентификатор набора объявлений Meta Ads
  • frequency_control_specs : Список спецификаций управления частотой
  • bid_strategy : Стратегия ставок (например, «LOWEST_COST_WITH_BID_CAP»)
  • bid_amount : Сумма ставки в валюте счета (в центах для долларов США)
  • status : обновить статус набора объявлений (АКТИВЕН, ПРИОСТАНОВЛЕН и т. д.)
  • targeting : спецификации таргетинга, включая targeting_automation
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
• Возврат: подтверждение с обновленными данными о наборе объявлений и ссылкой для подтверждения.

19. mcp_meta_ads_get_insights

• Получите представление об эффективности кампании, набора объявлений, объявления или аккаунта
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • object_id : идентификатор кампании, набора объявлений, объявления или аккаунта
  • time_range : временной диапазон для аналитики (по умолчанию: максимальный)
  • breakdown : необязательный параметр разбивки (например, возраст, пол, страна)
  • level : уровень агрегации (объявление, набор объявлений, кампания, аккаунт)
• Возвращает: показатели производительности для указанного объекта.

20. mcp_meta_ads_debug_image_download

• Устранение неполадок при загрузке изображений и предоставление подробной диагностики
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
  • url : Прямой URL-адрес изображения для тестирования (необязательно)
  • ad_id : идентификатор объявления Meta Ads (необязательно, используется, если URL не указан)
• Возвращает: диагностическую информацию о попытках загрузки изображений.

21. mcp_meta_ads_get_login_link

• Получите кликабельную ссылку для входа в систему для аутентификации Meta Ads
• Входные данные:
  • access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)
• Возвращает: интерактивную ссылку на ресурс для метааутентификации.

22. mcp_meta-ads_create_budget_schedule

• Составьте график бюджета для кампании Meta Ads.
• Входные данные:
  • campaign_id : идентификатор кампании Meta Ads.
  • budget_value : Сумма увеличения бюджета.
  • budget_value_type : Тип значения бюджета («АБСОЛЮТНЫЙ» или «МНОЖИТЕЛЬ»).
  • time_start : временная метка Unix, указывающая, когда должен начаться период высокого спроса.
  • time_end : временная метка Unix, указывающая, когда должен закончиться период высокого спроса.
  • access_token (необязательно): токен доступа Meta API.
• Возвращает: строку JSON с идентификатором созданного бюджетного графика или сообщение об ошибке.