wiki/skills/yandex-search/SKILL.md

name, description

name	description
yandex-search	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

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.