プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Yandex Analytics

作者:nozikovバージョン 2.1.0i★ –iパソコンで動く
レジストリ名io.github.nozikov/yandex-mcp

インストール

概要

作者による説明(英語の原文)

Read-only Yandex analytics for AI agents: Metrika, Webmaster, Direct and Wordstat.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: 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で開く

または、設定を自分でコピーする

プロジェクトの .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"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .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_COUNTER env
    Metrika counter id used when a tool call omits counter_id
  • YANDEX_MCP_CLIENT_ID env
    Yandex 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.

作者:surendranb成長中↓ 1088/週★ 24411 日前更新

パソコンで動く

作者の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/callbackyandex-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_IDID приложения Яндекса, если не хочешь держать его в хранилище
YANDEX_MCP_KEYSTOREkeychain, secret-tool или file — выбрать хранилище вручную
YANDEX_MCP_SECRET_TOKENГотовый токен мимо хранилища (Docker, CI)
YANDEX_MCP_DIRECT_SANDBOX1 — Директ отвечает из песочницы, баллы 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

PopNxに聞く