Подключение на русском

\n\n**Claude.ai** (Настройки → Коннекторы → Добавить):\n```\nhttps://mcp.getaiaiai.ru/yandex-metrika\n```\nНажмите **Подключить** → войдите через Яндекс → разрешите доступ.\n\n**Claude Code CLI:**\n```bash\nclaude mcp add --transport http yandex-metrika https://mcp.getaiaiai.ru/yandex-metrika/\nclaude mcp login yandex-metrika\n```\nОткроется браузер → войти через Яндекс → готово.\n\n

\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_counters` | List all Yandex Metrika counters available to the token (id, name, site) |\n| `query` | Run a Reporting API query — visits, users, pageviews, bounce rate, traffic sources, devices, geography, UTMs, and more |\n\n### `query` parameters\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| `counter_id` | required | Counter ID from `list_counters` |\n| `metrics` | required | Comma-separated metrics, e.g. `ym:s:visits,ym:s:users` |\n| `dimensions` | — | Group-by fields: `ym:s:date`, `ym:s:lastTrafficSource`, `ym:s:deviceCategory`, … |\n| `date1` / `date2` | `7daysAgo` / `today` | Date range: `YYYY-MM-DD` or relative (`today`, `yesterday`, `NdaysAgo`) |\n| `filters` | — | Filter expression, e.g. `ym:s:deviceCategory=='mobile'` |\n| `sort` | — | Sort field; prefix `-` for descending, e.g. `-ym:s:visits` |\n| `limit` | `100` | Max rows returned |\n\nCommon metrics: `ym:s:visits`, `ym:s:users`, `ym:s:pageviews`, `ym:s:bounceRate`, `ym:s:avgVisitDurationSeconds`, `ym:s:newUsers`\n\nCommon dimensions: `ym:s:date`, `ym:s:lastTrafficSource`, `ym:s:startURL`, `ym:s:deviceCategory`, `ym:s:regionCountry`, `ym:s:lastsourceUTMSource`\n\n---\n\n## Self-host with your own token\n\n

For developers — run the engine locally with full control over your data.

\n\nRequires Python 3.10+ and [uv](https://docs.astral.sh/uv/).\n\n```bash\ngit clone https://github.com/expremiental/yandex-metrika-mcp.git\ncd yandex-metrika-mcp\nuv sync\n```\n\n**Get a token.** Go to [oauth.yandex.ru](https://oauth.yandex.ru), create an app (platform: \"Web services\"), enable **Yandex Metrika → Read statistics** (`metrika:read`), then get an OAuth token:\n\n```bash\nexport YANDEX_METRIKA_TOKEN=\"\"\n```\n\n**Connect** (Claude Desktop / Cursor — add to `mcpServers`):\n\n```json\n{\n \"mcpServers\": {\n \"yandex-metrika\": {\n \"command\": \"uv\",\n \"args\": [\"run\", \"yandex-metrika-mcp\"],\n \"env\": { \"YANDEX_METRIKA_TOKEN\": \"\" }\n }\n }\n}\n```\n\n**Run over HTTP:**\n```bash\nMCP_TRANSPORT=http PORT=8000 uv run yandex-metrika-mcp\n# endpoint: http://localhost:8000/mcp\n```\n\n**Embed in your own backend.** The engine accepts an injectable async token resolver — wrap it with your own auth:\n\n```python\nfrom yandex_metrika_mcp import build_server\n\nasync def my_token_resolver() -> str:\n return \"\"\n\nbuild_server(token_resolver=my_token_resolver).run(transport=\"stdio\")\n```\n\nPublic API: `build_server`, `YandexMetrikaClient`, `TokenResolver`, `env_token_resolver`, `main`.\n\n

\n\n## License\n\n[MIT](https://github.com/expremiental/yandex-metrika-mcp/blob/main/LICENSE) · made by [aiaiai](https://getaiaiai.ru)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_106":107,"_108":109,"_110":111,"_112":113,"_114":-5,"_115":116},"requiredSecrets",[],"tags",[101,102,103,104,105],"assets",[],"stats",{"_99":86,"_100":86},"ratingAvg","reviewCount","analytics","fastmcp","python","yandex","yandex-metrika","topics",[101,102,117,118,119,103,104,105],"license","MIT","language","Python","registryName","io.github.expremiental/yandex-metrika-mcp","homepage","packages",[],"mcp","mcp-server","model-context-protocol","ENV",{"_122":123,"_124":125,"_126":127},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Yandex Metrika MCP