{"_id":"@dev-crabs/yandex-metrika-mcp","_rev":"3-eb2f19716dd58bbb81e3a77e812b9456","name":"@dev-crabs/yandex-metrika-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"0.0.0-stage":{"name":"@dev-crabs/yandex-metrika-mcp","version":"0.0.0-stage","_id":"@dev-crabs/yandex-metrika-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"}],"dist":{"shasum":"01a7701e65018ba1343baa509e650a77bbbe12b4","tarball":"https://registry.npmjs.org/@dev-crabs/yandex-metrika-mcp/-/yandex-metrika-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-6L9X+krQ8BPhQrlz2O6nQ6pAS+tyM9B86c3g1zJPGfH4ES2ueY9z/cky53RiChOb5+8GaLnn81Oub0FnKY97cA==","signatures":[{"sig":"MEUCIF8AO9z7BKDFVYtEMzzPiTDDx4TcR/eFEF6XFrbP9DbtAiEAmhu8nO6+4nzy+xZr+ElAkIUjSf/B9EGn1wI4kJfFnOk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":351},"_npmUser":{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0-beta.1":{"name":"@dev-crabs/yandex-metrika-mcp","version":"1.0.0-beta.1","keywords":["mcp","mcp-server","model-context-protocol","mcpb","yandex","yandex-metrika","yandex-metrica","yandex-metrika-api","metrika","metrica","analytics","web-analytics","marketing-analytics","seo","traffic","utm","goals","conversion","reports","яндекс-метрика","яндекс","метрика","веб-аналитика","аналитика","claude","claude-desktop","claude-code","cursor","vscode","codex","ai-agent","llm"],"author":{"name":"DevCrabs"},"license":"MIT","_id":"@dev-crabs/yandex-metrika-mcp@1.0.0-beta.1","maintainers":[{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"}],"homepage":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp/issues"},"bin":{"yandex-metrika-mcp":"dist/cli.js"},"dist":{"shasum":"20d9a8c898b596e6f0ce461078c0f03972fb630c","tarball":"https://registry.npmjs.org/@dev-crabs/yandex-metrika-mcp/-/yandex-metrika-mcp-1.0.0-beta.1.tgz","fileCount":7,"integrity":"sha512-ozfBoG3pP7UCgrI0BlAqjwmcO8w9cCKBFDlvhka2NwryavpNM6RqoXapYI6fiD7cIm7XvwHK/n7SeC8MESEXIg==","signatures":[{"sig":"MEYCIQC4poN9wAS3+zltgVjkHICGE+MH0LKevLstRFO+VOTilgIhAJHKHupyTDZQLpdBtY4/Rzm9+JAEwS2mto1DU+COW62S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCID3NM6ZuUJQkQMhwPCVNqkDeQb4wnH8aOSRZgOlUNFiGAiEA717wrWxkx6WlfEuXLrH3HnttgC99L5dY/q0iGfgPdHs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3563724},"type":"module","_from":"file:build/release/package.tgz","engines":{"node":">=22.13"},"mcpName":"io.github.DevCrabs-Inc/yandex-metrika-mcp","scripts":{"dev":"node src/cli/index.ts","lint":"biome check .","mcpb":"node scripts/build-mcpb.mjs","test":"vitest run","build":"tsdown","check":"pnpm lint && pnpm typecheck && pnpm test","format":"biome check --write .","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"},"_resolved":"/Users/misha/Work/DevCrabs/yandex-metrika-mcp/build/release/package.tgz","_integrity":"sha512-ozfBoG3pP7UCgrI0BlAqjwmcO8w9cCKBFDlvhka2NwryavpNM6RqoXapYI6fiD7cIm7XvwHK/n7SeC8MESEXIg==","repository":{"url":"git+https://github.com/DevCrabs-Inc/yandex-metrika-mcp.git","type":"git"},"_npmVersion":"11.21.2","description":"Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and CSV/JSON exports with explicit data quality.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@napi-rs/keyring":"2.1.2"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","tsdown":"0.23.7","vitest":"5.1.0","lefthook":"2.2.2","typescript":"7.0.2","@types/node":"^22.20.5","@biomejs/biome":"2.6.5","@modelcontextprotocol/client":"2.4.0","@modelcontextprotocol/server":"2.4.0"},"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.0.0-beta.1_1794245788192_0.4807040919227066","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"_id":"@dev-crabs/yandex-metrika-mcp@1.0.0","bin":{"yandex-metrika-mcp":"dist/cli.js"},"bugs":{"url":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp/issues"},"dist":{"shasum":"e17e950596d2e747bfa0d883e20dfeccf68c80c9","tarball":"https://registry.npmjs.org/@dev-crabs/yandex-metrika-mcp/-/yandex-metrika-mcp-1.0.0.tgz","fileCount":7,"integrity":"sha512-TEgSG1vxb5/W8Q4pGub4tKNB/aZPLKX3Utl37vE8QaGvlcgb4C3VR3DXvL6EJ7WWYBHzd16RzJAV5pFiax2SQw==","signatures":[{"sig":"MEUCIDlE1hAjEY7Tbh0cDuY76QiRAIRA7i43eIqEnFZFsjoBAiEAidyWr8Mj84R+iUg6XQ+WCs7yFQoCSFpTNX4RSuXR+X0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGmLTRZJydgFBx21ASm5trDqwMeWWVsWjcBhp1vfbcS8AiEA6PLF3+zc2Nv9A1ikbsBT6zAQ0v/vkC7sjWeY/brw0uA="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@dev-crabs%2fyandex-metrika-mcp@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3564134},"name":"@dev-crabs/yandex-metrika-mcp","type":"module","_from":"file:package.tgz","author":{"name":"DevCrabs"},"engines":{"node":">=22.13"},"license":"MIT","mcpName":"io.github.DevCrabs-Inc/yandex-metrika-mcp","scripts":{"dev":"node src/cli/index.ts","lint":"biome check .","mcpb":"node scripts/build-mcpb.mjs","test":"vitest run","build":"tsdown","check":"pnpm lint && pnpm typecheck && pnpm test","format":"biome check --write .","typecheck":"tsc --noEmit","test:watch":"vitest"},"version":"1.0.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"c7d8c33d-e5e3-4634-bf42-a74da3b27580"}},"homepage":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","mcpb","yandex","yandex-metrika","yandex-metrica","yandex-metrika-api","metrika","metrica","analytics","web-analytics","marketing-analytics","seo","traffic","utm","goals","conversion","reports","яндекс-метрика","яндекс","метрика","веб-аналитика","аналитика","claude","claude-desktop","claude-code","cursor","vscode","codex","ai-agent","llm"],"_resolved":"/home/runner/work/yandex-metrika-mcp/yandex-metrika-mcp/package.tgz","_integrity":"sha512-TEgSG1vxb5/W8Q4pGub4tKNB/aZPLKX3Utl37vE8QaGvlcgb4C3VR3DXvL6EJ7WWYBHzd16RzJAV5pFiax2SQw==","repository":{"url":"git+https://github.com/DevCrabs-Inc/yandex-metrika-mcp.git","type":"git"},"_npmVersion":"11.20.0","description":"Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and CSV/JSON exports with explicit data quality.","directories":{},"maintainers":[{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"}],"_nodeVersion":"26.13.0","dependencies":{"@napi-rs/keyring":"2.1.2"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","tsdown":"0.23.7","vitest":"5.1.0","lefthook":"2.2.2","typescript":"7.0.2","@types/node":"^22.20.5","@biomejs/biome":"2.6.5","@modelcontextprotocol/client":"2.4.0","@modelcontextprotocol/server":"2.4.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yandex-metrika-mcp_1.0.0_1794246207889_0.7538353881913125"}}},"time":{"created":"2026-11-09T17:33:50.981Z","modified":"2026-11-09T17:43:28.382Z","0.0.0-stage":"2026-11-09T17:33:50.981Z","1.0.0-beta.1":"2026-11-09T17:36:28.369Z","1.0.0":"2026-11-09T17:43:28.016Z"},"bugs":{"url":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp/issues"},"author":{"name":"DevCrabs"},"license":"MIT","homepage":"https://github.com/DevCrabs-Inc/yandex-metrika-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","mcpb","yandex","yandex-metrika","yandex-metrica","yandex-metrika-api","metrika","metrica","analytics","web-analytics","marketing-analytics","seo","traffic","utm","goals","conversion","reports","яндекс-метрика","яндекс","метрика","веб-аналитика","аналитика","claude","claude-desktop","claude-code","cursor","vscode","codex","ai-agent","llm"],"repository":{"url":"git+https://github.com/DevCrabs-Inc/yandex-metrika-mcp.git","type":"git"},"description":"Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and CSV/JSON exports with explicit data quality.","maintainers":[{"name":"vect0rm","email":"m.skvortsovvv@gmail.com"}],"readme":"<p align=\"center\"><img src=\"assets/logo-512.png\" width=\"160\" alt=\"Yandex Metrika MCP logo: a crab holding a chart\"></p>\n\n# Yandex Metrika MCP\n\nMCP-сервер для **Яндекс Метрики** только на чтение. Подключите его к Claude, Cursor, VS Code, Codex или другому MCP-клиенту и спрашивайте про трафик, источники, посадочные страницы и цели. В каждом ответе есть точные даты, часовой пояс счётчика, признак семплирования, фильтры и происхождение данных, поэтому цифры можно проверить.\n\n> Статус: **1.0.0**, первый стабильный релиз. Названия инструментов, аргументы и поля ответов меняются по правилам семантического версионирования. Покрыт тестами на синтетических данных и имитации API, проверен живым входом через Яндекс и отчётами на macOS. Проверка в других клиентах и на других системах описана в [чек-листе релиза](docs/release-checklist.md).\n\n## Что умеет\n\n- **Вход через браузер.** Не нужно создавать своё OAuth-приложение и вставлять токен; токен не попадает в чат.\n- **Проверяемые цифры.** Периоды — календарные даты в часовом поясе счётчика, по умолчанию только завершённые дни. Строгий режим точности не выдаёт семплированные данные за точные. Итоги берутся из API, а не складываются из видимых строк.\n- **Несколько аккаунтов и клиентов агентства.** Подключения изолированы, у каждого свой список счётчиков.\n- **Полная выгрузка.** Фоновый экспорт всех строк в CSV/JSON с контрольными суммами, manifest-файлом и продолжением после перезапуска.\n- **Небольшой понятный набор.** 13 инструментов и 3 готовых сценария. Только чтение: сервер не может менять счётчики, цели и доступы.\n\n## Установка\n\nНужен Node.js 22.13 или новее. API-ключ и своё OAuth-приложение не нужны: после установки попросите ассистента подключить Яндекс Метрику и войдите через браузер.\n\n**Одной командой** (дописывает конфиг клиента и сохраняет резервную копию):\n\n```bash\nnpx -y @dev-crabs/yandex-metrika-mcp setup --client claude-desktop\n```\n\nВместо `claude-desktop` можно указать `claude-code`, `cursor`, `vscode`, `windsurf` или `codex`.\n\n**В один клик:**\n\n[![Установить в Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](<https://cursor.com/install-mcp?name=yandex-metrika&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBkZXYtY3JhYnMveWFuZGV4LW1ldHJpa2EtbWNwIl19>) [Установить в VS Code](<https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522yandex-metrika%2522%252C%2522type%2522%253A%2522stdio%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540dev-crabs%252Fyandex-metrika-mcp%2522%255D%257D>)\n\n**Claude Code:**\n\n```bash\nclaude mcp add --scope user yandex-metrika -- npx -y @dev-crabs/yandex-metrika-mcp\n```\n\nКонфиги для остальных клиентов, Windows и Claude Desktop (`.mcpb`) — в [инструкции по установке](docs/ru/installation.md). AI-агентам, которые ставят сервер сами, — [llms-install.md](llms-install.md).\n\nПерезапустите клиент и попросите: «Подключи Яндекс Метрику и сравни последние две недели по источникам трафика». Ассистент вызовет `metrika_connect` и даст ссылку для входа.\n\nПопробовать без аккаунта: всегда доступно демо-подключение `conn_demo` с синтетическими данными.\n\n## Примеры вопросов\n\n- «Сравни две последние полные недели по визитам и целевым визитам цели 3001».\n- «Какие посадочные страницы дают больше всего заявок по цели X за прошлый месяц?»\n- «Покажи динамику визитов по неделям с начала квартала».\n- «Выгрузи все источники трафика за октябрь в CSV для Excel».\n\n## Документация\n\n- [Установка](docs/ru/installation.md)\n- [Подключение аккаунта](docs/ru/connection.md)\n- [Инструменты и сценарии](docs/ru/tools.md)\n- [Корректность данных](docs/ru/data-quality.md)\n- [Экспорт](docs/ru/exports.md)\n- [Настройки](docs/ru/configuration.md)\n- [Решение проблем и коды ошибок](docs/ru/troubleshooting.md)\n- [Приватность и безопасность](docs/ru/privacy-security.md)\n\n## Лицензия\n\nMIT © DevCrabs\n","readmeFilename":"README.ru.md"}