{"_id":"yandex-metrika-mcp","_rev":"6-b82df457a1f0adf4d4ba630390457fc4","name":"yandex-metrika-mcp","dist-tags":{"latest":"1.2.3"},"versions":{"1.0.0":{"name":"yandex-metrika-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"author":{"name":"Alternex"},"license":"MIT","_id":"yandex-metrika-mcp@1.0.0","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/altrr2/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/altrr2/yandex-tools-mcp/issues"},"bin":{"yandex-metrika-mcp":"src/index.mjs"},"dist":{"shasum":"c11e83ab91e55a17dee0a6fac1489b206bc9d8e6","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-zhzhxqFkdvF5RUohH+XBT2uo1DdOnJCXsZbEsntIoEkX0BH+rBsccAqoxQF2bzMp6DcnrkbQqFH/x90oY7ibQw==","signatures":[{"sig":"MEUCIGp3Xy6WWyVHFN21I/rRsITPDXUWWzVGEdH/vddycxxTAiEAgQW8+aaAEeyPe8gBUdl0RiLlYz+QU2+OZNQVFiPs4bQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28244},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"1c59423cb4fbf8c1217632ffc4487cbb3c368006","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/altrr2/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"11.7.0","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"_nodeVersion":"22.19.0","dependencies":{"zod":"^4.3.5","@modelcontextprotocol/sdk":"^1.25.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.0.0_1767718548674_0.7567748619806371","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"yandex-metrika-mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"author":{"name":"Alternex"},"license":"MIT","_id":"yandex-metrika-mcp@1.1.0","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/altrr2/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/altrr2/yandex-tools-mcp/issues"},"bin":{"yandex-metrika-mcp":"src/index.mjs"},"dist":{"shasum":"6b17c199556ec079f4e9193245a3eb1cfd31391d","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-Sjeb7rrvWGsOLcHnX24WQGENj48T4pt91d5v6v5jotrfKSgp2fr7du8WeoooQPphqjz2TmYf6R5qq2nSJYY92Q==","signatures":[{"sig":"MEQCIB79TQOyXa42oJ3yiZdDsN/lF5dv4cHOiwEkKHWT6FnbAiAhwl1PZRltu+Q30UXSN5UQhUuplETohDrqsy6AEd/aAg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29309},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"4d4194f1c8b13017199ae063194391cfc60454da","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/altrr2/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"11.16.0","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.1.0_1780926625337_0.34815615655812593","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"yandex-metrika-mcp","version":"1.2.0","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"author":{"name":"Alternex"},"license":"MIT","_id":"yandex-metrika-mcp@1.2.0","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/altrr2/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/altrr2/yandex-tools-mcp/issues"},"bin":{"yandex-metrika-mcp":"src/index.mjs"},"dist":{"shasum":"8c315e8b378d8d248cd64e9a6ed64c44c0e20bef","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.2.0.tgz","fileCount":5,"integrity":"sha512-zQU9Jl3VAavagVELMM0XYaRyWcunKCG3fGDa0tAsYOWkQm1xoDOyukme42tGDRNqT3EitAT9YNxfuiSE5QDifg==","signatures":[{"sig":"MEYCIQCVT5RAAzupcqH8DHw0ADN5Uafyeraixt4Gm0zEb8oUUwIhAMEtz3jKkh9n0QWCCGmNPC2dA1XbRGmijp/vCqFnvT2u","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64949},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6c9ea7e5356964866d349535a4e3c77cfbe66b93","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/altrr2/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"11.18.0","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.2.0_1782949568950_0.730108837797153","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"yandex-metrika-mcp","version":"1.2.1","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"author":{"name":"Alternex"},"license":"MIT","_id":"yandex-metrika-mcp@1.2.1","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/altrr2/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/altrr2/yandex-tools-mcp/issues"},"bin":{"yandex-metrika-mcp":"src/index.mjs"},"dist":{"shasum":"907b756ed30ec034c2f84de09de1d5a2a1d4a6e2","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.2.1.tgz","fileCount":5,"integrity":"sha512-2FVs71Xv4PlcwC55FgOc1ZKMfh5zGm43mRzHcuX0wBiJV0l6JV6UN+vRF8WEByZNF99hmwJ68cq10T3MQrLd+g==","signatures":[{"sig":"MEUCIBC6h2YfBWdWM071+84c74iC6aDNYQ2+bHr/Rsrd11E6AiEAmSWD80JO2PIaobibpgvlru6Ng9uAjDPIesjtagKz91U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64942},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"dea27e7f9ea065dbb0923a4d0adb297df0e6fb43","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/altrr2/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"11.18.0","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.2.1_1783249596892_0.3517050591708526","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"name":"yandex-metrika-mcp","version":"1.2.2","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"author":{"url":"https://seyka.ru","name":"Seyka AI"},"license":"MIT","_id":"yandex-metrika-mcp@1.2.2","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"bin":{"yandex-metrika-mcp":"src/index.mjs"},"dist":{"shasum":"226dc07fe269d91e5954a0140402410aaee09eea","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.2.2.tgz","fileCount":5,"integrity":"sha512-pJQHZkDM2OraCJHfis/76YGp3ccadv7ZC60fhTTWgilUWP1vGUtL1d17aSejwCD5JLy7HBVZnv4BdCAUmOkelQ==","signatures":[{"sig":"MEUCIAYoCrKabzC7/DcemN0l3BKT3jPOmoSB+BNmKAwMXe6kAiEAigVtid9VfhqFd1N0UvZkVhUzcoT5+z8W625gEexn/Y0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIA1/jaKH1KEYMcYsNQFLkYewsMBOkXB35jhGNVr4tE3JAiEA4jekFoobdXEbnctgLO6c7gXM7A3f80ndOvHYS5wH7Dw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65189},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"264f6357e290a7d65bc02d5cba1a1c3234350aaa","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"12.2.1","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-metrika-mcp_1.2.2_1793189747832_0.9502992410674673","host":"s3://npm-registry-packages-npm-production"}},"1.2.3":{"_id":"yandex-metrika-mcp@1.2.3","bin":{"yandex-metrika-mcp":"src/index.mjs"},"bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"dist":{"shasum":"059db5085d080d17c79d8a6c0a27a0f366883ab7","tarball":"https://registry.npmjs.org/yandex-metrika-mcp/-/yandex-metrika-mcp-1.2.3.tgz","fileCount":5,"integrity":"sha512-EGiF6r1b7DCx7HxsjVFCz0HkXLp2CpW4uv4fEkt9EKECwcF+MnjivhZ7AW8VdJx1bK6p4Vn5gO6RuZJAph1EKA==","signatures":[{"sig":"MEUCIQCQ/aoML53ReRuA48Evd6JfObrDF/JDMECAomdxJc5wjgIgIFqQiEp5AueLjUpct2tpv2UVYYJ/3HsMZ3HLeRQoYXQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEvhZTY4+RkAWa2pidVijYApAdQyyBK1mly7RcvLlu1WAiEA6aHXaLmQSoJREJXu7DA0DSNcdd30mf+ubQOWYQZ80rQ="}],"unpackedSize":65655},"main":"src/index.mjs","name":"yandex-metrika-mcp","type":"module","author":{"url":"https://seyka.ru","name":"Seyka AI"},"engines":{"node":">=18.0.0"},"gitHead":"f3230f6b0142611ea4e92471fc9fe14f0db31c71","license":"MIT","scripts":{"start":"node src/index.mjs"},"version":"1.2.3","_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"_npmVersion":"12.2.1","description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","directories":{},"maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yandex-metrika-mcp_1.2.3_1793199958085_0.6372093850528436"}}},"time":{"created":"2026-01-06T16:55:48.673Z","modified":"2026-10-28T15:05:58.401Z","1.0.0":"2026-01-06T16:55:48.823Z","1.1.0":"2026-06-08T13:50:25.466Z","1.2.0":"2026-07-01T23:46:09.164Z","1.2.1":"2026-07-05T11:06:37.027Z","1.2.2":"2026-10-28T12:15:47.925Z","1.2.3":"2026-10-28T15:05:58.174Z"},"bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"author":{"url":"https://seyka.ru","name":"Seyka AI"},"license":"MIT","homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-metrika-mcp#readme","keywords":["mcp","model-context-protocol","yandex","metrika","analytics","web-analytics","traffic","visitors","russian","claude","ai"],"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-metrika-mcp"},"description":"MCP server for Yandex Metrika API - web analytics, traffic data, and visitor insights","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"readme":"# yandex-metrika-mcp\n\nMCP server for [Yandex Metrika API](https://yandex.com/dev/metrika/) — web analytics, traffic data, and visitor insights.\n\n[![npm version](https://badge.fury.io/js/yandex-metrika-mcp.svg)](https://www.npmjs.com/package/yandex-metrika-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[English](#english) | [Русский](#русский)\n\n---\n\n## English\n\n### Features\n\n- **Traffic analytics** — visits, users, pageviews, bounce rate, session duration\n- **Traffic sources** — breakdown by direct, search, social, referral\n- **Geography** — visitor countries and cities\n- **Devices** — device types, browsers, operating systems\n- **Popular pages** — top pages by views\n- **Search phrases** — keywords that brought visitors\n- **Custom reports** — flexible queries with any dimensions/metrics\n- **Counter management** — list counters and goals\n\n### Setup\n\n#### Step 1: Get OAuth Token\n\n**Option A: Quick (manual token)**\n\n1. Go to [Yandex OAuth](https://oauth.yandex.ru/)\n2. Create an app with **Metrika API** access (scope: `metrika:read`)\n3. Get a debug token from the app settings\n\n**Option B: OAuth flow (recommended)**\n\n1. Create an app at [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new)\n2. Enable **Yandex Metrica** API access with `metrika:read` scope\n3. Set callback URL to `https://oauth.yandex.ru/verification_code`\n4. Run the auth helper:\n\n```bash\nexport YANDEX_CLIENT_ID=your_client_id\nexport YANDEX_CLIENT_SECRET=your_client_secret\nnpx yandex-metrika-mcp auth\n```\n\n#### Step 2: Configure Claude\n\n**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-metrika\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"yandex-metrika-mcp\"],\n      \"env\": {\n        \"YANDEX_METRIKA_TOKEN\": \"your_oauth_token\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add yandex-metrika \\\n  -e YANDEX_METRIKA_TOKEN=your_oauth_token \\\n  -- npx -y yandex-metrika-mcp\n```\n\n### Tools\n\n| Tool | Description |\n|------|-------------|\n| `get-counters` | List all Metrica counters |\n| `get-counter` | Get counter details |\n| `get-goals` | List counter goals |\n| `get-traffic-summary` | Visits, users, pageviews, bounce rate |\n| `get-traffic-sources` | Traffic source breakdown |\n| `get-geography` | Visitor countries and cities |\n| `get-devices` | Device/browser/OS stats |\n| `get-popular-pages` | Top pages by views |\n| `get-search-phrases` | Search keywords |\n| `get-report` | Custom report with any dimensions/metrics |\n| `get-high-bounce-pages-organic` | Organic landing pages by bounce rate |\n| `get-critical-pages` | Organic pages with >70% bounce |\n| `get-bounce-comparison-search-engines` | Bounce by search engine (Yandex vs Google) |\n| `get-bounce-by-devices-organic` | Organic bounce by device |\n| `get-bounce-device-search-engine` | Bounce by device × search engine |\n| `get-page-depth-by-sections` | Engagement depth by site section |\n| `get-exit-pages-by-section` | Exits grouped by section |\n| `get-entry-exit-paths` | Entry → exit page journeys |\n| `get-top-exit-pages-organic` | Where organic traffic exits |\n| `get-exit-pages-by-devices` | Exit pages by device |\n| `get-conversions-by-search-engine` | Organic conversions by search engine |\n| `get-conversions-by-landing-pages` | Organic conversions by landing page |\n| `get-conversions-by-search-phrases` | Organic conversions by search phrase |\n| `get-conversions-by-devices` | Organic conversions by device |\n| `get-conversions-by-regions` | Organic conversions by region |\n| `get-conversions-device-region` | Organic conversions by device × region |\n| `get-referral-donors-behavior` | Referring domains by behavior/quality |\n| `get-referral-full-urls` | Specific referring page URLs |\n| `get-quality-referral-traffic` | Low-bounce referring domains |\n| `get-referral-conversions` | Conversions from referring domains |\n| `get-social-networks-traffic` | Traffic by social network |\n| `get-social-networks-quality` | Quality/conversions by social network |\n| `get-social-landing-pages` | Landing pages for social traffic |\n| `get-new-vs-returning-organic` | New vs returning organic visitors |\n| `get-visit-frequency-organic` | Organic visit-frequency distribution |\n| `get-demographics-organic` | Organic audience by gender/age |\n| `get-audience-interests` | Interests of organic visitors |\n| `get-organic-activity-by-hour` | Organic traffic by hour of day |\n| `get-organic-activity-by-day-of-week` | Organic traffic by day of week |\n| `get-organic-traffic-dynamics` | Daily organic traffic trend |\n| `get-organic-seasonality` | Organic traffic by month |\n| `get-organic-browsers` | Browsers of organic visitors |\n| `get-problematic-os` | OSes with highest organic bounce |\n| `get-screen-resolutions` | Screen resolutions of organic visitors |\n\nConversion tools accept an optional `goal_id` (from `get-goals`); when omitted they report all goals combined. SEO report tools filter to organic search traffic by default.\n\n### Usage Examples\n\nOnce configured, ask Claude:\n\n- \"Show me traffic for my site last month\"\n- \"What are the top traffic sources?\"\n- \"Which pages get the most views?\"\n- \"Where are my visitors from?\"\n- \"What devices do visitors use?\"\n- \"What search phrases bring traffic?\"\n\nHosted version: <a href=\"https://seyka.ru/developers/mcp/yandex-metrika\" target=\"_blank\">Yandex Metrika MCP on seyka.ru</a>\nOnline usage example: <a href=\"https://seyka.ru\" target=\"_blank\">seyka.ru</a>\n\n---\n\n## Русский\n\n### Возможности\n\n- **Аналитика трафика** — визиты, пользователи, просмотры, отказы, длительность сессии\n- **Источники трафика** — разбивка по прямым, поиску, соцсетям, переходам\n- **География** — страны и города посетителей\n- **Устройства** — типы устройств, браузеры, ОС\n- **Популярные страницы** — топ страниц по просмотрам\n- **Поисковые фразы** — ключевые слова, приводящие посетителей\n- **Кастомные отчёты** — гибкие запросы с любыми измерениями/метриками\n- **Управление счётчиками** — список счётчиков и целей\n\n### Настройка\n\n#### Шаг 1: Получите OAuth токен\n\n**Вариант A: Быстрый (ручной токен)**\n\n1. Перейдите на [Yandex OAuth](https://oauth.yandex.ru/)\n2. Создайте приложение с доступом к **API Метрики** (scope: `metrika:read`)\n3. Получите отладочный токен в настройках приложения\n\n**Вариант B: OAuth поток (рекомендуется)**\n\n1. Создайте приложение на [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new)\n2. Включите доступ к **Яндекс Метрике** с правом `metrika:read`\n3. Укажите callback URL: `https://oauth.yandex.ru/verification_code`\n4. Запустите помощник авторизации:\n\n```bash\nexport YANDEX_CLIENT_ID=ваш_client_id\nexport YANDEX_CLIENT_SECRET=ваш_client_secret\nnpx yandex-metrika-mcp auth\n```\n\n#### Шаг 2: Настройте Claude\n\n**Claude Desktop** — отредактируйте `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) или `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-metrika\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"yandex-metrika-mcp\"],\n      \"env\": {\n        \"YANDEX_METRIKA_TOKEN\": \"ваш_oauth_токен\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add yandex-metrika \\\n  -e YANDEX_METRIKA_TOKEN=ваш_oauth_токен \\\n  -- npx -y yandex-metrika-mcp\n```\n\n### Инструменты\n\n| Инструмент | Описание |\n|------------|----------|\n| `get-counters` | Список счётчиков Метрики |\n| `get-counter` | Детали счётчика |\n| `get-goals` | Список целей счётчика |\n| `get-traffic-summary` | Визиты, пользователи, просмотры, отказы |\n| `get-traffic-sources` | Разбивка по источникам трафика |\n| `get-geography` | Страны и города посетителей |\n| `get-devices` | Статистика устройств/браузеров/ОС |\n| `get-popular-pages` | Топ страниц по просмотрам |\n| `get-search-phrases` | Поисковые запросы |\n| `get-report` | Кастомный отчёт с любыми измерениями/метриками |\n| `get-high-bounce-pages-organic` | Органические страницы входа по отказам |\n| `get-critical-pages` | Органические страницы с отказами >70% |\n| `get-bounce-comparison-search-engines` | Отказы по поисковикам (Яндекс vs Google) |\n| `get-bounce-by-devices-organic` | Органические отказы по устройствам |\n| `get-bounce-device-search-engine` | Отказы по устройству × поисковику |\n| `get-page-depth-by-sections` | Глубина просмотра по разделам сайта |\n| `get-exit-pages-by-section` | Выходы по разделам |\n| `get-entry-exit-paths` | Пути вход → выход |\n| `get-top-exit-pages-organic` | Где выходит органический трафик |\n| `get-exit-pages-by-devices` | Страницы выхода по устройствам |\n| `get-conversions-by-search-engine` | Органические конверсии по поисковику |\n| `get-conversions-by-landing-pages` | Органические конверсии по странице входа |\n| `get-conversions-by-search-phrases` | Органические конверсии по запросу |\n| `get-conversions-by-devices` | Органические конверсии по устройству |\n| `get-conversions-by-regions` | Органические конверсии по регионам |\n| `get-conversions-device-region` | Органические конверсии по устройству × региону |\n| `get-referral-donors-behavior` | Домены-доноры по поведению/качеству |\n| `get-referral-full-urls` | Конкретные URL страниц-источников |\n| `get-quality-referral-traffic` | Домены-доноры с низким отказом |\n| `get-referral-conversions` | Конверсии с доменов-доноров |\n| `get-social-networks-traffic` | Трафик по соцсетям |\n| `get-social-networks-quality` | Качество/конверсии по соцсетям |\n| `get-social-landing-pages` | Страницы входа для соцтрафика |\n| `get-new-vs-returning-organic` | Новые vs вернувшиеся (органика) |\n| `get-visit-frequency-organic` | Частота визитов (органика) |\n| `get-demographics-organic` | Пол/возраст органической аудитории |\n| `get-audience-interests` | Интересы органических посетителей |\n| `get-organic-activity-by-hour` | Органический трафик по часам |\n| `get-organic-activity-by-day-of-week` | Органический трафик по дням недели |\n| `get-organic-traffic-dynamics` | Дневная динамика органического трафика |\n| `get-organic-seasonality` | Органический трафик по месяцам |\n| `get-organic-browsers` | Браузеры органических посетителей |\n| `get-problematic-os` | ОС с наибольшим отказом (органика) |\n| `get-screen-resolutions` | Разрешения экранов органических посетителей |\n\nИнструменты конверсий принимают необязательный `goal_id` (из `get-goals`); без него считаются все цели вместе. SEO-отчёты по умолчанию фильтруют органический поисковый трафик.\n\n### Примеры использования\n\nПосле настройки спросите Claude:\n\n- \"Покажи трафик моего сайта за последний месяц\"\n- \"Какие основные источники трафика?\"\n- \"Какие страницы самые популярные?\"\n- \"Откуда мои посетители?\"\n- \"Какие устройства используют посетители?\"\n- \"По каким поисковым запросам приходят?\"\n\nХостинг-версия: <a href=\"https://seyka.ru/developers/mcp/yandex-metrika\" target=\"_blank\">Яндекс Метрика MCP на seyka.ru</a>\nОнлайн пример использования: <a href=\"https://seyka.ru\" target=\"_blank\">seyka.ru</a>\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}