Сценарий использования

Исследуйте рекламу конкурентов в Facebook через библиотеку рекламы Meta

Получайте объявления из библиотеки рекламы Meta в JSON с креативом, текстом, датой запуска и рекламодателем: что крутят конкуренты и что держат долго.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
FacebookMeta Ad Librarylovelyjsonitems[0]"advertiser": "Northpeak Coffee""copy": "Fresh roasted, shippe…"start_date": "2026-09-14""creative": "video""search": "coffee""country": "US"

Вы хотите знать, что рекламируют конкуренты, какие подходы они тестируют и за какие объявления продолжают платить. Ответ есть в библиотеке рекламы Meta, но это страница, которую приходится листать вручную, по одному поиску за раз. Lovely Router читает её за вас. Отправьте URL поиска в библиотеке рекламы или URL страницы, получите по одному JSON-объекту на объявление и платите за каждое объявление с предоплаченного баланса. Вызывайте его из скрипта, еженедельного отчёта или ИИ-агента с одним API-ключом.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Исследуйте рекламу конкурентов в Facebook через библиотеку рекламы Meta. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

Как это работает

010203
  1. Соберите URL поиска

    Откройте библиотеку рекламы, выберите страну и ключевое слово или конкурента и скопируйте адрес из браузера. URL страницы тоже подойдёт.

  2. Запустите инструмент с лимитом

    Отправьте URL в urls на POST /v1/tools/facebook-ads/run вместе с count и max_results. Запуск резервирует максимальную стоимость на вашем балансе и возвращает объявления в JSON.

  3. Сохраняйте и сравнивайте

    Сохраняйте каждый запуск с датой. Новые объявления — это новые тесты; объявления со старой датой запуска — те, что продолжают крутиться.

02

Реклама конкурентов одним запросом

Поиск в библиотеке рекламы Facebook принимает в urls URL поиска в библиотеке рекламы или URL страниц. count ограничивает общее число объявлений, а limitPerSource — число объявлений на один URL:

curl https://lovelyrouter.com/v1/tools/facebook-ads/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "urls": [
        {
          "url": "https://www.facebook.com/ads/library/?active_status=all&ad_type=all&country=US&q=coffee"
        }
      ],
      "count": 10
    },
    "max_results": 10
  }'

Запуск возвращает объявления, которые библиотека показывает по этому URL. Запуск, который идёт дольше 60 секунд, возвращает 202; как опрашивать результат, описано в разделе Запуск инструмента.

03

Что содержит каждое объявление

Группа полейЧто вы получаете
КреативКреатив объявления
ТекстТекст объявления
ВремяДата запуска объявления
РекламодательКто размещает объявление

Текст приходит на том языке, который использовал рекламодатель. В той же задаче попросите модель перевести его, пометить каждое объявление по подходу (цена, социальное доказательство, срочность) или сгруппировать почти одинаковые.

04

Рецепты

Карта сообщений конкурента

Передайте URL страницы конкурента, соберите его объявления и попросите модель пометить каждое по офферу и подходу. Повторяйте ежемесячно, чтобы видеть сдвиги.

Найдите долгоиграющие объявления

Сравните даты запуска в двух запусках. Объявление, которому уже несколько месяцев и которое всё ещё в списке, скорее всего, работает.

Срез ключевого слова по рынку

Найдите в библиотеке свою категорию в одной стране, а затем прочитайте тексты первых 200 объявлений, чтобы понять типичные обещания.

Бриф для креативной команды

Соберите 50 объявлений по ключевому слову, передайте тексты и типы креативов копирайтеру и попросите три подхода, которые никто не использует.

Сравнение стран

Запустите одно и то же ключевое слово с разными значениями country в URL поиска и посмотрите, какие офферы меняются от рынка к рынку.

Удобнее простыми словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Возьми 100 последних объявлений по запросу „running shoes“ в США из библиотеки рекламы, сгруппируй их по рекламодателям и выведи по три самые частые фразы для каждого. Установи max_results равным 100».

05

Дополните другими источниками рекламы

Facebook — лишь одно из мест, где рекламируется конкурент. Добавьте остальные:

  • google-ads-transparency показывает объявления рекламодателя в Google.
  • linkedin-ads решает ту же задачу для B2B-рекламодателей в LinkedIn.
  • facebook-posts показывает органические публикации конкурента рядом с платными.
  • instagram-posts добавляет ленту конкурента в Instagram.

Весь процесс по всем рекламным сетям описан в разделе аналитика рекламы.

06

Сколько это стоит

Вы платите за каждое объявление: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену объявления, умноженную на max_results, — и списывает оплату за то, что вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только полученные объявления, а запуск, отклонённый на старте, ничего не стоит.

Чтение 100 объявлений в неделю тарифицируется как 100 объявлений в неделю. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает инструменты и модели. Актуальная цена — на карточке выше; на странице цен перечислены все инструменты.

07

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

?
Можно ли искать в библиотеке рекламы по ключевому слову?+

Да. Укажите ключевое слово в параметре q URL поиска в библиотеке рекламы, выберите страну в том же URL и передайте его в urls.

Как ограничить число объявлений?+

Задайте во входных данных count для общего числа, limitPerSource — для каждого URL, а в запросе — max_results как лимит запуска. Результат содержит не больше этого числа объявлений.

Можно ли получить объявления одной компании?+

Передайте URL страницы компании в Facebook в urls. Инструмент принимает URL поиска или URL страниц.

Нужен ли аккаунт в Facebook?+

Нет. Вы отправляете URL и API-ключ.

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные объявления, и ничего не продлевается автоматически.

Отслеживаете не только Facebook? Смотрите аналитику рекламы, мониторинг соцсетей и каталог инструментов.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.