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

Отслеживание позиций в Яндексе на русскоязычном рынке

Выдача Яндекса по запросу в JSON — позиция, заголовок, ссылка, сниппет и реклама. Отслеживайте позиции и конкурентов там, где Google — не главный поисковик.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Yandexlovelyjsonitems[0]"position": 3"title": "Купить кофемолку для …"link": "https://example.com/e…"snippet": "Сравнение моделей и ц…"type": "organic""query": "кофемолка для эспресс…

Если ваши клиенты в русскоязычном интернете, позиции в Google мало что говорят: Яндекс ранжирует иначе и показывает других конкурентов. Проверять выдачу вручную — это браузер, настройка региона и бесконечное копирование. 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>
01

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

010203
  1. Составьте список запросов

    Выпишите запросы, которые вводят ваши клиенты, на том языке, на котором они их вводят: товарные запросы, названия брендов, вопросы.

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

    Отправьте каждый запрос в POST /v1/tools/yandex-search/run вместе с max_results. Запуск резервирует свою максимальную стоимость на балансе и возвращает страницы выдачи в виде JSON.

  3. Фиксируйте позиции

    Найдите свой домен в органической выдаче, сохраните его позицию с датой и отметьте, кто стоит выше вас и какая реклама показывается.

02

Страница выдачи Яндекса одним запросом

Поиск в Яндексе принимает query, maxPages — сколько страниц выдачи читать (около 10 органических результатов на каждой) — и language для региональной выдачи, например ru, en, uk, de, tr или kk:

curl https://lovelyrouter.com/v1/tools/yandex-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "query": "кофемолка для эспрессо",
      "maxPages": 2,
      "language": "ru"
    },
    "max_results": 2
  }'

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

03

Что содержит каждая страница выдачи

Группа полейЧто вы получаете
Органическая выдачаПозиция, заголовок, ссылка и сниппет
РекламаОбъявления, показанные по запросу

Запуск читает до 10 страниц — это около 100 органических результатов по одному запросу.

04

Рецепты

Еженедельный отчёт о позициях

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

Узнайте, кто вас обходит

Соберите топ-10 ссылок по основным запросам и посчитайте, какие домены встречаются чаще всего. Это и есть ваши настоящие конкуренты в Яндексе.

Сравните регионы и языки

Прогоните один запрос с ru, kk и uk, чтобы увидеть, как региональная выдача меняет состав сайтов.

Следите за рекламой

Смотрите, какие рекламодатели появляются по вашим коммерческим запросам и как меняются их объявления.

Проверьте свой сниппет

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

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Поищи в Яндексе на русском запросы из queries.txt, по одной странице на каждый, и скажи, на какой позиции mysite.com по каждому. Установи max_results равным числу запросов».

05

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

Яндекс — лишь одна поисковая система. Сравните его с остальной поисковой картиной:

  • google-search показывает тот же запрос в Google.
  • google-trends показывает динамику интереса к запросу.
  • google-news показывает новостные публикации по теме.

О более широком рабочем процессе см. извлечение веб-данных.

06

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

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

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

07

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

?
Для каких языков и регионов можно снимать позиции?+

Поле language принимает en, ru, uk, de, fr, tr, be, kk, uz, az, lv, lt и et и задаёт региональную выдачу.

Сколько результатов на одной странице?+

Около 10 органических результатов на страницу плюс показанная реклама.

Сколько страниц можно прочитать?+

До 10 за запуск. По умолчанию — 1.

Можно ли проверить позицию своего сайта?+

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

Возвращает ли он выдачу по городу?+

В документации описана только региональная выдача через настройку языка, поэтому на выдачу по отдельным городам лучше не рассчитывать.

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

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

Сравниваете поисковые системы? См. извлечение веб-данных, исследовательских агентов и остальной каталог инструментов.

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

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