Facebook Ads Library MCP

MCP-сервер ищет публичную рекламу брендов в библиотеке рекламы Facebook и разбирает ее картинки и видео

  • 319 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Ходит во внешние сервисы ScrapeCreators и Google Gemini по вашим ключам, кредиты расходуются на вашем аккаунте
  • Скачивает и кэширует картинки и видео объявлений на диск
  • Читает только публичные данные библиотеки рекламы, ваши рекламные кабинеты не затрагивает
Все причины и проверки

proxy-intell/facebook-ads-library-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/facebook-ads-library-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Ходит во внешние сервисы ScrapeCreators и Google Gemini по вашим ключам, кредиты расходуются на вашем аккаунте
  • Скачивает и кэширует картинки и видео объявлений на диск
  • Читает только публичные данные библиотеки рекламы, ваши рекламные кабинеты не затрагивает

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Facebook Ads Library MCP подключает к Claude Desktop или Cursor восемь инструментов для работы с библиотекой рекламы Facebook. `get_meta_platform_id` превращает названия брендов в идентификаторы страниц, `get_meta_ads` забирает их текущие объявления, и оба умеют работать сразу с несколькими брендами. Агента можно спросить, сколько объявлений запускает компания, как они делятся на видео и картинки и какие приемы в них повторяются. Картинки сервер разбирает инструментом `analyze_ad_image`: элементы, текст, цвета и композицию. Видео анализируют `analyze_ad_video` и пакетный `analyze_ad_videos_batch` через Gemini. Результаты кэшируются локально, а управлять кэшем помогают `get_cache_stats`, `search_cached_media` и `cleanup_media_cache`.

Для кого. Для маркетологов и владельцев продуктов, которые разбирают рекламу конкурентов и ищут, какие сообщения и форматы работают в их нише.

Подходит, если

  • Нужно узнать, сколько объявлений сейчас запускает конкурент и в каких форматах
  • Хотите сравнить сообщения нескольких брендов в одной нише одним запросом
  • Нужен разбор видеорекламы: темп, подача, ключевые сообщения
  • Готовите обзор рекламных креативов и ищете повторяющиеся приемы у лидеров рынка
  • Нужно вернуться к уже разобранным объявлениям и найти их по бренду, цвету или типу

Не подходит, если

  • Нужно управлять собственными кампаниями и бюджетами: сервер читает чужую публичную рекламу
  • Нет ключа ScrapeCreators или нельзя тратить его кредиты
  • Нужны точные данные о показах и расходах конкурентов

Пример запроса к агенту

Сколько объявлений сейчас запускает Nike и какое у них соотношение видео и картинок? Разбери три свежих видеоролика

MCP

Транспорт
stdio
Авторизация
API-ключ

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

SCRAPECREATORS_API_KEY обязательная, секрет
Ключ стороннего API ScrapeCreators, через которое сервер получает данные библиотеки рекламы
GEMINI_API_KEY секрет
Ключ Google Gemini для анализа видеорекламы

Ограничения

Данные берутся через платное стороннее API ScrapeCreators, и каждый запрос расходует кредиты на вашем аккаунте. Анализ видео работает только с ключом Google Gemini, а API Google Gemini из России недоступен. Сервер запускается локально, нужны Python 3.12 или новее и клиент Claude Desktop или Cursor. Библиотека рекламы не раскрывает показы и расходы по чужим объявлениям, поэтому таких цифр у сервера нет. Авторы продвигают и размещенную версию Proxy на useproxy.dev, а этот репозиторий описывает самостоятельный запуск под лицензией MIT.

Как отключить. Уберите запись fb_ad_library из claude_desktop_config.json или mcp.json и перезапустите клиент. Папку репозитория вместе с виртуальным окружением и файлом .env можно удалить, кэш медиа очищает `cleanup_media_cache`.

Частые вопросы

Как поставить Facebook Ads Library MCP в Claude Desktop?

Склонируйте репозиторий и запустите install.sh или install.bat. Скрипт создает виртуальное окружение, готовит .env и печатает фрагмент конфигурации для claude_desktop_config.json. Впишите свои ключи и перезапустите Claude Desktop.

Какие ключи нужны для работы?

SCRAPECREATORS_API_KEY обязателен: через него сервер получает данные библиотеки. GEMINI_API_KEY нужен только для анализа видеорекламы.

Что умеет сервер кроме поиска рекламы?

Он анализирует картинки и видео объявлений, разбирает сразу несколько видео одним вызовом, кэширует результаты и позволяет искать по уже разобранным материалам по бренду, цветам, людям или типу медиа.

Есть ли версия без установки?

Авторы предлагают размещенную версию Proxy на useproxy.dev. Она работает без Python и без собственных ключей ScrapeCreators и Gemini. Условия работы и обращения с данными определяет сам сервис.

Чем он отличается от Meta Ads MCP?

Meta Ads MCP работает с вашими рекламными кампаниями, бюджетами и аналитикой. Этот сервер читает публичную библиотеку рекламы и разбирает чужие креативы.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

MCP-сервер для рекламы в Facebook и Instagram: кампании, креативы, бюджеты и аналитика через диалог с агентом

MCP-серверШирокий доступ1,3 тыс.Звезды репозитория
Российский стек

MCP-сервер для VK Реклама с установщиком под ключ: 136 инструментов, поиск сообществ VK и навык для нескольких агентов сразу

MCP-серверШирокий доступ

Instagram MCP

instagram-mcp

Нужен VPN

MCP-сервер для Instagram Graph API: агент публикует посты, карусели и reels, отвечает на комментарии и читает аналитику бизнес-аккаунта

MCP-серверШирокий доступ66Звезды репозитория
Российский стек

MCP-сервер для VK Реклама только на чтение: статистика, структура кампаний, топ объектов по метрикам и выгрузка в CSV

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

MCP-сервер для VK Рекламы: кампании, группы, объявления, статистика и баланс через диалог, подключение кабинета без ручного OAuth

MCP-серверШирокий доступ11Звезды репозитория
Российский стек

MCP-сервер для VK Ads на базе myTarget API v2 с 49-55 инструментами: кампании, ремаркетинг, look-alike, товарные фиды и агентский доступ

MCP-серверШирокий доступ3Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Facebook Ads Library MCP (эта запись)нетAPI-ключ319
Meta Ads MCPдаOAuth1 338работает с вашими рекламными кампаниями, бюджетами и аналитикой через аккаунт Meta
Facebook Ad Library MCPнетне нужна280MCP-сервер ищет рекламу конкурентов в публичной библиотеке рекламы

Коротко о README

Автор показывает примеры запросов для разбора одного бренда и для пакетного сравнения. В репозитории лежат установочные скрипты для трех систем, Dockerfile и манифесты для каталогов MCP.

Бейдж для README

Сообщить о проблеме

Foxx AIFacebook Ads Library MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.