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

Список лидов из местных компаний с email из Google Maps

Находите местные компании в Google Maps вместе с email, телефонами и ссылками на соцсети с их сайтов — в JSON, готовом для CRM или таблицы рассылки.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google MapsWebsiteslovelyjsonitems[0]"name": "Bright Smile Dental""category": "Dentist""address": "120 Brickell Ave, Mia…"website": "brightsmile.example""email": "office@brightsmile.ex…"phone": "+1 305 555 0142"

Если вы продаёте местному бизнесу — стоматологиям, спортзалам, ресторанам или подрядчикам, — в Google Maps они уже есть, но email-адрес лежит на собственном сайте каждой компании. Открывать сотни сайтов, чтобы его найти, — именно на этом списки лидов и застревают. Lovely Router делает оба шага. Отправьте тип бизнеса и местоположение, получите по одному JSON-объекту на каждое место с email, телефонами и ссылками на соцсети, найденными на его сайте, и платите за каждое место с предоплаченного баланса. Вызывайте инструмент из скрипта, задачи импорта в CRM или ИИ-агента с одним API-ключом.

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

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

Список лидов из местных компаний с email из Google Maps. 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. Выберите тип бизнеса и район

    Задайте один или несколько поисковых запросов, например dentist, и местоположение, например город. Поиск охватывает примерно radius километров вокруг него.

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

    Отправьте запрос в POST /v1/tools/google-maps-leads/run с maxResults и max_results. Запуск резервирует свою максимальную стоимость на балансе и возвращает места в виде JSON.

  3. Загрузите список

    Отбросьте места без email, уберите дубли по своей CRM и импортируйте остальное. Сохраните название и адрес компании, чтобы менеджеры могли проверить её, прежде чем писать.

02

Список лидов одним запросом

Лиды из Google Maps с email принимают searchTerms и location. Одно место — один результат, а один запуск может вернуть до 200:

curl https://lovelyrouter.com/v1/tools/google-maps-leads/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "searchTerms": ["dentist"],
      "location": "Miami, FL, USA",
      "maxResults": 3,
      "websiteFilter": "withWebsite"
    },
    "max_results": 3
  }'

Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе «Запустить инструмент». websiteFilter оставляет только места с сайтом (withWebsite), только места без сайта (withoutWebsite) или все.

03

Что есть у каждого места

Группа полейЧто вы получаете
КомпанияМестная компания из Google Maps
КонтактыEmail и номера телефонов, найденные на её сайте
СоцсетиСсылки на профили в соцсетях, найденные на её сайте

С withoutWebsite можно найти компании, у которых вообще нет сайта, — если вы делаете сайты, это уже готовый список лидов.

04

Рецепты

Одна профессия в одном городе

Ищите plumber в целевом городе, оставьте места с сайтом и передайте список с email менеджеру по продажам на неделю.

Широкая категория

Передайте несколько запросов в searchTerms, например restaurants, cafe и bakery, и результаты сольются в один набор без дублей. Каждый запрос находит разные места.

Компании без сайта

Задайте websiteFilter равным withoutWebsite и предлагайте им по телефону веб-дизайн или размещение в каталогах.

Новая территория

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

Обогащение и очистка

Перед первой кампанией прогоните адреса через email-verify, чтобы отказы доставки не вредили вашему домену отправки.

Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди 100 стоматологий в Майами с сайтом, сложи название, телефон, email и сайт в CSV и убери места без email. Задай max_results равным 100.»

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

05

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

Местные компании — лишь одна аудитория. Для компаний и людей, а также для проверки собранного:

  • google-maps-places находит места по ключевому слову и местоположению с рейтингом, числом отзывов и часами работы, когда email не нужны.
  • website-contacts обходит любой сайт в поисках email, телефонов и ссылок на соцсети — для лидов из других источников.
  • email-verify проверяет, доставляем ли адрес, до отправки.

Весь процесс целиком описан в сценарии «Генерация лидов».

06

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

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

Список из 300 мест оплачивается как 300 мест. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше указана текущая цена; на странице «Цены» перечислены все инструменты.

07

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

?
Сколько лидов можно получить за один поиск?+

Поиск поблизости возвращает не больше примерно 60 мест на каждый поисковый запрос, а один запуск может вернуть до 200 мест. Чтобы собрать список побольше, используйте несколько запросов или несколько местоположений.

У каждого ли места будет email?+

Нет. Email, телефоны и ссылки на соцсети берутся с собственного сайта компании, поэтому у мест без сайта или без опубликованного адреса их не будет.

Можно ли искать в других странах и на других языках?+

Задайте в location любой город или адрес, а в language — код языка, например en, de, fr, es, ja или zh. Названия и описания мест будут на этом языке.

Чем это отличается от обычного поиска по картам?+

google-maps-places возвращает карточку компании: адрес, телефон, рейтинг и часы работы. Этот инструмент дополнительно собирает email и ссылки на соцсети с сайта компании.

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

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

Строите полный пайплайн? Смотрите генерацию лидов, каталог инструментов и цены.

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

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