Yandex search MCP server in TypeScript
yandex-search-mcp
A TypeScript MCP server for the Yandex Search API with its own result parser and tests
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- Starts a Node server that calls Yandex Search API with a service account key
- Only runs search queries, there are no modifying calls
Install
- Works in
- Services
Manual install
git clone https://github.com/nikolayxhd/yandex-search-mcp.git
cd yandex-search-mcp
npm installInstall dependencies before connecting to an MCP client.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts a Node server that calls Yandex Search API with a service account key
- Only runs search queries, there are no modifying calls
This is third-party code. Review the repository files before installing.
What it does
The Node.js and TypeScript server calls the Yandex Search API using a service account key and a Yandex Cloud Folder ID, parses the XML response with its own parser, and returns a structured result to the agent. The repo separates the parser, the API client and debug scripts for testing the request and parsing without the MCP wrapper, plus Jest tests for HTML utilities and the parser. The README is very brief: just links to Yandex Cloud docs and a sample MCP client JSON config.
Who it is for. For developers who want a lightweight TypeScript Yandex search server and are comfortable figuring out the config from an example without extensive docs.
Good fit when
- You want a simple Node.js Yandex search server without extra dependencies
- Minimal documentation is fine, and the config is clear from the README example
- You want a ready, tested Yandex Search API XML parser instead of writing your own
Not a fit when
- You need thorough documentation describing tools and parameters
- Active maintenance matters: the last push was over a year ago
Example request
Search Yandex for the latest news about a new residential complex launching in this districtMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_API_KEYrequired, secret- Yandex Cloud service account API key
YANDEX_FOLDER_IDrequired- Yandex Cloud folder ID
Limitations
The last push was over a year ago, and the author has not responded to API changes since. The README does not document the tool set or parameters; you need to read src/index.ts and src/yandex_search_api.ts to understand them. Requires a Yandex Cloud service account key and Folder ID. No license file.
How to disable. Remove the yandex-search-mcp block from your MCP client config.
FAQ
Is the project actively maintained?
No, the last push was over a year ago, and the README has not been updated since either.
Are there tests?
Yes, the test/ directory covers the parser and HTML utilities, and debug/ has separate scripts for manually checking API calls and parsing.
Discussion
No questions or reviews yet.
Related
All Yandex Search toolsYandex 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 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
Yandex's official MCP server for web search via Yandex Search API: results with sources and a generative answer
Yandex and Google search MCP server
web-compass
An MCP web-search and content-extraction server via Yandex and Google on top of SerpAPI, geared toward RU/CIS results
Yandex search MCP server with offline install
MCP Search Server
A search MCP server on the Yandex Cloud Search API with a monitoring dashboard, Brave fallback and an offline bundle for air-gapped networks
Yandex Search.API MCP with Wordstat
Yandex Search.API MCP Server
An MCP server for Yandex's official Search.API: web, image, generative search and four Wordstat tools in one npm package
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex search MCP server in TypeScript (this card) | no | API key | 0 | |
| Yandex Search MCP via browser automation | no | not required | 4 | searches Yandex through a browser with cookies |
| Yandex and Google search MCP server | no | not required | 1 | search through Yandex and Google on SerpAPI |
| Yandex search MCP on .NET with AOT compilation | no | API key | 0 | on .NET with a native AOT build |
README in short
The README is three links to Yandex Cloud docs on the Search API, IAM keys and Folder ID, plus one example MCP server JSON config with a path to src/index.ts and the YANDEX_API_KEY, YANDEX_FOLDER_ID variables. It does not describe tools or parameters.