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

Отслеживайте, какую рекламу конкурент крутит в Google

Получайте объявления конкурента из Google Ads Transparency Center в JSON: формат, текст, даты показа и регионы, чтобы следить за его кампаниями во времени.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google AdsGoogle Searchlovelyjsonitems[0]"advertiser": "Northwind Outdoor""format": "Text""text": "Free shipping on trai…"first_shown": "2026-09-14""last_shown": "2026-10-25""regions": "US, CA"

Конкуренты постоянно меняют рекламу в Google, а единственный публичный источник — Ads Transparency Center, где всё читается по одному рекламодателю и одному объявлению. Дальше беглого взгляда это не масштабируется. Lovely Router читает его за вас. Отправьте ссылку на рекламодателя в Transparency Center — получите по одному JSON-объекту на объявление и платите за каждое объявление с предоплаченного баланса. Вызывайте из скрипта, еженедельного отчёта или ИИ-агента с одним API-ключом.

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

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

Отслеживайте, какую рекламу конкурент крутит в Google. 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. Откройте рекламодателя в Transparency Center

    Найдите конкурента или его домен на adstransparency.google.com, выберите регион и скопируйте URL страницы с результатами. Эта ссылка и будет входными данными.

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

    Отправьте ссылку на POST /v1/tools/google-ads-transparency/run с resultsLimit и max_results. Запуск резервирует на балансе свою максимальную стоимость и возвращает объявления в JSON.

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

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

02

Объявления конкурента одним запросом

Google Ads Transparency принимает список ссылок Transparency Center в startUrls. resultsLimit ограничивает число объявлений, читаемых по одной ссылке, а max_results — весь запуск:

curl https://lovelyrouter.com/v1/tools/google-ads-transparency/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "startUrls": [{"url": "https://adstransparency.google.com/?region=US&domain=nike.com"}],
      "resultsLimit": 3
    },
    "max_results": 3
  }'

Если запуск длится дольше 60 секунд, возвращается 202; как опрашивать статус, показано в разделе Запустить инструмент. Задайте skipDetails равным true для более быстрого запуска, который только прокручивает список: в результат попадут все объявления, но по каждому может быть меньше подробностей.

03

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

Группа полейЧто вы получаете
ФорматФормат объявления (текст, изображение, видео)
СодержаниеТекст объявления
СрокиДаты показа объявления
ОхватРегионы, где оно показывалось

Инструмент читает то, что Transparency Center публикует о рекламодателе. Бюджеты и эффективность он не показывает.

04

Рецепты

Еженедельный отчёт о рекламе конкурентов

Каждый понедельник запускайте инструмент для трёх ближайших конкурентов. Сравнивайте с прошлой неделей и отправляйте в маркетинговый канал короткий список новых и остановленных объявлений.

Заметьте запуск кампании

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

Сравните посылы по регионам

Запустите того же рекламодателя, поменяв регион в ссылке, и посмотрите, какие предложения идут на каких рынках.

Соберите коллекцию примеров

Соберите тексты всех объявлений конкурента по линейке продуктов, затем попросите модель сгруппировать их по подходу: цена, скорость, доверие, функции.

Проверьте нового игрока на рынке

Когда в поисковой выдаче появляется новый соперник, вставьте его домен в Transparency Center, запустите инструмент и посмотрите, как давно и в каких регионах он рекламируется.

Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Прочитай объявления по этой ссылке Transparency Center, сгруппируй их по посылу и скажи, какие появились за последние 30 дней. Задай max_results равным 100.»

05

Сочетайте с другими источниками о рекламе

Google — лишь один канал. Конкуренты обычно закупают рекламу в нескольких, а для контекста пригодится трафик их сайта:

  • facebook-ads возвращает объявления из библиотеки рекламы Meta с креативом, текстом, датой начала и рекламодателем.
  • linkedin-ads возвращает объявления из библиотеки рекламы LinkedIn с текстом, форматом и датами — полезно для B2B-конкурентов.
  • website-traffic показывает оценку посещений и источники трафика, чтобы понять, сопровождается ли рекламная активность ростом.
  • google-search показывает органические результаты и объявления, которые пользователь видит по ключевому слову.

Общая картина — в разделе аналитика рекламы.

06

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

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

Чтение 200 объявлений в неделю оплачивается как 200 объявлений в неделю. Подписки и ежемесячного минимума нет: пополнение от $5, и один баланс оплачивает и инструменты, и модели. Карточка выше показывает актуальную цену; на странице цен перечислены все инструменты.

07

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

?
Как найти ссылку для startUrls?+

Откройте Google Ads Transparency Center, найдите рекламодателя или его домен и скопируйте адрес страницы с результатами. Каждая ссылка должна начинаться с https://adstransparency.google.com/.

Сколько объявлений может вернуть один запуск?+

max_results может быть до 500 объявлений. resultsLimit ограничивает число объявлений на одну ссылку, поэтому при нескольких ссылках общий итог ограничен max_results.

Можно узнать, сколько тратит конкурент?+

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

Что делает skipDetails?+

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

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

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

Сравниваете рекламу в разных каналах? См. аналитику рекламы, каталог инструментов и страницу цен.

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

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