Facebook Ads Library Mcp
Сервер для поиска и анализа рекламы в библиотеке Facebook Ads: бренды, изображения, видео и сравнение стратегий.
Описание
Это MCP-сервер на Python для работы с публичной библиотекой рекламы Facebook. Позволяет искать активные кампании брендов, анализировать изображения и видео с помощью Gemini AI, сравнивать стратегии компаний. Ключевые особенности: пакетная обработка запросов, умное кэширование для ускорения, мониторинг кредитов API ScrapeCreators, экономия токенов (~88%) при анализе видео. Идеально для маркетологов: анализ тем, креативов, позиционирования в отраслях как спорт, AI или напитки.
Возможности
Пакетная обработка
Одновременный поиск по нескольким брендам и платформам для снижения API-вызовов.
Анализ видео
Пакетный анализ видео с Gemini AI, экономия токенов до 88%, insights по повествованию и брендингу.
Умное кэширование
Кэширование медиа для ускорения, дедупликация запросов, статистика и очистка кэша.
Мониторинг кредитов
Автоматическое обнаружение исчерпания кредитов ScrapeCreators с ссылками на пополнение.
Получение ID платформ
Поиск platform ID по именам брендов, поддержка множественных.
Анализ изображений
Извлечение визуальных элементов, текста, цветов и композиции из адов.
Сравнение стратегий
Батч-анализ кампаний нескольких компаний: объемы, темы, креативы.
Установка
Предварительные требования: Python 3.12+, Anthropic Claude Desktop или Cursor, pip, токен ScrapeCreators (https://scrapecreators.com/?via=tntm), опционально Gemini API ключ (https://aistudio.google.com/app/apikey).
Быстрая установка:
- Клонируйте репозиторий: git clone https://github.com/talknerdytome-labs/facebook-ads-library-mcp.git && cd facebook-ads-library-mcp
- Запустите скрипт: ./install.sh (macOS/Linux) или install.bat (Windows). Это создаст виртуальное окружение, установит зависимости и .env.
- Отредактируйте .env с API-ключами.
- Добавьте конфигурацию в Claude/Cursor: { “mcpServers”: { “fb_ad_library”: { “command”: “{{PATH_TO_PROJECT}}/facebook-ads-library-mcp/venv/bin/python”, “args”: [ “{{PATH_TO_PROJECT}}/facebook-ads-library-mcp/mcp_server.py” ] } } } Замените {{PATH_TO_PROJECT}} на путь к репозиторию. Перезапустите приложение.