Анализ отзывов клиентов о ваших филиалах в Google Maps
Собирайте отзывы о своих филиалах в Google Maps в JSON: текст, звёзды, дата и ответы владельца, сначала новые — чтобы понять, на что жалуются клиенты.
Если у вас сеть ресторанов, клиник или магазинов, у каждой точки свои отзывы в Google Maps, и каждая рассказывает что-то своё: медленное обслуживание в одном филиале, грубый управляющий в другом. Читать их по десяти или пятидесяти точкам каждую неделю человеку не под силу. Lovely Router собирает их. Отправьте ID мест или ссылки, получите по одному JSON-объекту на отзыв и платите за каждый отзыв с предоплаченного баланса. Вызывайте из скрипта, задачи для дашборда или ИИ-агента с одним API-ключом.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Анализ отзывов клиентов о ваших филиалах в 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>Как это работает
Соберите ID своих мест
Используйте ID места каждого филиала — 27-символьный идентификатор, начинающийся с
ChIJилиGhIJ, — или ссылку на место в Google Maps.Запустите инструмент с лимитом
Отправьте их на
POST /v1/tools/google-maps-reviews/runсmaxReviewsиmax_results. ВыберитеreviewsSort, чтобы получать первыми самые новые, самые низкие по оценке или самые релевантные отзывы.Группируйте и читайте
Сгруппируйте отзывы по месту и неделе. Посчитайте низкие оценки, а затем попросите модель кратко изложить, что объединяет жалобы.
Отзывы одним запросом
Инструмент Отзывы Google Maps принимает placeIds или startUrls. maxReviews ограничивает число отзывов на место, а max_results — весь запуск:
curl https://lovelyrouter.com/v1/tools/google-maps-reviews/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"placeIds": ["ChIJN1t_tDeuEmsRUsoyG83frY4"],
"maxReviews": 3,
"reviewsSort": "newest"
},
"max_results": 3
}'Запуск, который идёт дольше 60 секунд, возвращает 202; как опрашивать его, показано на странице Запуск инструмента.
Что содержит каждый отзыв
| Группа полей | Что вы получаете |
|---|---|
| Оценка | Поставленные звёзды |
| Контент | Текст отзыва |
| Время | Дата отзыва |
| Ответ | Ответ владельца, если он есть |
Используйте language, чтобы получать отзывы на выбранном языке. Объедините результат с моделью, чтобы переводить или классифицировать отзывы в той же задаче.
Рецепты
Запускайте каждую точку с reviewsSort, равным newest, оставляйте отзывы с одной или двумя звёздами за последние семь дней и отправляйте их управляющему филиалом.
Отфильтруйте отзывы без ответа владельца и передайте список тому, кто занимается заботой о клиентах.
Соберите по 200 отзывов на точку, попросите модель отметить у каждого тему — время ожидания, персонал, чистота или цена — и сравните филиалы.
Установите reviewsSort в lowestRanking, чтобы увидеть, что написали самые недовольные клиенты, прежде чем читать средние.
Запустите ID места конкурента с lowestRanking, посмотрите, какие жалобы повторяются, и решите, можете ли вы сделать лучше в этих пунктах.
Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Прочитай по 100 самых новых отзывов для каждого ID места из places.txt, отметь всё с одной или двумя звёздами и сгруппируй жалобы по темам. Установи max_results равным 1000».
Сочетайте с другими источниками отзывов и локальных данных
Google Maps — лишь одна из площадок, где говорят клиенты. Другие дополняют картину:
Отзывы о месте в Google Maps (по place ID или URL): текст, звёзды, дата, ответы владельца.
Поиск местных компаний в Google Maps по ключевому слову и местоположению: название, адрес, телефон, сайт, рейтинг, число отзывов, часы работы, координаты.
Отзывы о компании на Trustpilot по домену: звёзды, текст, дата, ответ.
Отзывы об отелях, ресторанах и достопримечательностях на Tripadvisor: рейтинг, заголовок, текст, дата, тип поездки.
google-maps-placesнаходит ID мест и базовые данные о точках, которые вы хотите отслеживать.trustpilot-reviewsчитает отзывы о компании по домену — со звёздами, текстом, датой и ответом.tripadvisor-reviewsохватывает отзывы о ресторанах, отелях и достопримечательностях.
Более широкий процесс описан в разделе мониторинг отзывов.
Сколько это стоит
Вы платите за каждый отзыв: при старте запуска резервируется его максимальная стоимость — плата за вызов плюс плата за отзыв, умноженная на max_results, — а затем списывается сумма за фактически возвращённое. Остаток резерва возвращается на баланс. Запуск, завершившийся ошибкой или по тайм-ауту, оплачивает только доставленные отзывы, а запуск, отклонённый на старте, ничего не стоит.
300 отзывов в неделю оплачиваются как 300 отзывов в неделю. Нет ни подписки, ни ежемесячного минимума: пополнение от $5, и один баланс оплачивает и инструменты, и модели. Актуальная цена указана на карточке выше; на странице Цены перечислены все инструменты.
Частые вопросы
Где найти ID места?+
ID места — это 27-символьная строка, начинающаяся с ChIJ или GhIJ. Вместо него можно передать ссылки на места в Google Maps в startUrls. Найти места поможет google-maps-places.
Сколько отзывов можно получить?+
maxReviews ограничивает число отзывов на место, а один запуск может вернуть в сумме до 500 отзывов через max_results. Если нужно больше, сделайте несколько запусков.
Можно ли получать только самые новые отзывы?+
Да. Установите reviewsSort в newest. Другие варианты — mostRelevant, highestRanking и lowestRanking.
Входит ли ответ владельца?+
Да, ответ владельца входит в данные каждого отзыва, если он есть.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.
Отслеживаете отзывы на разных площадках? См. мониторинг отзывов, каталог инструментов и страницу Цены.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.