---
name: yandex-search
description: Search the Russian web using Yandex Search API v2. Use for Russian-language queries, Russian stores (Ozon, Перекрёсток, Яндекс.Маркет), local Russian content, news, prices in rubles. Complements Brave Search for Russian-specific results. Requires YANDEX_API_KEY in ~/.openclaw/.env.
---

# Yandex Search

## Setup

API key in `~/.openclaw/.env` as `YANDEX_API_KEY` (type: Yandex Cloud Api-Key, role: search-api.webSearch.user).

## Usage

```bash
YANDEX_API_KEY=$(grep YANDEX_API_KEY ~/.openclaw/.env | cut -d= -f2) \
  python3 skills/yandex-search/scripts/yandex_search.py "<query>" [<max_results>] [<lang>]
```

- `max_results`: default 5 (max 50)
- `lang`: `ru` (default, SEARCH_TYPE_RU) or `com` (SEARCH_TYPE_COM)

Returns JSON: title, url, domain, snippet.

## How it works

API is **async**: creates operation → polls until done (~2-5 sec). Total latency ~3-7 sec.

## When to use

- Russian stores, prices, products (Ozon, Перекрёсток, ВкусВилл, etc.)
- Russian news, events, local info
- Queries in Russian where Brave returns mostly English results
- Prices in rubles, Russian addresses, phone numbers

## Presenting results

Format as numbered list with title, URL and snippet. Note prices in rubles when visible in snippets.