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
Plugin

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
All reasons and checks
Russian stack

rodion-m/yandex-search-ru

Install

Works in

Manual install

/plugin marketplace add rodion-m/yandex-search-ru

Installs the plugin with its skill and agent together.

Access and checks

How we review

Extended 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 law

Limitations

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.

Yandex search API skill via Apify

claude-skill-yandex-search-api

Russian stack

An agent skill: the full Yandex SERP as JSON with no official API key, via the Apify Yandex Search Scraper actor

PluginExtended access
Russian stack

A self-hosted MCP for Yandex Search API v2: web, image and generative search across all six Yandex indexes

MCP serverExtended access3Repository stars

Yandex image search skill via Apify

claude-skill-yandex-image-search-api

Russian stack

An agent skill: full-size image URLs from Yandex Images via an Apify actor, with color, size and site filters

PluginExtended access
Russian stack

An unofficial Playwright-based MCP server that searches Yandex through a browser with authenticated cookies, extracting and ranking page content for an agent

MCP serverBroad access4Repository stars
Russian stack

A self-hosted Go search gateway with an MCP search tool: 39 providers, including the official Yandex Search API v2

MCP serverExtended access2Repository stars

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

Report a problem