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

Ищите баги и запросы функций в отзывах App Store по странам

Получайте отзывы App Store по любому ID приложения и стране в JSON и раскладывайте их на баги, запросы функций и жалобы для дорожной карты продукта.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
App Storelovelyjsonitems[0]"appId": "284882215""country": "de""rating": 2"title": "Login loop after upda…"review": "Stuck on the sign-in …

Очередь поддержки показывает громкие проблемы, а всё остальное — в отзывах App Store: сбой на одной модели iPhone, функция, о которой просят все в одной стране, функция конкурента, которую люди называют по имени. Читать их вручную получается разве что до нескольких десятков. Lovely Router собирает их за вас. Отправьте ID приложения и страну, получите по одному JSON-объекту на отзыв и платите за каждый отзыв с предоплаченного баланса.

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

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

Ищите баги и запросы функций в отзывах App Store по странам. 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. Выберите приложения и страны

    Возьмите ID в App Store из конца URL приложения, без префикса id. Добавьте своё приложение и двух-трёх конкурентов и решите, магазины каких стран для вас важны.

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

    Отправьте ID и страну в POST /v1/tools/app-store-reviews/run. Укажите в maxItems во входных данных и в max_results в теле запроса число отзывов, которое хотите прочитать. Запуск резервирует свою максимальную стоимость на балансе и возвращает отзывы в виде JSON.

  3. Классифицируйте и ранжируйте

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

02

Отзывы App Store одним запросом

Отзывы App Store принимает список ID приложений в appIds и двухбуквенный код магазина в country. maxItems ограничивает число отзывов:

curl https://lovelyrouter.com/v1/tools/app-store-reviews/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "appIds": ["284882215"],
      "country": "us",
      "maxItems": 20
    },
    "max_results": 20
  }'

Запуск, который через 60 секунд ещё не завершился, возвращает 202; как опрашивать его статус, показано в разделе Запуск инструмента. Один запуск вмещает до 500 отзывов.

03

Что содержит каждый отзыв

Группа полейЧто вы получаете
ОтзывОтзыв в том виде, в каком он опубликован в App Store
ПриложениеID приложения, к которому он относится
МагазинМагазин страны, который вы запросили

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

04

Рецепты

Ведите список багов по релизам

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

Сравнивайте страны

Прогоните один и тот же ID приложения с country, равным us, de, jp и br. Запрос функции, который есть только в одном магазине, — это пробел в локализации, а не глобальная потребность.

Читайте однозвёздочные отзывы конкурентов

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

Снабжайте данными поддержку

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

Измеряйте настроение до и после изменения

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

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Получи 200 отзывов App Store о приложении 284882215 в американском магазине, раздели их на баги, запросы функций и похвалу и покажи по пять главных в каждой группе. Установи max_results равным 200».

05

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

Приложение живёт не в одном магазине, и пользователи жалуются не в одном месте:

  • google-play-reviews охватывает Android-версию того же приложения.
  • reddit-search находит длинные обсуждения, где пользователи объясняют, что не так.
  • trustpilot-reviews охватывает отзывы о самой компании, например об оплате и поддержке.
  • g2-reviews добавляет мнения бизнес-покупателей, если ваше приложение продаётся и как ПО.

О более широкой задаче — следить за тем, что говорят клиенты, — см. мониторинг отзывов.

06

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

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

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

07

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

?
Как найти ID приложения?+

Он стоит в конце URL приложения в App Store. Передавайте его без префикса id, как в примере выше.

Можно ли читать отзывы из нескольких стран?+

Да. country принимает один магазин на запрос, поэтому делайте по запуску на страну. Поддерживается длинный список кодов стран, по умолчанию — us.

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

Да. appIds — это список, поэтому можно передать своё приложение и приложения конкурентов в одном запросе. Задавайте maxItems и max_results с учётом общего числа.

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

До 500. Укажите нужное число в maxItems во входных данных.

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

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

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

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

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