generative_search
Generate an answer grounded in web search results, with optional source restrictions (site/host/url).
LABSCO SUMMARY
Search results and keyword demand come out of the same integration, which is what saves you a second one.
The Wordstat half is what distinguishes this: wordstat_get_dynamics returns a phrase's frequency between two dates at daily, weekly or monthly granularity and wordstat_get_regions_distribution splits the same phrase geographically, which is demand data a plain search API does not carry at all. Because devices and regions run through every Wordstat call, wordstat_get_regions_tree is worth calling once up front rather than passing a region ID on trust and reading a distribution that quietly covers the wrong place.
What it is
A Yandex Search API client with 7 tools: web search, image search, a generative answer grounded in search results, and the Wordstat demand tools wordstat_get_top, wordstat_get_dynamics, wordstat_get_regions_distribution and wordstat_get_regions_tree.
What you get
- Web results with the matching passages attached: web_search returns grouped documents carrying URL, title, language and snippet passages, paged through page and docsOnPage, with familyMode, fixTypoMode and searchType as switches you set rather than defaults you cannot see.
- A generated answer kept inside a boundary you draw: generative_search grounds its answer in web search results and accepts a scope restricting sources to a site, host or url, alongside fixMisspell and getPartialResults.
- Demand for a phrase rather than a guess at it: wordstat_get_top returns the popular and related queries around a phrase under numPhrases, narrowed by devices and regions.
- Seasonality read directly rather than inferred: wordstat_get_dynamics returns how a phrase's search frequency moves between fromDate and toDate at a daily, weekly or monthly period.
- Where the demand actually sits: wordstat_get_regions_distribution returns the regions searching a phrase more often, and wordstat_get_regions_tree returns the full tree of Wordstat region IDs and names so a regions filter is chosen rather than guessed at.
- Image search with source and format constraints: image_search takes an imageSpec and a site alongside the query and returns grouped image documents with thumbnail and original links.
Requirements
A Yandex Cloud API key in API_KEY and the folder that key belongs to in FOLDER_ID. Region filters are supplied per call rather than configured once, and wordstat_get_regions_tree is the tool that returns the IDs those filters expect.
Setup effort
One command plus a key — npm install yandex-searchapi-mcp, then supply credentials
USE CASES
01
Sizing demand before committing to a page
See what people actually type around the phrase, whether interest is rising or seasonal, and which regions carry it.
02
Answering a question from sources you control
Restrict the grounding to a site, host or URL you trust, and read the underlying results when the generated answer needs checking.
03
Choosing the right region filter
Pull the region tree first so the IDs are real, then run the distribution and the related-query list against them.
04
Checking how a query is being presented
Read the text results as they come back, then look at what the same query returns in images and from which sites.
7 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
image_search
Search images by text query. Returns grouped image documents and image metadata like thumbnail/original links.
web_search
Search web pages by text query. Returns grouped documents with URL, title, language, and snippet passages.
wordstat_get_dynamics
Get how search frequency changes over time for a keyword (daily, weekly, or monthly).
wordstat_get_regions_distribution
Get regional distribution for a keyword: where users search this phrase more often.
wordstat_get_regions_tree
Get the full tree of Wordstat region IDs and names. Useful for choosing region filters.
wordstat_get_top
Get popular and related search queries for a keyword using Yandex Wordstat.
BEFORE YOU INSTALL
What to know first
Tools you get
7 tools when we connected. Three tools search (web, image, generative); four Wordstat tools report keyword demand. All read. searchType defaults to SEARCH_TYPE_COM.
Requires
- npx on PATH
- FOLDER_ID in your environment
- API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install yandex-searchapi-mcpMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"yandex-searchapi": {
"command": "npx",
"args": [
"-y",
"yandex-searchapi-mcp"
],
"env": {
"FOLDER_ID": "<YOUR_FOLDER_ID>",
"API_KEY": "<YOUR_API_KEY>"
}
}
}
}
