YaAll MCP Server

YaAll

Весь яндексовский слой для MCP в одном репозитории: десять своих MCP-серверов (134 инструмента), четыре набора скиллов Claude Code и материалы двух официальных наборов серверов от Яндекса.

Это канон для всего, что лежит в mcp/ и skills/. Отдельные репозитории, из которых часть этого собрана, заархивированы и указывают сюда. Разработка идёт здесь, обычными коммитами: ни сабмодулей, ни сабтри — просто файлы.

---

Что это и кому нужно

MCP (Model Context Protocol) — способ дать ИИ-ассистенту прямой доступ к внешнему API. Эти серверы подключают Claude, Cursor, VS Code и любой другой MCP-клиент к сервисам Яндекса: рекламе, аналитике, поиску, задачам, почте, картам и речи. Спрашиваете словами — ассистент сам дёргает нужный метод API.

Кому	Что закрывает
PPC-специалист, агентство	Яндекс.Директ — кампании, объявления, ключевые слова, ставки, минус-фразы, статистика, баланс (48 инструментов, есть песочница)
SEO-специалист	Яндекс.Вебмастер — индексация, переобход, поисковые запросы, карты сайта. Wordstat — частотность, регионы, сезонность. Плюс аудит по ЭПОС: попадут ли страницы в ответы Алисы и Yandex AI Search
Аналитик, маркетолог	Яндекс.Метрика — счётчики, цели, отчёты, источники трафика, топ страниц. AppMetrica — мобильная аналитика, когорты, пуши
Продакт, руководитель	Яндекс.Трекер — задачи, очереди, ворклоги, доски
Разработчик	YandexGPT (генерация, эмбеддинги), SpeechKit (речь ↔ текст), Яндекс.Карты (геокодинг, маршруты), Яндекс 360 (почта, календарь, диск)

Всё ставится через npx, ключи — свои, данные никуда не уходят: серверы ходят напрямую в API Яндекса с вашего компьютера.

In English: MCP servers for Yandex APIs — Direct (ads), Metrica (analytics), Webmaster (search console), Wordstat (keyword statistics), Tracker, 360, Maps, SpeechKit, YandexGPT, AppMetrica. Ten servers, 134 tools, MIT-licensed, published to npm under @theyahia/*.

---

Быстрый старт

Все свои серверы опубликованы в npm и запускаются без установки:

// ~/.claude.json  или  claude_desktop_config.json
{
  "mcpServers": {
    "yandex-direct":  { "command": "npx", "args": ["-y", "@theyahia/yandex-direct-mcp"],
                        "env": { "YANDEX_DIRECT_TOKEN": "..." } },
    "yandex-metrika": { "command": "npx", "args": ["-y", "@theyahia/yandex-metrika-mcp"],
                        "env": { "YANDEX_METRIKA_TOKEN": "..." } }
  }
}

Переменные окружения у каждого сервера свои — точный список в его README.md. Скиллы из skills/ копируются в ~/.claude/skills/ и вызываются как /имя-скилла.

---

mcp/ — свои MCP-серверы, MIT

Каталог	Инструментов	Версия	Что делает
yandex-direct-mcp	48	5.0.0	Директ: кампании, стратегии, группы, объявления, ключевые слова, ставки и корректировки, минус-фразы, быстрые ссылки и уточнения, изображения, аудитории и динамические цели, фиды, визитки, поисковые запросы, статистика, баланс. Ввод-вывод в рублях, поддержка песочницы, ID без потери точности
yandex-metrika-mcp	15	2.1.1	Метрика: счётчики, цели, отчёты, логи, источники трафика, топ страниц
yandex-webmaster-mcp	13	2.0.0	Вебмастер: хосты, поисковые запросы, индексация, переобход, карты сайта, диагностика
yandex-tracker-mcp	14	1.1.0	Трекер: задачи, очереди, права доступа к очереди, ворклоги, доски
yandex-360-mcp	10	1.0.1	Яндекс 360: почта, календарь, диск, пользователи
yandex-maps-mcp	10	1.0.1	Карты: геокодинг, маршруты, поиск мест
appmetrica-mcp	8	1.0.1	AppMetrica: мобильная аналитика, когорты, пуши
yandexgpt-mcp	8	3.0.1	YandexGPT: генерация, эмбеддинги, суммаризация
yandex-speechkit-mcp	5	1.1.0	SpeechKit: распознавание и синтез речи
yandex-search-mcp	3	1.0.0	Wordstat: topRequests, regions, dynamics — статистика поисковых запросов

Все опубликованы в npm под @theyahia/*.

yandex-search-mcp стоит отдельного слова. Статистики поисковых запросов нет ни в одном официальном сервере Яндекса: оба его поисковых сервера отдают только веб-поиск, то есть «найди страницы в интернете». Wordstat при этом живёт в том же Search API — эндпоинт v2/wordstat/topRequests, тот же ключ и тот же каталог. Яндекс просто не завернул его в MCP; этот сервер закрывает пробел.

skills/ — скиллы Claude Code, MIT

Каталог	Что делает
yageo/	Аудит сайта по ЭПОС — Экспертность, Полезность, Оригинальность, Содержательность. Оценивает, попадут ли страницы в ответы Алисы и Yandex AI Search. Есть свой MCP-сервер (scripts/mcp_server.py) и плагин Claude Code. Скорер разложен на подмодули _epos_*, _jsonld_*, _crawler_* за фасадами epos_scorer.py, json_ld_validator.py, yandex_crawler_check.py; конфигурация вынесена в yageo/epos_config.toml. Тринадцать тестов, четыре субагента, пять JSON-LD-схем под РФ. Требует Python ≥3.12, см. pyproject.toml
wordstat-sweep/	Два режима поверх Wordstat API. Gate — валидация спроса под нишу до разработки, вердикт GO / MAYBE-PILOT / RED/PIVOT по объёму top-3 seed-фраз, голая стандартная библиотека. SEO-ядро — collect_semantics.py, сборка семантики перед написанием контента
yageo-audit/	Прогон уже задеплоенного сайта через ЭПОС-скорер, yageo_gate.py. Парный к wordstat-sweep: тот работает до контента, этот после деплоя
mcp-skills-yandex/	Девять готовых сценариев поверх серверов выше: аудит Директа, SEO-аудит, недельный отчёт по трафику, ROI, описания товаров, голосовой бот, генерация контента, суммаризация документов, расшифровка звонков

upstream/ — материалы Яндекса, Apache 2.0

Каталог	Что это	Канон
yandex-cloud-mcp/	Документация десяти хостовых MCP-серверов Yandex Cloud: apigateway, containers, datacatalog-consumer, documentation, functions, mcpgateway, search, toolkit, triggers, workflows. Исходников в репозитории Яндекса нет — серверы работают на его стороне, доступ через клиент @yandex-cloud/mcp или streamable HTTP	yandex-cloud/mcp
yandex-search-mcp-server/	Отдельный сервер Yandex Search API на питоне. Два инструмента: ai_search_with_yazeka и web_search; в README самого Яндекса они названы *_post, это опечатка апстрима. Есть remote-подключение по SSE — ключ и каталог передаются заголовками	yandex/yandex-search-mcp-server

Здесь канон не переезжает: репозитории принадлежат Яндексу, он продолжает их развивать. В upstream/ лежит снимок на дату из ИСТОЧНИКИ.md. Править его на месте бессмысленно — правка исчезнет при следующем обновлении снимка. Нужно поправить код Яндекса — pull request в его репозиторий.

---

Ключи и доступы

Общего ключа на всю сборку нет, и это главный источник путаницы. Три разных механизма:

Что	Как авторизуется
skills/wordstat-sweep, skills/yageo-audit	YANDEX_SEARCH_API_KEY + YANDEX_FOLDER_ID
upstream/yandex-search-mcp-server	Те же значения, но переменные называются SEARCH_API_KEY и FOLDER_ID — без префикса YANDEX_. В remote-режиме вместо них заголовки ApiKey и FolderId
upstream/yandex-cloud-mcp	Ключом не пользуется вовсе: OAuth в браузере по умолчанию, либо yc CLI, либо IAM-токен в Authorization: Bearer плюс заголовок Folder-Id
mcp/*	У каждого свой токен продукта — Директа, Метрики, Вебмастера и так далее. См. README.md внутри каталога

Роль сервисного аккаунта тоже зависит от того, чем пользуешься, и одного правильного ответа нет: wordstat-sweep требует search-api.executor, документация Яндекса к yandex-search-mcp-server называет search-api.editor и scope yc.search-api.execute, а его же search-mcp-server в Yandex Cloud — search-api.webSearch.user.

Частая диагностика: HTTP 403 Permission denied в Search API чаще означает, что на платёжном аккаунте нет денег, а не что роли не хватает.

Что сознательно вне сборки

• Свой theYahia/yandex-cloud-mcp. Имя в точности совпадает с каталогом upstream/yandex-cloud-mcp, который на самом деле от yandex-cloud/mcp. Два одноимённых каталога породили бы вопрос «какой канон» — ровно ту болезнь, от которой эта сборка лечит. Официальные десять серверов уже здесь.
• WWmcp — экосистема из 46 MCP-серверов для развивающихся рынков. Яндекс там один вендор из многих; сюда приехал только servers/yandex-search.
• Остальные 31 скилл из theYahia/mcp-skills — не про Яндекс.

Лицензии

Сборка, mcp/ и skills/ — MIT, см. LICENSE. Материалы Яндекса в upstream/ — Apache 2.0, LICENSE-файлы сохранены внутри каждого каталога, атрибуция в NOTICE. Ни один LICENSE не удалён и не переписан, изменений в код Яндекса не вносилось.

Происхождение каждого каталога, точные коммиты снимков и порядок обновления — в ИСТОЧНИКИ.md.

Правки

Правки в mcp/ и skills/ — обычным pull request сюда. Правки в upstream/ не принимаются: это чужой код, изменения затрутся при следующем обновлении снимка. Нашли баг у Яндекса — заводите issue в его репозитории по ссылке из таблицы.

---

Часть WWmcp · Telegram: @vhodvai