Russian web search via Yandex Search API plugin
Yandex Search
A Claude Code plugin for the official Yandex Cloud Search API: classic and generative search of the Russian web, plus a dedicated Haiku agent
- 3 ★ on the repository
- Last commit
Extended access
Why this level
- The agent runs skill scripts that call Yandex Cloud Search API through yc CLI
- Requests go from your service account and are paid after the free tier
Install
- Works in
- Services
Manual install
/plugin marketplace add rodion-m/yandex-search-ruInstalls the plugin with its skill and agent together.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent runs skill scripts that call Yandex Cloud Search API through yc CLI
- Requests go from your service account and are paid after the free tier
This is third-party code. Review the repository files before installing.
What it does
The plugin adds a ru-web-search skill with two scripts on top of the Yandex Cloud Search API: classic search returns the top 10 results with titles, links and snippets, and generative search returns an AI-synthesized answer with source links. A separate ru-web-searcher agent on the Haiku model is tuned for Russian-language queries and triggers automatically when the user searches in Russian, asks about .ru domains, or explicitly requests a Yandex search. Access goes through the official Yandex Cloud API rather than browser emulation, requiring a service account with the search-api.webSearch.user role and a configured yc CLI.
Who it is for. For developers who want an official, not workaround, way to search Yandex directly from Claude Code.
Good fit when
- You want official API access to Yandex search with no browser emulation or cookies
- You want not just a link list but an AI-synthesized answer with source links
- You are searching for information better indexed by Yandex than Google: companies, regulations, .ru domains
Not a fit when
- You have no Yandex Cloud account and no wish to set up a service account and yc CLI
- You need search in a language other than Russian: the agent and skill are tuned for Russian queries
Example request
Search Yandex for the latest news on changes to Russia's data protection lawLimitations
You need a Yandex Cloud account with Search API enabled, an installed and configured yc CLI, a service account with the search-api.webSearch.user role, and an authorized key. The Yandex Cloud Search API is paid beyond its free tier. The YC_FOLDER_ID and YC_PROFILE variables need to be set in Claude Code's settings.json or in shell environment variables.
How to disable. Run /plugin uninstall yandex-search-ru in Claude Code.
FAQ
How does generative search differ from classic search?
Classic search returns 10 results with links and snippets, generative search returns an AI-synthesized answer with source links.
Does it need Yandex account cookies?
No, access goes through the official Yandex Cloud Search API with a service account, not a browser.
Discussion
No questions or reviews yet.
Related
All Yandex Search toolsYandex search API skill via Apify
claude-skill-yandex-search-api
An agent skill: the full Yandex SERP as JSON with no official API key, via the Apify Yandex Search Scraper actor
Yandex Search API v2 MCP server
yandex-search-mcp
A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes
Yandex image search skill via Apify
claude-skill-yandex-image-search-api
An agent skill: full-size image URLs from Yandex Images via an Apify actor, with color, size and site filters
Yandex Search MCP via browser automation
yandex-search-mcp
An unofficial Playwright-based MCP server that searches Yandex through a browser with authenticated cookies, extracting and ranking page content for an agent
Yandex search MCP on .NET with AOT compilation
Yandex Search MCP Server (.NET)
A .NET 10 Yandex search MCP server with native AOT compilation, page-to-Markdown conversion and regex search
SerpentSeek search gateway with 39 providers
SerpentSeek
A self-hosted Go search gateway with an MCP search tool: 39 providers, including the official Yandex Search API v2
README in short
The README describes the plugin as Russian web search for Claude Code on the official Yandex Search API, with classic and generative modes and a dedicated Haiku agent. It covers prerequisites (a Yandex Cloud account, yc CLI, a service account with the right role), step-by-step service account and key setup, the YC_FOLDER_ID and YC_PROFILE environment variables, installation via /plugin marketplace add, and a component table: the ru-web-search skill and the ru-web-searcher agent.
README badge
Original SKILL.md
---
name: ru-web-search
description: Russian web search via Yandex Search API. Use when searching for Russian-language content, .ru domains, or information better indexed by Yandex than Google. Triggers on "search in Russian", "find on Yandex", "search Russian sites", or when user explicitly needs Russian web results.
---
# Russian Web Search (Yandex)
Search Russian web using Yandex Search API.
## Scripts
### Classic Search
${CLAUDE_PLUGIN_ROOT}/skills/ru-web-search/scripts/search.sh "query"
Returns top 10 results with titles, URLs, and snippets.
### Generative Search (AI-enhanced with sources)
${CLAUDE_PLUGIN_ROOT}/skills/ru-web-search/scripts/search_generative.sh "query"
Returns an AI-generated answer with source URLs.
## When to Use
- Searching for Russian-language content
- Finding information on .ru domains
- Queries about Russian companies, services, regulations
- User explicitly requests Yandex search