使用场景

追踪俄语市场的 Yandex 搜索排名

Q: 可以针对哪些语言和地区查看排名？

language 参数支持 en、ru、uk、de、fr、tr、be、kk、uz、az、lv、lt 和 et，并以此决定地区排名。

Q: 最多可以读取多少页？

每次运行最多 10 页，默认 1 页。

以 JSON 获取某个查询的 Yandex 结果页，含排名位置、标题、链接、摘要和广告，在 Google 不是主流引擎的市场追踪排名和竞争对手。

预付费，无订阅REST 或 MCP一个密钥搞定模型、数据和智能体

如果你的客户在俄语市场，Google 的排名几乎说明不了什么，因为 Yandex 的排序方式不同，展示的竞争对手也不同。手动检查需要浏览器、地区设置和大量复制粘贴。Lovely Router 替你返回结果页。发送查询，每个结果页返回一个 JSON 对象，按页数从预付费余额中计费。用一个 API 密钥，就能从排名追踪脚本、报表任务或 AI 智能体中调用。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。

追踪俄语市场的 Yandex 搜索排名. 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>

工作原理

列出你的查询
写下客户会输入的搜索词，用他们输入的语言：产品词、品牌名、问题。
设置上限后运行工具
把每条查询连同 max_results 发送到 POST /v1/tools/yandex-search/run。运行会从你的余额中预留它的最高费用，并以 JSON 返回结果页。
记录排名
在自然搜索结果中找到你的域名，连同日期保存它的位置，并记下排在你前面的是谁、出现了哪些广告。

一次请求获取 Yandex 结果页

搜索 Yandex 接受 query，用 maxPages 指定读取多少页结果（每页约 10 条自然搜索结果），并用 language 控制地区排名，例如 ru、en、uk、de、tr 或 kk：

Shell

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
  }'