Labsco
MCP SERVER

Yandex Search API

by shufl9dka

Search the web and images, get an answer grounded in those results, and read demand for a phrase — by region, by device and over a date range.

Web Search EnginesVerified
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