38 lines
1.3 KiB
Markdown
38 lines
1.3 KiB
Markdown
---
|
|
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.
|