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
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only performs search queries against the public API; there are no write calls
Install
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.
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 districtLimitations
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.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_API_KEY required, secret | Yandex Cloud service account API key |
| YANDEX_FOLDER_ID required | Yandex Cloud folder ID |
Security check
- Only performs search queries against the public API; there are no write calls
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.
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.
Related
CLI, skill and Python library for browser control: the agent clicks, fills forms and reads pages over CDP
A skill that gathers the last 30 days of discussion on a topic from Reddit, X, YouTube, HN, Polymarket and GitHub into one brief
The Chrome DevTools team's official MCP server: the agent drives a live Chrome, reads network and console, and records performance traces
A fast Rust CLI for agent browser automation: accessibility snapshots with element refs, an MCP server and skills