Provides tools for managing and analyzing Facebook advertising campaigns, including performance metrics, campaign creation, and creative assessment.
Offers functionality to access, analyze and manage Instagram advertising campaigns through Meta's advertising platform.
Enables access to Meta's advertising APIs, allowing retrieval of ad performance data, campaign management, budget optimization, and viewing ad creatives across Meta platforms.
Сервер Model Context Protocol (MCP) для взаимодействия с Meta Ads API. Этот инструмент позволяет моделям ИИ получать доступ, анализировать и управлять рекламными кампаниями Meta через стандартизированный интерфейс, что позволяет LLM извлекать данные об эффективности, визуализировать рекламные креативы и предоставлять стратегические идеи для Facebook, Instagram и других платформ Meta.
ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ: Это неофициальный сторонний инструмент, который не связан, не одобрен и не аффилирован с Meta каким-либо образом. Этот проект поддерживается независимо и использует публичные API Meta в соответствии с их условиями обслуживания. Meta, Facebook, Instagram и другие бренды Meta являются товарными знаками своих владельцев.
Скриншот : Использование степени магистра права для оценки эффективности вашей рекламы:
При использовании uv не требуется специальной установки. Мы можем использовать uvx для прямого запуска meta-ads-mcp:
Если вы хотите установить пакет:
Для разработки (если вы клонировали репозиторий):
Кроме того, вы можете установить meta-ads-mcp через pip:
После установки вы можете запустить его как:
Перед использованием сервера MCP вам необходимо настроить приложение Meta Developer:
http://localhost:8888/callbackДобавьте это в ваш claude_desktop_config.json для интеграции с Claude или ~/.cursor/mcp.json для интеграции с Cursor:
mcp_meta_ads_get_ad_accountsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)user_id : мета-идентификатор пользователя или «я» для текущего пользователяlimit : Максимальное количество возвращаемых аккаунтов (по умолчанию: 10)mcp_meta_ads_get_account_infoaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)mcp_meta_ads_get_account_pagesaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX) или «me» для страниц текущего пользователяmcp_meta_ads_get_campaignsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)limit : Максимальное количество возвращаемых кампаний (по умолчанию: 10)status_filter : Фильтр по статусу (пустой для всех или «АКТИВЕН», «ПАУЗА» и т. д.)mcp_meta_ads_get_campaign_detailsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)campaign_id : идентификатор кампании Meta Adsmcp_meta_ads_create_campaignaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)name : Название кампанииobjective : Цель кампании (ОСОЗНАВАНИЕ, ТРАФИК, ВОВЛЕЧЕНИЕ и т. д.)status : Начальный статус кампании (по умолчанию: ПРИОСТАНОВЛЕНО)special_ad_categories : Список специальных категорий объявлений, если применимоdaily_budget : Дневной бюджет в валюте счета (в центах)lifetime_budget : Бюджет на весь срок службы в валюте счета (в центах)mcp_meta_ads_get_adsetsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)limit : Максимальное количество возвращаемых наборов объявлений (по умолчанию: 10)campaign_id : Необязательный идентификатор кампании для фильтрацииmcp_meta_ads_get_adset_detailsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)adset_id : идентификатор набора объявлений Meta Adsmcp_meta_ads_create_adsetaccount_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 APImcp_meta_ads_get_adsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)account_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)limit : Максимальное количество возвращаемых объявлений (по умолчанию: 10)campaign_id : Необязательный идентификатор кампании для фильтрацииadset_id : Необязательный идентификатор набора объявлений для фильтрацииmcp_meta_ads_create_adaccount_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)name : Название объявленияadset_id : идентификатор набора объявлений, в котором будет размещено это объявлениеcreative_id : идентификатор существующего креатива для использованияstatus : начальный статус объявления (по умолчанию: ПРИОСТАНОВЛЕНО)bid_amount : Необязательная сумма ставки (в центах)tracking_specs : Дополнительные характеристики отслеживанияaccess_token (необязательно): токен доступа Meta APImcp_meta_ads_get_ad_detailsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)ad_id : идентификатор объявления Meta Adsmcp_meta_ads_get_ad_creativesaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)ad_id : идентификатор объявления Meta Adsmcp_meta_ads_create_ad_creativeaccount_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 : Необязательный идентификатор аккаунта Instagramaccess_token (необязательно): токен доступа Meta APImcp_meta_ads_upload_ad_imageaccount_id : идентификатор учетной записи Meta Ads (формат: act_XXXXXXXXX)image_path : Путь к файлу изображения для загрузки.name : Необязательное имя для изображения.access_token (необязательно): токен доступа Meta APImcp_meta_ads_get_ad_imageaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)ad_id : идентификатор объявления Meta Adsmcp_meta_ads_update_adad_id : идентификатор объявления Meta Adsstatus : Обновить статус объявления (АКТИВНО, ПРИОСТАНОВЛЕНО и т. д.)bid_amount : Сумма ставки в валюте счета (в центах для долларов США)access_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)mcp_meta_ads_update_adsetadset_id : идентификатор набора объявлений Meta Adsfrequency_control_specs : Список спецификаций управления частотойbid_strategy : Стратегия ставок (например, «LOWEST_COST_WITH_BID_CAP»)bid_amount : Сумма ставки в валюте счета (в центах для долларов США)status : обновить статус набора объявлений (АКТИВЕН, ПРИОСТАНОВЛЕН и т. д.)targeting : спецификации таргетинга, включая targeting_automationaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)mcp_meta_ads_get_insightsaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)object_id : идентификатор кампании, набора объявлений, объявления или аккаунтаtime_range : временной диапазон для аналитики (по умолчанию: максимальный)breakdown : необязательный параметр разбивки (например, возраст, пол, страна)level : уровень агрегации (объявление, набор объявлений, кампания, аккаунт)mcp_meta_ads_debug_image_downloadaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)url : Прямой URL-адрес изображения для тестирования (необязательно)ad_id : идентификатор объявления Meta Ads (необязательно, используется, если URL не указан)mcp_meta_ads_get_login_linkaccess_token (необязательно): токен доступа Meta API (если не указан, будет использоваться кэшированный токен)mcp_meta-ads_create_budget_schedulecampaign_id : идентификатор кампании Meta Ads.budget_value : Сумма увеличения бюджета.budget_value_type : Тип значения бюджета («АБСОЛЮТНЫЙ» или «МНОЖИТЕЛЬ»).time_start : временная метка Unix, указывающая, когда должен начаться период высокого спроса.time_end : временная метка Unix, указывающая, когда должен закончиться период высокого спроса.access_token (необязательно): токен доступа Meta API.Meta Ads MCP использует процесс аутентификации Meta OAuth 2.0, разработанный для настольных приложений:
При аутентификации будет выполнено следующее:
Этот метод требует создания приложения Meta Developer, как описано выше.
Meta Ads MCP включает в себя комплексную систему регистрации, помогающую устранять неполадки:
Файлы журналов хранятся в месте, зависящем от платформы:
~/Library/Application Support/meta-ads-mcp/meta_ads_debug.log%APPDATA%\meta-ads-mcp\meta_ads_debug.log~/.config/meta-ads-mcp/meta_ads_debug.logЕсли вы столкнулись с ошибками типа (#200) Provide valid app ID , проверьте следующее:
META_APP_ID : export META_APP_ID=your_app_idmeta-ads-mcp --app-id your_app_idЕсли вы получаете ошибки от Meta API:
Для устранения конкретных проблем с загрузкой изображений используйте встроенный инструмент диагностики:
Это предоставит вам подробную информацию о процессе загрузки и возможных проблемах.
Если вам необходимо использовать разные идентификаторы метаприложений для разных целей:
Meta Ads MCP следует лучшим практикам безопасности:
%APPDATA%\meta-ads-mcp\token_cache.json~/Library/Application Support/meta-ads-mcp/token_cache.json~/.config/meta-ads-mcp/token_cache.jsonMETA_APP_ID вместо передачи ее в качестве аргумента:META_ACCESS_TOKEN . Это обходит как локальный кэш токенов, так и метод аутентификации Pipeboard:Запустите тестовый скрипт для проверки аутентификации и основных функций:
Используйте флаг --force-login для принудительной новой аутентификации, даже если существует кэшированный токен:
При использовании Meta Ads MCP с интерфейсом LLM (например, Claude):
mcp_meta_ads_get_login_linkmcp_meta_ads_get_ad_accountsmcp_meta_ads_get_account_infoЭти функции автоматически выполняют аутентификацию при необходимости и предоставляют кликабельную ссылку для входа в систему, если это необходимо.
Если у вас возникли проблемы с аутентификацией:
mcp_meta_ads_get_login_link для создания новой ссылки аутентификации.--force-login , чтобы получить новый токен: uvx meta-ads-mcp --login --app-id YOUR_APP_ID --force-loginexport META_ACCESS_TOKEN=your_access_tokenЕсли вы получаете ошибки от Meta API:
Вы можете проверить текущую версию пакета:
You must be authenticated.
Сервер протокола контекста модели, который позволяет моделям ИИ получать доступ, анализировать и управлять рекламными метакампаниями, что позволяет магистрам права извлекать данные об эффективности, визуализировать рекламные объявления и предоставлять стратегическую информацию для платформ Facebook и Instagram.