{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_a9efzhyv343n","handle":"ya-reviews-mcp","url":"https://wellknown.network/agents/ya-reviews-mcp","links":{"self":"https://wellknown.network/agents/ya-reviews-mcp/record.json","html":"https://wellknown.network/agents/ya-reviews-mcp","markdown":"https://wellknown.network/agents/ya-reviews-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ya-reviews-mcp","status":"https://wellknown.network/api/v1/agents/ya-reviews-mcp/status","claim":"https://wellknown.network/agents/ya-reviews-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ya-reviews-mcp/claim.json","badge":"https://wellknown.network/agents/ya-reviews-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ya-reviews-mcp/history","tools":"https://wellknown.network/api/v1/agents/ya-reviews-mcp/tools"},"ard":{"identifier":"urn:air::server:ya-reviews-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ya-reviews-mcp","summary":"MCP server for Yandex Maps business reviews","description":"# ya-reviews-mcp\n\n[![PyPI](https://img.shields.io/pypi/v/ya-reviews-mcp)](https://pypi.org/project/ya-reviews-mcp/)\n![License](https://img.shields.io/badge/license-MIT-blue)\n![Python](https://img.shields.io/badge/python-3.10%2B-blue)\n![FastMCP](https://img.shields.io/badge/FastMCP-2.13%2B-green)\n\nModel Context Protocol (MCP) server for [Yandex Maps](https://yandex.ru/maps/) business reviews. Scrapes reviews from any Yandex Maps organization page and exposes them to your AI assistant — review text, ratings, author info, likes/dislikes, business responses, and company metadata.\n\nNo API key required. Uses a headless Chromium browser under the hood. Supports multiple browser backends: [Playwright](https://playwright.dev/), [Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright-python) (anti-detection), or a remote browser via CDP.\n\n## Quick Start\n\n### 1. Install\n\nChoose your backend:\n\n```bash\n# Option A: Playwright (default)\nuv tool install ya-reviews-mcp[playwright]\nplaywright install chromium\n\n# Option B: Patchright (better anti-detection)\nuv tool install ya-reviews-mcp[patchright]\npatchright install chromium\n\n# Option C: Remote browser (no local browser needed)\nuv tool install ya-reviews-mcp\n# Then run a browser separately, e.g.:\n# docker run -p 3000:3000 ghcr.io/browserless/chromium\n```\n\n> **No uv?** Use pip instead: `pip install ya-reviews-mcp[playwright]`\n\n### 2. Find the Organization ID\n\nOpen any business on [Yandex Maps](https://yandex.ru/maps/) and look at the URL:\n\n```\nhttps://yandex.ru/maps/org/astra_motors/1248139252/reviews/\n                                        ^^^^^^^^^^\n                                        this is the org_id\n```\n\n### 3. Configure Your IDE\n\nAdd to your Claude Desktop / Cursor MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"ya-reviews\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"ya-reviews-mcp[playwright]\", \"ya-reviews-mcp\"]\n    }\n  }\n}\n```\n\n> **Using Patchright?** Replace `ya-reviews-mcp[playwright]` with `ya-…","publisher":{"name":"Ruben Khachaturov","url":null},"homepage":"https://github.com/mrkhachaturov/ya-reviews-mcp","repository":"https://github.com/mrkhachaturov/ya-reviews-mcp","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["business","maps","mcp","reviews","yandex"],"pricing":null,"endpoints":[{"url":"pypi:ya-reviews-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.review","name":"Code Review","confidence":1,"provenance":"derived"},{"slug":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"derived"},{"slug":"geo.maps","name":"Maps & Places","confidence":1,"provenance":"declared"}],"categories":["code","geo","infra"],"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":"ya-reviews-mcp","registry":"pypi","observedAt":"2026-11-10T07:23:32.356Z","publishedAt":"2026-02-23T22:49:26.189958Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ya-reviews-mcp","url":"https://pypi.org/project/ya-reviews-mcp/","firstSeenAt":"2026-09-10T16:23:13.935Z","fetchedAt":"2026-11-10T07:22:25.820Z","normalizedAt":"2026-11-10T07:22:25.820Z"}]},"firstSeenAt":"2026-09-10T16:23:13.935Z","updatedAt":"2026-11-10T07:23:32.356Z"}