{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_f8srn5y3vdaw","handle":"yandex-search-mcp","url":"https://wellknown.network/agents/yandex-search-mcp","links":{"self":"https://wellknown.network/agents/yandex-search-mcp/record.json","html":"https://wellknown.network/agents/yandex-search-mcp","markdown":"https://wellknown.network/agents/yandex-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yandex-search-mcp","status":"https://wellknown.network/api/v1/agents/yandex-search-mcp/status","claim":"https://wellknown.network/agents/yandex-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yandex-search-mcp/claim.json","badge":"https://wellknown.network/agents/yandex-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yandex-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yandex-search-mcp","summary":"Self-hosted MCP server for Yandex Search API v2 (web, image, generative search)","description":"# yandex-search-mcp\n\n[По-русски → README.ru.md](README.ru.md)\n\nSelf-hosted MCP server for **Yandex Search API v2**: web search, image search, and generative search (AI answer with cited sources). Built for Russian-language search (all 6 Yandex indexes: ru/com/tr/kk/be/uz), STDIO transport, fully typed tool parameters, structured output.\n\nWorks with **Claude Code**, **Codex CLI**, and **opencode** (any MCP client with stdio support).\n\n## Why\n\nThe official `yandex/yandex-search-mcp-server` is a Turkish-market demo: only tr/en regions, XML parsed with regexes, a non-existent dependency pin, and a `json.loads(resp[1:-1])` hack on generative search. This server is a from-scratch replacement modeled on the structure and quality of `brave/brave-search-mcp-server`:\n\n- proper XML parsing with `defusedxml` (untrusted web content), parser written against **live API fixtures**;\n- typed parameters with fail-fast validation (no `body: dict`);\n- retries with exponential backoff on 429/5xx/network only; a unified JSON error contract;\n- the API key never leaks into logs or error messages (covered by tests);\n- image results contain URLs and metadata only — never base64 (a lesson from Brave's 2.0 breaking change);\n- LLM-facing tool descriptions with \"when to use / when NOT to use\" guidance.\n\n## Tools\n\n| Tool | What it does | When to use |\n|---|---|---|\n| `yandex_web_search` | Classic web search: ranked documents (url, title, snippet) | The default: facts, news, research |\n| `yandex_image_search` | Image search by text query: URLs and metadata | Pictures, diagrams, references |\n| `yandex_gen_search` | One AI-synthesized answer with cited sources | Expensive/slow; only when a digest is explicitly needed |\n\n## Getting credentials\n\n1. [Create an API key](https://yandex.cloud/en/docs/iam/operations/authentication/manage-api-keys) for a service account with scope `yc.search-api.execute`.\n2. Grant the service account the **`search-api.editor`** role on the folder.\n3. Get your **Folder ID** …","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["mcp","model-context-protocol","yandex","search","search-api","llm","agents"],"pricing":null,"endpoints":[{"url":"pypi:yandex-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.web-search","name":"Web Search","confidence":0.894,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.814,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["data","dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yandex-search-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:24.497Z","publishedAt":"2026-06-11T14:31:15.413820Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yandex-search-mcp","url":"https://pypi.org/project/yandex-search-mcp/","firstSeenAt":"2026-09-10T16:23:11.197Z","fetchedAt":"2026-09-10T16:23:11.197Z","normalizedAt":"2026-09-10T16:23:11.197Z"}]},"firstSeenAt":"2026-09-10T16:23:11.197Z","updatedAt":"2026-09-10T16:24:24.497Z"}