ユースケース

ロシア語圏市場向けに Yandex の検索順位を追跡する

Q: どの言語・地域の順位を調べられますか？

language 入力は en、ru、uk、de、fr、tr、be、kk、uz、az、lv、lt、et を受け付け、地域ごとの順位を決めます。

クエリごとの Yandex 検索結果ページを、順位、タイトル、リンク、スニペット、広告つきの JSON で取得。Google が主力でない市場の順位と競合を追えます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで

顧客がロシア語圏の市場にいるなら、Google の順位からわかることはわずかです。Yandex は順位の付け方が違い、表示される競合も異なります。手作業で確認するには、ブラウザ、地域設定、そして大量のコピー＆ペーストが必要です。Lovely Router が検索結果ページを代わりに返します。クエリを送ると、結果ページ 1 つにつき JSON オブジェクトが 1 つ返り、料金はプリペイド残高からページ単位で支払います。順位追跡のスクリプト、レポート用のジョブ、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

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 で返します。
順位を記録する
オーガニック検索結果の中から自社ドメインを探して順位を日付つきで保存し、上位にいるサイトと、表示されている広告を書き留めます。

1 回のリクエストで Yandex の検索結果ページを取得する

Yandex 検索は、query に加えて、読み取る結果ページ数を指定する maxPages（1 ページあたりオーガニック結果は約 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
  }'

maxPages と max_results は同じ値にしてください。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

各結果ページに含まれる情報

フィールドグループ	取得できるもの
Organic results	順位、タイトル、リンク、スニペット
Ads	そのクエリで表示された広告

1 回の実行で最大 10 ページを読み取れます。1 つのクエリで、オーガニック結果は約 100 件になります。

レシピ

週次の順位レポート。

対象の 50 クエリについて 1 ページ目を読み取り、自社ドメインを探して、順位を日付ごとに保存します。クエリごとの変動をグラフにします。

自社より上位のサイトを見つける。

主要なクエリの上位 10 件のリンクを集め、最も頻繁に登場するドメインを数えます。それが Yandex での本当の競合です。

地域と言語を比べる。

1 つのクエリを ru、kk、uk で実行し、地域ごとの順位によって誰が表示されるかがどう変わるかを見ます。

広告を観察する。

購入意向の強いクエリでどの広告主が表示されるか、その文面がどう変わるかを見守ります。

自社のスニペットを点検する。

自社のタイトルとスニペットがどう表示されるかを確認し、スニペットが途中で切れていたり、内容がずれていたりするページを書き直します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「queries.txt にあるクエリをロシア語で Yandex 検索し、それぞれ 1 ページずつ読み取って、mysite.com の順位を教えてください。max_results にはクエリの数を設定してください。」