Я дал нейросети прямой доступ к Поиску и Вебмастеру Яндекса. Рассказываю, как это настроить — и что она нашла на моём сайте

Языковая модель не видит вашу выдачу и не знает ваших данных — она их додумывает. Я подключил AI-агента напрямую к инструментам Яндекса через открытый набор MCP-серверов и прогнал по реальному сайту. Ниже — пошаговая настройка, живой прогон с цифрами из API и честный момент, где инструмент отказался работать.

Спросите любую большую модель — ChatGPT, Claude, — кто сейчас в топе Яндекса по вашему запросу. Она уверенно ответит, и доверять этому нельзя: в момент ответа модель не ходит в поиск, а воспроизводит картину из обучающей выборки двух-трёхлетней давности. Где у неё есть веб-поиск — она обычно работает с западным индексом, а не с выдачей Яндекса. Для Рунета такая оценка почти бесполезна.

То же со всем остальным. О частотности модель скажет, что запрос популярный, — а в Вордстате у него шестьдесят показов. Об индексации посоветует проверить robots.txt. О трафике конкретного сайта не знает ничего. Между моделью и реальными данными просто нет канала.

Я как раз строю этот канал — мы делаем «Сейка AI» (seyka.ru), SEO-ассистента для Рунета, — поэтому покажу на практике, что меняется, когда нейросеть получает прямой доступ к Поиску, Вордстату, Вебмастеру и Метрике Яндекса. Без хайпа: настройка по шагам, живой прогон и границы метода.

Сниму главное возражение. Это не про автогенерацию контента — дискуссия о её рисках ведётся давно и не здесь. Задача другая: сбор и анализ данных, та рутина, которую вручную делаешь каждый день — выгрузить частотности, проверить индексацию, оценить выдачу, свести цифры воедино. Её и можно отдать агенту, оставив выводы за собой. Отличие от «спросить у ChatGPT» одно: между моделью и API Яндекса появляется посредник — модель сама ходит за актуальными данными и рассуждает на них, а не на догадках. Технология называется MCP.

Набор yandex-tools-mcp лежит на GitHub под лицензией MIT, ставится из npm и бесплатен. Четыре сервера:

СерверДоступ к даннымnpmЯндекс.Поискживая выдача из индекса Яндексаyandex-search-mcpВордстатчастотности, динамика спроса, разбивка по регионамyandex-wordstat-mcpВебмастериндексация, ИКС, диагностика, запросы, ссылкиyandex-webmaster-mcpМетрикатрафик, источники, поисковые фразы, географияyandex-metrika-mcp

Код открыт — недостающее можно дописать самому или прислать pull request. Это не единственная реализация: для Вебмастера, например, есть независимый сервер другого разработчика, @theyahia/yandex-webmaster-mcp (13 инструментов, тоже MIT). Принцип у всех общий — выбор за вами.

MCP (Model Context Protocol) — открытый стандарт, позволяющий AI-агенту вызывать внешние инструменты. Агенту один раз описывают доступные функции (например, что у «сервера Вордстата» есть методы для частотности, динамики и регионов), дальше он сам решает, когда их вызвать, и продолжает работу на фактах. Важное: MCP-сервер не привязан к конкретному чат-боту. Это универсальный адаптер — настраиваете единожды, работает одинаково в Claude Code, Cursor, Codex. Повторять настройку под каждую модель не нужно.

Шаг 1. Учётные данные. Поиск и Вордстат работают на ключах Яндекс Облака: создаёте сервисный аккаунт, назначаете ему роль для Search API, генерируете API-ключ и берёте идентификатор каталога (YANDEX_FOLDER_ID). Вебмастер и Метрика — на OAuth-токенах с oauth.yandex.ru. Про бюджет: Вордстат переехал в Яндекс Облако, стал частью поисковых инструментов и теперь платный — отсюда и ключ Облака. Актуальные тарифы и квоты уточняйте в документации Облака: цифры меняются.

Шаг 2. Установка (Claude Code, упрощённый способ). Один плагин ставит все четыре сервера. Вместе с ними подключаются два готовых навыка — yandex-keyword-research и yandex-competitive-analysis, — они срабатывают автоматически на запросах по семантике и конкурентам:

export YANDEX_SEARCH_API_KEY=ваш_ключ # используется и Вордстатом export YANDEX_FOLDER_ID=ваш_folder_id # используется и Вордстатом export YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен export YANDEX_METRIKA_TOKEN=ваш_oauth_токен claude --plugin-dir /путь/к/yandex-tools-mcp

Шаг 3 (альтернатива). Один сервер вручную. Если нужен только Поиск — прописываете его в конфиг MCP-серверов:

{ "mcpServers": { "yandex-search": { "command": "npx", "args": ["-y", "yandex-search-mcp"], "env": { "YANDEX_SEARCH_API_KEY": "ваш_ключ", "YANDEX_FOLDER_ID": "ваш_folder_id" } } } }

Другие редакторы. MCP — стандарт, серверы запускаются не только в Claude Code, различается лишь форма записи (ограничения по оплате из России, о них ниже, при этом общие).

Codex, ~/.codex/config.toml:

[mcp_servers.yandex-search] command = "npx" args = ["-y", "yandex-search-mcp"] env = { YANDEX_SEARCH_API_KEY = "ваш_ключ", YANDEX_FOLDER_ID = "ваш_folder_id" }

Cursor, ~/.cursor/mcp.json:

{ "mcpServers": { "yandex-search": { "command": "npx", "args": ["-y", "yandex-search-mcp"], "env": { "YANDEX_SEARCH_API_KEY": "ваш_ключ", "YANDEX_FOLDER_ID": "ваш_folder_id" } } } }

OpenCode, opencode.json:

{ "$schema": "https://opencode.ai/config.json", "mcp": { "yandex-search": { "type": "local", "command": ["npx", "-y", "yandex-search-mcp"], "environment": { "YANDEX_SEARCH_API_KEY": "ваш_ключ", "YANDEX_FOLDER_ID": "ваш_folder_id" } } } }

Готовый плагин с навыками пока есть только для Claude Code. В остальных редакторах подключаются сами серверы — работают так же, но без коробочных сценариев.

Оговорка про оплату из России. Скажу прямо, обойти её нельзя. Оплатить Claude из России официально не выйдет: карты российских банков и «Мир» отклоняются. Рабочие варианты — зарубежная карта (Казахстан, Армения, Турция) или платёжные посредники. Переход на Cursor, Codex или OpenCode проблему не снимает: у каждого свои провайдеры и свои ограничения. Если зарубежной карты нет — разумнее сразу смотреть в сторону готового размещённого решения (о нём в конце), где вопрос оплаты снят.

Лучше один реальный прогон, чем абстракция. Взял сайт redirekto.ru (онлайн-инструменты для работы с редиректами) и прогнал его через наш стек. Цифры ниже — как их вернули API, без правок. Запрос сформулировал одной фразой, инструменты не называл:

Запрос: Посмотри, кто сейчас реально в топ-10 Яндекса по запросу «проверить редиректы онлайн». Собери в Вордстате частотности и сезонность по теме, а потом сверь с моим сайтом redirekto.ru по Вебмастеру — на каких я позициях и чего мне не хватает, чтобы подняться.

Агент сам разложил это на подзадачи: подключил навык competitive-analysis и параллельно пошёл в Поиск, Вордстат и Вебмастер. Что вернул.

Живая выдача (Поиск). Топ-10 на 100% занят специализированными tool-страницами «redirect checker» — ru.inettools.net, 101ip.ru, sitevisor.cloud, raskruty.ru, timbrica.com и другие. Информационных статей в топе нет: интент сугубо инструментальный — пользователю нужен сервис, который трассирует цепочку, показывает коды 301/302/307/308 и конечный URL. redirekto.ru в топ-10 отсутствует. Это оценка сегодняшней выдачи, а не памяти модели, — ровно то, чего лишён обычный чат-бот.

Положение сайта (Вебмастер, данные за неделю). По тематическим запросам redirekto.ru держится на краю первой страницы и почти без переходов:

ЗапросСр. позицияПоказыКликипроверить редирект онлайн~1020цепочка редиректов онлайн~9,520проверить редирект страницы~1010онлайн определение редиректов~1110

Клики идут практически только по брендовым запросам. Технических ошибок диагностика не нашла, в индексе 78 страниц, но ИКС равен 20 — низкий показатель, и именно он выступает потолком.

Вывод агента. Налицо рассогласование интента: судя по запросам в Вебмастере, redirekto.ru — прежде всего сервис создания редиректов и коротких ссылок, тогда как топ по «проверить редиректы онлайн» держат чекеры. Приоритеты, которые он предложил: довести страницу-чекер до паритета по функциям с лидерами; вписать целевой запрос во множественном числе в Title/H1/URL (сейчас сайт ранжируется по единственному); поработать над сниппетом и CTR (на позициях ~9–10 клики нулевые); и стратегически — наращивать ИКС, потому что при значении 20 конкурировать с профильными доменами тяжело.

Ничего сверхъестественного агент не изобрёл — но собрал это из реальных цифр за пару минут, а не из догадок, и не заставил меня руками лазить по трём разным интерфейсам.

Отдельно про то, что пошло не по плану, — честный провал говорит о методе больше, чем гладкий кейс. Запрос частотностей и сезонности в Вордстате упёрся в часовой лимит квоты: API вернул ошибку, и агент об этом честно сообщил, предложив повторить позже, — а не выдумал цифры. Это и есть нормальная работа с реальным источником: где данных нет, там их нет. Модель без доступа к API на этом месте с удовольствием сочинила бы правдоподобные числа, и вы бы даже не узнали.

Чтобы ожидания были трезвыми — про ограничения прямо. Агент по-прежнему склонен к домыслам при нехватке данных: доступ к реальным API этот риск сильно снижает, но не обнуляет, выводы надо проверять. Лимиты и квоты никуда не деваются — Вордстат отказал по часовой квоте на первой же серии, так что массовый сбор на тысячи ключей так не сделать. И глубину специализированных парсеров (Key Collector, Topvisor, Rush Analytics, Just-Magic) по сбору и кластеризации больших ядер MCP-агент не воспроизводит — за ними годы отточенной механики.

Правильнее смотреть на агента как на связующее звено между API Яндекса и специалистом: он снимает рутину сбора и сведения данных и даёт работать с актуальными цифрами в диалоге. Тяжёлый продакшн-сбор остаётся за профильным софтом — и это нормально.

Разворачивать Яндекс Облако, заводить сервисные аккаунты и решать вопрос с оплатой Claude оправдано не под каждую задачу. Когда нужен результат без этих издержек — Поиск и Вордстат уже доступны в размещённом виде в «Сейка AI» на seyka.ru: бесплатно, без регистрации и возни с ключами. Там же есть то, чего в наборе нет, — диагностика домена (DNS/WHOIS/SSL, редиректы), оценка краулабельности, разбор страницы и Core Web Vitals; Вебмастер и Метрика заявлены в премиум-доступе. Итого: нужны бесплатные Вебмастер и Метрика уже сейчас — берите путь через MCP из этой статьи; достаточно Поиска и Вордстата и важен быстрый старт — есть готовое решение.

Весь инструментарий — открытый код под лицензией MIT: github.com/altrr2/yandex-tools-mcp. Дополнения и pull request приветствуются.