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

API для B2B-лидогенерации из Google Maps и LinkedIn

Находите местный бизнес в Google Maps и ЛПР в LinkedIn, добавляйте и проверяйте их email — через агента по MCP или одним вызовом API.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Google MapsLinkedInWebEmaillovelyjsonitems[0]"name": "Austin Smile Dental""phone": "+1 512 555 0142""website": "austinsmile.com""email": "hello@austinsmile.com""verified": true"rating": 4.8"reviews": 312

Собирайте списки лидов из своего кода или с помощью ИИ-агента. Ищите местный бизнес в Google Maps, находите компании и людей в LinkedIn, извлекайте email и телефоны с их сайтов и проверяйте каждый адрес перед отправкой. Каждый шаг — это инструмент данных: JSON на входе, JSON на выходе и цена за результат, оплата с того же предоплаченного ключа, что и для моделей. Продаёте местному бизнесу? Начните со скрапера лидов из Google Maps. Продаёте компаниям? Начните с LinkedIn для B2B-лидогенерации.

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

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

Build a B2B lead list for me: find businesses on Google Maps and decision makers on LinkedIn, add their emails and verify them. 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 industry, the location, the roles you want and the columns of the CSV>
01

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

010203
  1. Выберите источник

    Для местного бизнеса инструмент Лиды из Google Maps с email за один запуск возвращает места вместе с email, телефонами и ссылками на соцсети, найденными на их сайтах. Для компаний и людей используйте Поиск компаний в LinkedIn, Поиск людей в LinkedIn или Сотрудники компаний в LinkedIn.

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

    Отправьте input инструмента и лимит max_results на POST /v1/tools/{id}/run. Лимит ещё до старта определяет максимальную стоимость запуска.

  3. Обогатите и проверьте

    Отправьте сайты в инструмент Email и контакты с сайта, URL профилей LinkedIn — в поиск email по профилю, а каждый адрес — на проверку email-адресов.

02

Сбор лидов из Google Maps одним запросом

Этот запуск находит стоматологические клиники в Майами, у которых есть сайт, и считывает с каждого сайта контактные данные:

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", "dental clinic"],
      "location": "Miami, FL, USA",
      "maxResults": 100,
      "websiteFilter": "withWebsite"
    },
    "max_results": 100
  }'

В ответе — status запуска, его стоимость в charge_usd и компании в items: каждая — это место из Google Maps с email, телефонами и ссылками на соцсети, найденными на его сайте. websiteFilter оставляет только места withWebsite или, если вы продаёте сайты, только места withoutWebsite. Запуск, который идёт дольше 60 секунд, возвращает 202 и путь poll; цикл опроса показан на странице Запуск инструмента.

Tip

Поиск поблизости находит около 60 мест на один поисковый запрос. Чтобы охватить широкую категорию, передайте в searchTerms несколько близких запросов: результаты объединяются и очищаются от дублей, а max_results действует на все сразу.

03

Пусть список соберёт агент

search_toolsrun_toolget_run

Подключите MCP-сервер к Claude Code:

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

Затем попросите: «Найди стоматологические клиники в Майами, у которых есть сайт. Получи их email, проверь каждый адрес и дай мне CSV с названием, сайтом, email и результатом проверки. Сначала составь план с помощью suggest_tools, задавай max_results в каждом запуске и покажи мне оценку стоимости до начала работы».

04

Инструменты

Google Maps
Лиды из Google Maps с email

Местные компании из Google Maps плюс email, телефоны и ссылки на соцсети с их сайтов. Для сбора списков локальных лидов.

$0.00075 / placeПодробности →
Google Maps
Поиск мест в Google Maps

Поиск местных компаний в Google Maps по ключевому слову и местоположению: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы, координаты.

$0.000238 / place + $0.00075 / callПодробности →
Web
Email и контакты с сайта

Обходит сайты и извлекает email, телефоны и ссылки на соцсети. Один результат = один сайт (обходится до 5 его страниц, контакты объединяются).

$0.015 / website + $0.0015 / callПодробности →
LinkedIn
Поиск компаний в LinkedIn

Поиск компаний в LinkedIn по ключевому слову, местоположению и размеру: название, отрасль, размер, URL.

$0.003 / company + $0.0015 / callПодробности →
LinkedIn
Компании в LinkedIn

Страницы компаний в LinkedIn: описание, отрасль, размер, штаб-квартира, сайт, подписчики.

$0.008 / companyПодробности →
LinkedIn
Сотрудники компаний в LinkedIn

Сотрудники компаний в LinkedIn с фильтрами по должности, местоположению и ключевому слову: имя, заголовок, позиция, URL профиля.

$0.0045 / profile + $0.03 / callПодробности →
LinkedIn
Поиск людей в LinkedIn

Поиск людей в LinkedIn по ключевому слову, местоположению, компании и должности. Один вызов возвращает до 25 кратких профилей.

$0.15 / callПодробности →
LinkedIn
Email по профилю LinkedIn

Рабочий email-адрес по URL профилей LinkedIn.

$0.005 / emailПодробности →
Email
Проверка email-адресов

Проверяет, доставляемы ли email-адреса: синтаксис, домен, MX-записи и статус почтового ящика.

$0.0015 / emailПодробности →
ИнструментОсновные входные данныеЧто возвращается
google-maps-leadssearchTerms, location, radius, websiteFilterКомпании, а также email, телефоны и ссылки на соцсети с их сайтов
google-maps-placessearchTerms, location, minRating, openNowНазвание, адрес, телефон, сайт, рейтинг, число отзывов, часы работы, координаты
website-contactsstartUrls, maxDepth, sameDomainEmail, номера телефонов и ссылки на профили в соцсетях, сведённые по каждому сайту (до 5 страниц на сайт)
linkedin-company-searchsearchQuery, locations, companySizeНазвание, отрасль, размер, URL в LinkedIn
linkedin-companycompanies (URL) или searches (названия)Описание, отрасль, размер, штаб-квартира, сайт, подписчики
linkedin-company-employeescompanies, jobTitles, locationsИмя, заголовок профиля, должность, URL профиля
linkedin-people-searchsearchQuery, locations, currentCompanies, currentJobTitlesДо 25 кратких профилей за вызов
linkedin-email-finderlinkedinUrlsРабочий email для каждого профиля
email-verifyemailsСинтаксис, домен, MX-записи и статус почтового ящика
05

Рецепты

Рестораны с хорошими отзывами, а затем их контакты

Запустите google-maps-places с "minRating": 4.5, затем передайте website каждого места в website-contacts как startUrls с "maxDepth": 1.

Руководители роста в небольших британских финтех-компаниях

Запустите linkedin-company-search с "searchQuery": "fintech", "locations": ["United Kingdom"] и "companySize": ["11-50"]. Передайте URL компаний в linkedin-company-employees с "jobTitles": ["Head of Growth"], а затем URL профилей — в linkedin-email-finder. Пишите «United Kingdom», а не «UK»: LinkedIn может понять «UK» как Украину.

Основатели в одном городе

Один вызов linkedin-people-search с "searchQuery": "founder" и "locations": ["San Francisco"] возвращает до 25 профилей и оплачивается один раз, за вызов.

Обогащение списка названий аккаунтов

Отправьте их в linkedin-company как searches, чтобы получить отрасль, размер, штаб-квартиру и сайт каждой компании.

06

Используйте данные ответственно

Инструменты для лидов возвращают публичную деловую информацию, и часть её — персональные данные: имена, должности, рабочие email. Вы отвечаете за законное использование этих данных, в том числе за наличие правового основания по законам о защите персональных данных, таким как GDPR и CCPA, выполнение запросов людей и отказ от незапрошенных массовых рассылок. Прочитайте Политику допустимого использования, прежде чем собирать список для рассылки.

07

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

У каждого инструмента есть плата за результат, плата за вызов или обе; актуальные цены указаны на карточках выше. Большинство инструментов для лидов берут плату за место, компанию, профиль, сайт или email. Поиск людей оплачивается за вызов, и один вызов возвращает до 25 профилей. При старте запуска резервируется его максимальная стоимость — плата за вызов плюс плата за результат, умноженная на max_results, — а затем списывается сумма за фактически возвращённые результаты. Запуск, завершившийся ошибкой, оплачивает только результаты, полученные до его окончания, поэтому неудачный запуск без результатов ничего не стоит. Подписки нет: вы пополняете один предоплаченный баланс, с которого оплачиваются и модели. См. Цены.

08

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

?
Можно ли получить email из карточек Google Maps?+

Да. Инструмент google-maps-leads находит компании в Google Maps и в том же запуске считывает с их сайтов email, телефоны и ссылки на соцсети. Чтобы обогатить уже имеющиеся у вас места, отправьте их сайты в инструмент website-contacts — он работает как API для обогащения лидов.

Сколько лидов может вернуть один запуск по Google Maps?+

Не больше заданного вами лимита max_results и не более 200 мест за запуск. Поиск поблизости находит около 60 мест на один поисковый запрос, поэтому для охвата широкой категории передавайте несколько близких запросов.

Как проверить, что email-адрес настоящий?+

Запустите на своём списке инструмент email-verify. Он проверяет синтаксис, домен, MX-записи и статус почтового ящика каждого адреса и берёт плату за каждый email.

Может ли мой ИИ-агент сам собрать список лидов?+

Да. Подключите MCP-сервер к Claude Code, Cursor или другому MCP-клиенту, и агент составит план с помощью suggest_tools, прочитает схемы входных данных через get_tool и запустит инструменты через run_tool. Дайте ему API-ключ с лимитом расходов, чтобы запуск, который превысил бы лимит, отклонялся до какого-либо списания.

Законно ли так собирать лиды?+

Это зависит от того, где находитесь вы и люди из вашего списка, и от того, как вы используете данные. Вы отвечаете за законное использование результатов, а Политика допустимого использования перечисляет, для чего инструменты применять нельзя.

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

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

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