Yandex Analytics

Name: Yandex Analytics
Author: nozikov

โดย nozikovรุ่น 2.1.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.nozikov/yandex-mcp

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

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

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: การตลาดและโซเชียล

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: YANDEX_MCP_DEFAULT_COUNTER, YANDEX_MCP_CLIENT_ID

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "yandex": {
      "command": "uvx",
      "args": [
        "yandex-mcp"
      ],
      "env": {
        "YANDEX_MCP_DEFAULT_COUNTER": "ใส่ค่าของคุณ",
        "YANDEX_MCP_CLIENT_ID": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add yandex --env YANDEX_MCP_DEFAULT_COUNTER='ใส่ค่าของคุณ' --env YANDEX_MCP_CLIENT_ID='ใส่ค่าของคุณ' -- uvx yandex-mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "yandex": {
      "command": "uvx",
      "args": [
        "yandex-mcp"
      ],
      "env": {
        "YANDEX_MCP_DEFAULT_COUNTER": "ใส่ค่าของคุณ",
        "YANDEX_MCP_CLIENT_ID": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "yandex": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yandex-mcp"
      ],
      "env": {
        "YANDEX_MCP_DEFAULT_COUNTER": "ใส่ค่าของคุณ",
        "YANDEX_MCP_CLIENT_ID": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

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

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub nozikov ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi

ดาวมากกว่า 0% ของอีก 3577 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 31% ของอีก 3577 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 3577 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Yandex Analytics ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (2.1.0) เข้า registry 2 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

MCP YouTube Transcript

โดย jkawamoto

An MCP server retrieving transcripts of YouTube videos

รันบนเครื่อง★ 495MITอัปเดต 11 วันที่ผ่านมา

ติดตั้ง

Google Analytics MCP

โดย surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

รันบนเครื่อง★ 244MITอัปเดต 10 วันที่ผ่านมา

ติดตั้ง

BibiGPT YouTube Video Summarizer

โดย JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

รันบนคลาวด์★ 137MITอัปเดต 11 วันที่ผ่านมา

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ 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

Yandex Analytics

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

README จากผู้ทำ

yandex-mcp

Как это работает

Установка

Вход

Что умеет

Скиллы

Где лежит токен

Почему 15 инструментов, а не 130

Переменные окружения

О чём стоит знать

Безопасность

Разработка

Лицензия