Yandex Analytics
概要
作者による説明(英語の原文)
Read-only Yandex analytics for AI agents: Metrika, Webmaster, Direct and Wordstat.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 42/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: マーケティング・SNS
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
YANDEX_MCP_DEFAULT_COUNTER,YANDEX_MCP_CLIENT_ID
必要なもの
- PyPIPythonのuvのインストール(uvxコマンドに必要)
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"yandex": {
"command": "uvx",
"args": [
"yandex-mcp"
],
"env": {
"YANDEX_MCP_DEFAULT_COUNTER": "your-value",
"YANDEX_MCP_CLIENT_ID": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add yandex --env YANDEX_MCP_DEFAULT_COUNTER=your-value --env YANDEX_MCP_CLIENT_ID=your-value -- uvx yandex-mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"yandex": {
"command": "uvx",
"args": [
"yandex-mcp"
],
"env": {
"YANDEX_MCP_DEFAULT_COUNTER": "your-value",
"YANDEX_MCP_CLIENT_ID": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"yandex": {
"type": "stdio",
"command": "uvx",
"args": [
"yandex-mcp"
],
"env": {
"YANDEX_MCP_DEFAULT_COUNTER": "your-value",
"YANDEX_MCP_CLIENT_ID": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
YANDEX_MCP_DEFAULT_COUNTERenvMetrika counter id used when a tool call omits counter_idYANDEX_MCP_CLIENT_IDenvYandex OAuth application id; alternative to storing it in the OS keystore
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント nozikov で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
マーケティング・SNSのほかのサーバーとの比較i
- このカテゴリのほかの3603件のうち0%よりスターが多い
- このカテゴリのほかの3603件のうち30%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの3603件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Yandex Analyticsは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(2.1.0)がレジストリに届いたのは2 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。
代わりに使えるものは?
同じカテゴリには:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
yandex-mcp
Спрашивай свою аналитику Яндекса словами. Метрика, Вебмастер, Директ и Вордстат в одном MCP-сервере.
> Как изменился трафик за последний месяц и откуда пришёл рост?
По каким запросам мы на второй странице — там, где до топа осталось чуть-чуть?
Сколько стоила заявка в Директе на прошлой неделе по каждой кампании?
Как это работает
Сервер — обычная программа на твоём компьютере. Агент просит у неё данные, она идёт в API Яндекса и возвращает готовый текст. Никаких промежуточных серверов: твой токен и твои цифры не проходят через чужие руки.
Зависимостей нет вообще — ни одной сторонней библиотеки. Через этот процесс идёт доступ к твоей аналитике и рекламному кабинету, и чем меньше здесь чужого кода, тем лучше.
Установка
Claude Code — две команды, вместе с сервером ставятся скиллы:
/plugin marketplace add nozikov/yandex-mcp
/plugin install yandex-mcp@nozikov
Codex CLI — дописать в ~/.codex/config.toml и перезапустить Codex:
[mcp_servers.yandex]
command = "uvx" args = ["yandex-mcp"] env = { YANDEX_MCP_DEFAULT_COUNTER = "12345678" }
Любой другой клиент — через PyPI:
claude mcp add yandex -e YANDEX_MCP_DEFAULT_COUNTER=12345678 -- uvx yandex-mcp
Или вручную в конфиге, см. .mcp.json.example:
{
"mcpServers": { "yandex": { "command": "uvx", "args": ["yandex-mcp"], "env": { "YANDEX_MCP_DEFAULT_COUNTER": "12345678" } } } }
Счётчик указывать необязательно — без него его придётся называть в каждом вопросе.
Вход
Терминал не нужен: скажи агенту «подключи Яндекс», и он проведёт по шагам.
Один раз перед этим нужно зарегистрировать своё приложение в Яндексе — это бесплатно и занимает пять минут. Команда yandex-mcp setup откроет нужную страницу и подскажет, что заполнять. Пароль от приложения не понадобится: используется PKCE.
Единственный шаг, который агент не сделает за тебя, — сама регистрация: это твой аккаунт. А полученный ClientID можно просто продиктовать ему, он не секрет:
yandex-mcp setup --client-id <ClientID>
Что вписать при регистрации приложения
Яндекс спросит тип приложения. Подходят оба, разница только в способе входа:
| Тип | Redirect URI | Вход |
|---|---|---|
| «Для авторизации пользователей» | свой: http://localhost:8765/callback | yandex-mcp login |
| «Для доступа к API или отладки» | зафиксирован Яндексом | yandex-mcp login --manual |
В разделе «Доступ к данным» добавь права по названию:
metrika:read
webmaster:hostinfo webmaster:verify direct:api ← нужна заявка в кабинете Директа, рассматривают до 7 дней
Вход просит все права разом. Если direct:api ещё не одобрен, Яндекс откажет — сервер это заметит, войдёт без Директа и скажет об этом. Метрика и Вебмастер заработают сразу, а когда заявку одобрят, повторный вход подхватит Директ.
Команды в терминале: setup, login, status, logout.
Что умеет
Метрика
metrika_summary | Сводка за период: визиты, посетители, отказы, глубина, достижения всех целей |
metrika_compare | Сравнение двух периодов — по итогам или построчно по источникам, устройствам, страницам |
metrika_report | Любой отчёт: свои метрики, измерения и фильтры |
metrika_counters | Какие счётчики доступны |
Вебмастер
webmaster_summary | ИКС, страниц в поиске, исключено, активные проблемы |
webmaster_queries | Поисковые запросы: показы, клики, средняя позиция |
webmaster_indexing | Как менялось число страниц в поиске |
webmaster_sitemaps | Какие карты сайта видит Яндекс и есть ли в них ошибки |
webmaster_recrawl | Поставить страницы на переобход. Единственное действие, а не чтение — требует явного подтверждения |
Директ и Вордстат
direct_campaigns | Кампании и остаток баллов API |
direct_report | Расход, показы, клики, CTR — по кампаниям, объявлениям, группам или запросам |
wordstat_phrases | Частотности: сколько раз в месяц ищут фразу и что ищут вместе с ней |
Подключение
yandex_login | Начать вход — выдаёт ссылку |
yandex_submit_code | Завершить вход — принимает код |
yandex_auth_status | Что подключено и когда истекает |
Скиллы
Ставятся вместе с плагином Claude Code:
/yandex-mcp:site-weekly | Недельный отчёт по сайту: трафик, источники, поиск, реклама — и что делать |
/yandex-mcp:seo-opportunities | Запросы на границе топа: где до первой страницы осталось немного |
Где лежит токен
Ничего настраивать не нужно — подходящее хранилище выбирается само. Форсировать можно переменной YANDEX_MCP_KEYSTORE.
Записи лежат под общим префиксом, чтобы logout не задел чужое:
yandex-mcp-token общий токен
yandex-mcp-metrika-token токен одного сервиса, если нужен узкий доступ yandex-mcp-client-id ID приложения Яндекса
Токен можно передать и напрямую, минуя хранилище: YANDEX_MCP_SECRET_TOKEN для общего, YANDEX_MCP_SECRET_METRIKA_TOKEN для узкого. Так удобно в Docker и CI.
Почему 15 инструментов, а не 130
Описания всех инструментов уходят в контекст модели при каждом запросе, пока сервер подключён. Здесь это около 1 800 токенов. У серверов со 130–150 инструментами — за 40 000, и это постоянный налог на каждый диалог.
Оставлено то, на что реально смотрят: цифры и их динамика. Управлять кампаниями и ставками отсюда нельзя — для этого есть кабинет Директа, и цена ошибки там другая.
Переменные окружения
| Переменная | Зачем |
|---|---|
YANDEX_MCP_DEFAULT_COUNTER | Счётчик Метрики по умолчанию |
YANDEX_MCP_CLIENT_ID | ID приложения Яндекса, если не хочешь держать его в хранилище |
YANDEX_MCP_KEYSTORE | keychain, secret-tool или file — выбрать хранилище вручную |
YANDEX_MCP_SECRET_TOKEN | Готовый токен мимо хранилища (Docker, CI) |
YANDEX_MCP_DIRECT_SANDBOX | 1 — Директ отвечает из песочницы, баллы API не тратятся |
YANDEX_MCP_DIRECT_CLIENT_LOGIN | Логин клиента для агентских аккаунтов |
YANDEX_MCP_WORDSTAT_WAIT | Сколько секунд ждать отчёт Вордстата, по умолчанию 170 |
О чём стоит знать
- Инструменты Директа и Вордстата требуют одобренной заявки на API Директа. До неё Директ отвечает ошибкой 58.
- Отчёт Вордстата готовится у Яндекса около трёх минут. Если вернулось «ещё готовится» — повтори запрос с теми же фразами, готовый результат подхватится сразу.
- Отчёт Директа тоже может готовиться минутами. Сервер ждёт сам, но в очереди Яндекса помещается не больше пяти таких отчётов на аккаунт.
- Переобход страниц ограничен: 20 URL за вызов при суточной квоте 150 на сайт.
- Ответ обрезается на 20 000 символах. Для больших выгрузок сужай период.
- Токен живёт около полугода, потом нужно войти заново. Обновлять его автоматически Яндекс разрешает только приложениям с паролем, а у PKCE-приложения его нет.
- Там, где системного хранилища нет (Windows, сервер без графики, контейнер), токен лежит в файле с правами
0600— как~/.aws/credentialsили SSH-ключ без пароля.
Безопасность
Токен не появляется ни в ответе инструмента, ни в тексте ошибки: есть отдельный фильтр, вычищающий его из любого текста. status показывает только отпечаток.
Почти всё — чтение. Единственное изменяющее действие, переобход страниц, требует явного подтверждения в аргументах вызова.
Данные из API считаются недоверенными: поисковые фразы, UTM-метки и названия кампаний пишут посторонние люди. К каждому ответу добавляется пометка, что это данные для анализа, а не инструкции агенту.
Разработка
pip install -e ".[dev]"
pytest
Тесты не ходят в сеть и не трогают системное хранилище. CI гоняет их на Linux, macOS и Windows, на Python от 3.8 до 3.14.
src/yandex_mcp/
cli.py точка входа: без аргументов сервер, с аргументами настройка server.py JSON-RPC поверх stdio registry.py сборка списка инструментов httpclient.py запросы к Яндексу scrub.py вычищение секретов из ответов auth/ хранилище, токены, вход по PKCE tools/ по модулю на сервис
Код лежит в src/, чтобы import yandex_mcp брал установленный пакет, а не случайно подхваченную рабочую директорию — иначе тесты могут проходить на коде, которого нет в собранном колесе.
Диаграммы в docs/ собираются из scripts/make_diagrams.py, а scripts/check_metadata.py следит, чтобы README не разошёлся с кодом: версии, список инструментов и переменные окружения проверяются на каждом прогоне CI.
Лицензия
MIT