Карта конкурентов и местного спроса вокруг любой точки
Найдите все компании нужного типа рядом с точкой в Google Maps: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы и координаты в JSON.
Прежде чем открывать второй магазин, выбирать франчайзинговую территорию или решать, где рекламироваться, нужно знать, кто там уже есть: сколько конкурентов, как их оценивают и насколько далеко они друг от друга. Ручной просмотр Google Maps даёт дюжину результатов, а не рынок. Lovely Router возвращает полную картину. Отправьте тип бизнеса и местоположение — получите по одному JSON-объекту на место и платите за каждое место с предоплаченного баланса. Вызывайте из ноутбука, модели выбора локации или ИИ-агента с одним API-ключом.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Карта конкурентов и местного спроса вокруг любой точки. 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>Как это работает
Определите рынок
Укажите тип бизнеса в
searchTerms, а район — вlocation, добавивradiusв километрах, если значение по умолчанию не подходит.Запустите инструмент с лимитом
Отправьте поиск на
POST /v1/tools/google-maps-places/runсmaxResultsиmax_results. Запуск резервирует на балансе свою максимальную стоимость и возвращает места в JSON.Проанализируйте карту
Нанесите координаты на карту, отранжируйте места по рейтингу и числу отзывов и сравните районы. Плотный район со слабыми рейтингами — совсем другая возможность, чем район, где конкурентов мало.
Места одним запросом
Поиск мест в Google Maps принимает searchTerms и location. Одно место — один результат, а один запуск возвращает до 200 мест:
curl https://lovelyrouter.com/v1/tools/google-maps-places/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"searchTerms": ["coffee shop"],
"location": "Austin, Texas, USA",
"maxResults": 10,
"language": "en"
},
"max_results": 10
}'Если запуск длится дольше 60 секунд, возвращается 202; как опрашивать статус, показано в разделе Запустить инструмент. Добавьте minRating (от 2.0 до 4.5 с шагом 0,5), чтобы оставить только места с хорошим рейтингом, или openNow, чтобы оставить только открытые в данный момент.
Что содержит каждое место
| Группа полей | Что вы получаете |
|---|---|
| Идентификация | Название и адрес |
| Контакты | Телефон и сайт |
| Репутация | Средний рейтинг и число отзывов |
| Часы | Часы работы |
| Местоположение | Координаты |
Рецепты
Поищите свою категорию вокруг адреса, посчитайте места и посмотрите на средний рейтинг. Если много мест с рейтингом выше 4.5, у покупателей уже есть хороший выбор.
Запустите поиск без minRating, отсортируйте по возрастанию рейтинга при достаточном числе отзывов и отметьте, где могут быть пробелы в сервисе.
Запустите один и тот же поиск для обоих и сравните число мест и медианные рейтинги, чтобы решить, куда расширяться.
Передайте несколько searchTerms, например restaurants, cafe и fast food. Результаты объединяются в один набор без дубликатов, а один запрос показывает лишь часть рынка.
Выгрузите название, адрес и координаты и стройте по координатам маршруты визитов.
Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди кофейни в Остине, отранжируй их по числу отзывов и назови пять с самым высоким рейтингом и наименьшим числом отзывов. Задай max_results равным 100.»
Сочетайте с другими местными источниками
Карточка места — только начало. Отзывы, другие каталоги и контакты дополняют её:
Поиск местных компаний в Google Maps по ключевому слову и местоположению: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы, координаты.
Отзывы о месте в Google Maps (по place ID или URL): текст, звёзды, дата, ответы владельца.
Местные компании из Google Maps плюс email, телефоны и ссылки на соцсети с их сайтов. Для сбора списков локальных лидов.
Отели, рестораны и достопримечательности Tripadvisor в указанном месте.
google-maps-reviewsчитает, что клиенты пишут о конкретном месте, со звёздами, датами и ответами владельца.google-maps-leadsдобавляет email и ссылки на соцсети с сайта каждой компании — для аутрича.tripadvisor-placesохватывает отели, рестораны и достопримечательности на туристических рынках.
Подробнее о местных данных и данных о путешествиях — в разделе данные о путешествиях и недвижимости.
Сколько это стоит
Вы платите за место: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс плату за место, умноженную на max_results, — а затем списывает только за то, что вернул. Остаток резерва возвращается на баланс. Запуск, завершившийся ошибкой или по тайм-ауту, оплачивает только доставленные места, а запуск, отклонённый на старте, ничего не стоит.
Карта из 150 мест оплачивается как 150 мест. Подписки и ежемесячного минимума нет: пополнение от $5, и один баланс оплачивает и инструменты, и модели. Карточка выше показывает актуальную цену; на странице цен перечислены все инструменты.
Частые вопросы
Сколько мест может вернуть один поиск?+
Поиск поблизости возвращает не больше примерно 60 мест на каждый поисковый запрос. Один запуск может вернуть до 200 мест, поэтому для большой территории используйте несколько запросов или местоположений.
Насколько широка зона поиска?+
Поиск охватывает примерно radius километров вокруг location. Меняйте radius, чтобы расширить или сузить зону.
Можно фильтровать по рейтингу?+
Да. minRating принимает 2.0, 2.5, 3.0, 3.5, 4.0 или 4.5 и оставляет места со средним рейтингом не ниже заданного.
Возвращает ли он email?+
Нет. Этот инструмент возвращает карточку места: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы и координаты. Для email, найденных на сайтах компаний, используйте google-maps-leads.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.
Изучаете больше одного рынка? См. данные о путешествиях и недвижимости, каталог инструментов и цены.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.