Facebook Ad Library MCP
MCP-сервер ищет рекламу конкурентов в публичной библиотеке рекламы Facebook без аккаунта и токена
- 282 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Запускает безголовый браузер, который скрейпит страницы Facebook, а правила сервиса могут ограничивать автоматический сбор
- Скрипт на вашей машине ходит в сеть, а тексты чужих объявлений попадают в контекст агента
- При частых запросах выдача на время становится пустой
Установка
- Работает в
Ручная установка
claude mcp add facebook-ads -- /abs/path/venv/bin/python /abs/path/facebook_ads_mcp_complete.pyСначала клонируйте репозиторий, создайте окружение, поставьте `pip install -r requirements.txt` и `python -m playwright install chromium`. Пути в команде должны быть абсолютными.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает безголовый браузер, который скрейпит страницы Facebook, а правила сервиса могут ограничивать автоматический сбор
- Скрипт на вашей машине ходит в сеть, а тексты чужих объявлений попадают в контекст агента
- При частых запросах выдача на время становится пустой
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Facebook Ad Library MCP открывает веб-страницу библиотеки рекламы Facebook в безголовом Chromium и разбирает карточки объявлений. Официальный API `ads_archive` отдает без ограничений только политическую рекламу, а остальную лишь для ЕС и Великобритании. Поэтому автор обошелся без API: сервер читает ту же страницу, что видите вы в браузере. Инструментов два. `search_ad_library` ищет по ключевому слову и коду страны, `scrape_ad_library_url` разбирает любую ссылку на библиотеку. По каждому объявлению возвращаются рекламодатель и его страница, дата первого показа, число объявлений с этим креативом, посадочный адрес без обертки `l.facebook.com`, надпись кнопки, подпись под креативом, полный текст и ссылка на миниатюру. К ответу добавляются гистограмма по рекламодателям и исходная разметка страницы в Markdown. Библиотека подгружает карточки при прокрутке, и параметр `scroll_rounds` задает число прокруток: 0 для быстрого первого экрана, 15 и больше для глубокого обхода. Параметр `wait_seconds` управляет ожиданием загрузки, а `advertiser_page_id` открывает вид всех объявлений одной страницы.
Для кого. Для маркетологов и владельцев бизнеса, которые изучают рекламу конкурентов: тексты, кнопки и посадочные страницы.
Подходит, если
- Нужно увидеть, какие объявления сейчас запускает рекламодатель в Мексике, США или другой стране
- Требуется сгруппировать результаты поиска по рекламодателям и выписать посадочные домены
- Известна ссылка на библиотеку рекламы с фильтрами, и ее надо разобрать целиком с глубокой прокруткой
- Нужно оценить масштаб кампании по числу объявлений, использующих один и тот же креатив
- Надо собрать тексты и подписи кнопок для разбора рекламных углов
Не подходит, если
- Нужны бюджеты и показы: Meta публикует их только для политической рекламы и только через API
- Нужно управлять собственными рекламными кампаниями: сервер только читает чужую публичную библиотеку
- Нужна стабильная выгрузка по расписанию: кэша и обработки лимитов нет, при частых запросах приходят пустые ответы
- Нужно скачивать и анализировать сами картинки и видео: возвращается только ссылка на миниатюру
Пример запроса к агенту
Найди в библиотеке рекламы Мексики объявления по запросу «автоматизация с помощью искусственного интеллекта», сгруппируй по рекламодателям и выпиши посадочные доменыMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Сервер разбирает разметку одностраничного приложения Facebook, поэтому смена верстки может сломать извлечение полей. Как запасной вариант всегда возвращается `raw_markdown`. Поле платформ часто приходит пустым: значки Facebook, Instagram и Messenger выводятся иконками, а не текстом.
Кэширования и защиты от лимитов нет. Если запросов слишком много, ответы на время становятся пустыми, тогда нужно подождать и увеличить `wait_seconds`. Facebook отвечает безголовому браузеру кодом 403 и все равно отдает готовые карточки, поэтому успех определяется по числу разобранных карточек, а не по статусу.
Нужны Python 3.10 или новее, пакеты из `requirements.txt` с `crawl4ai` и FastMCP 3 и браузер, который ставится командой `python -m playwright install chromium`. Вид «все объявления страницы» по `advertiser_page_id` тяжелее и не всегда подгружается, надежнее искать по названию рекламодателя.
Как отключить. Выполните `claude mcp remove facebook-ads` или удалите запись `facebook-ads` из `claude_desktop_config.json`, затем перезапустите клиент. Папку репозитория и виртуальное окружение можно удалить вручную.
Частые вопросы
Нужен ли аккаунт Facebook или токен Meta?
Нет. Сервер открывает публичную страницу библиотеки рекламы в безголовом браузере, как это сделали бы вы сами, и не использует ни вход, ни API-токен.
Почему сервер не использует официальный API Meta?
`ads_archive` возвращает по всему миру только политическую и тематическую рекламу, а все типы объявлений отдает лишь для ЕС и Великобритании. Для обычного коммерческого рекламодателя в остальных странах он почти ничего не дает, поэтому автор читает веб-страницу.
Как подключить Facebook Ad Library MCP к Claude Code?
После установки зависимостей выполните `claude mcp add facebook-ads -- /abs/path/venv/bin/python /abs/path/facebook_ads_mcp_complete.py` с абсолютными путями. Для Claude Desktop та же пара `command` и `args` вписывается в `claude_desktop_config.json`. Затем перезапустите клиент.
Что делать, если результаты пришли пустыми?
Увеличьте `wait_seconds`, чтобы страница успела подгрузиться, и сократите частоту запросов. Лимитов и кэша в сервере нет, так что при частых вызовах Facebook перестает отдавать карточки на некоторое время.
Можно ли узнать расходы на рекламу?
Нет. Суммы и показы Meta публикует только для политической рекламы и только через API. Сервер дает креативы, частоту запуска и данные о посадочных страницах, но не бюджеты.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Google Ads, Reddit Ads и GA4: агент читает отчеты и правит кампании, а реальный расход включаете только вы
MCP сервер для Google Ads: разбор кампаний, метрик и ключевых слов через запросы GAQL прямо в диалоге с агентом
Google, Meta Ads и GA4 MCP
Google + Meta Ads + GA4 MCP
Удаленный MCP-сервер для Google Ads, Meta Ads и Google Analytics 4 в одном подключении, вход по OAuth без API-ключей
Восемь read-only MCP-серверов для SEO
seo-tools-mcp
SERP, Wordstat, GSC, GA4, Яндекс Вебмастер, Метрика и A-Parser: восемь read-only MCP-серверов со строгим JSON и мультиаккаунтом для Claude Code
Search Console MCP — данные Google, Bing и GA4 для агента
Search Console MCP
MCP-сервер дает агенту данные Google Search Console, Bing Webmaster, GA4 и AdSense с готовыми SEO-проверками
MCP-сервер для Яндекс Вебмастер API v4.1
Яндекс Вебмастер MCP-сервер
Python MCP-сервер с полным покрытием Яндекс Вебмастер API v4.1: 37 инструментов от диагностики и sitemap до мониторинга важных URL
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Facebook Ad Library MCP (эта запись) | нет | не нужна | 282 | |
| Facebook Ads Library MCP | нет | API-ключ | 319 | ищет рекламу брендов и дополнительно разбирает картинки и видео объявлений |
| Meta Ads MCP | да | OAuth | 1 338 | управляет собственными кампаниями в Facebook и Instagram, а не читает чужую библиотеку |
Коротко о README
В README объяснено, зачем нужен сервер и почему не годится официальный API. Затем идут список полей, установка, регистрация в клиенте, примеры запросов, параметры, схема работы и ограничения.