Отслеживание позиций в Google по ключевым словам и странам
Получайте результаты Google по любому запросу в JSON с позицией, заголовком, URL, сниппетом, датой и похожими запросами, чтобы следить за позициями по странам.
Вы хотите знать, на какой позиции ваша страница по важным ключевым словам в нужной стране и кто стоит выше. Ручная проверка даёт выдачу, подстроенную под ваше местоположение и историю. Lovely Router выполняет поиск за вас. Отправьте ключевое слово и страну, получите по одному JSON-объекту на страницу выдачи и платите за каждую страницу с предоплаченного баланса. Вызывайте инструмент из скрипта, ежедневной задачи или ИИ-агента с одним API-ключом.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Отслеживание позиций в Google по ключевым словам и странам. 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>Как это работает
Составьте список ключевых слов и стран
Одно ключевое слово на строку запуска, с нужным ISO-кодом страны.
hlзадаёт язык.Запустите инструмент с лимитом
Отправьте их с
limitиmax_results. Каждая страница выдачи содержит около 10 ссылок и оплачивается как один результат.Сохраняйте позиции
Сохраняйте позицию своего URL и URL каждого конкурента по каждому ключевому слову и дню и стройте график изменений.
Результаты Google одним запросом
Поиск в Google принимает keyword, country и limit — число результатов на поиск (10, 20, вплоть до all):
curl https://lovelyrouter.com/v1/tools/google-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"keyword": "best espresso grinder",
"limit": "10",
"country": "US"
},
"max_results": 1
}'tbs добавляет фильтр по времени, например за последний день или неделю, а hl задаёт язык интерфейса Google. Если запуск не завершился за 60 секунд, возвращается 202; как опрашивать статус, описано в разделе «Запуск инструмента».
Что содержит каждая страница выдачи
| Группа полей | Что вы получаете |
|---|---|
| Органические результаты | Позиция, заголовок, URL, сниппет и дата |
| Дополнительно | Быстрые ссылки |
| Похожие | Похожие запросы |
Один результат — одна страница выдачи примерно из 10 ссылок, поэтому топ-50 — это 5 результатов. Ограничьте запуск через max_results, максимум 10.
Рецепты
Каждое утро запускайте свои 30 ключевых слов с limit = 10 и сохраняйте позицию своего домена.
Запустите одно и то же ключевое слово с US, GB и DE и посмотрите, где ранжируется ваша страница.
Соберите топ-20 по целевым ключевым словам и посчитайте, какие домены встречаются чаще всего.
Используйте похожие запросы для исходного ключевого слова как следующую партию ключевых слов для отслеживания.
С фильтром tbs за последнюю неделю смотрите, что недавно опубликовано по теме.
Удобнее простыми словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди в Google в США каждое ключевое слово из keywords.txt, определи позицию example.com и перечисли три главных конкурирующих домена по каждому ключевому слову. Задай max_results = 10».
Сочетайте с другими поисковыми источниками
Органическая выдача — лишь один срез. Добавьте:
Страницы выдачи Google по запросу: органические результаты (позиция, заголовок, URL, фрагмент, дата, быстрые ссылки) и похожие запросы. Один результат = одна страница выдачи (~10 ссылок).
Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.
Динамика интереса в Google Trends по времени и регионам для ключевого слова.
google-newsпоказывает новостные результаты по той же теме.google-trendsпоказывает, как интерес к ключевому слову меняется со временем.
Более широкая задача описана в разделах извлечение веб-данных и исследовательские агенты.
Сколько это стоит
Вы платите за каждую страницу: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс плату за страницу, умноженную на max_results, — а затем рассчитывается по фактически возвращённому. Остаток резерва возвращается на баланс. Запуск, завершившийся ошибкой или по тайм-ауту, оплачивает только выданные страницы, а запуск, отклонённый при старте, ничего не стоит.
Отслеживание 30 ключевых слов по 10 результатов оплачивается как 30 страниц в день. Подписки и ежемесячного минимума нет: пополнение от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше — актуальная цена; все инструменты перечислены на странице цен.
Частые вопросы
Сколько результатов можно получить по одному ключевому слову?+
limit может быть 10, 20, 30, 40, 50, 100 или all. Каждые 10 результатов — это одна страница и один оплачиваемый результат, а max_results ограничивает запуск 10 страницами.
Можно ли проверять позиции в других странах?+
Да. Задайте в country код ISO 3166 A-2, например US, GB или DE. hl задаёт язык интерфейса.
+
Да. Органические результаты включают быстрые ссылки, а страница — похожие запросы.
Можно ли ограничиться свежими страницами?+
Да, через tbs: например, за последний день или неделю либо за произвольный период.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Ничего не продлевается автоматически.
Ещё по этой теме: извлечение веб-данных, исследовательские агенты и каталог инструментов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.