yaseo
yaseo is an MCP server for SEO and AI-search visibility analysis, planning, and tracking for a website.
Check configuration, keys, providers, and stored data (
whoami,geo_providers,get_storage_stats).Research keywords and demand via Wordstat (
research_keywords,get_keyword_metrics,expand_query_pool).Analyze Yandex SERPs, competitors, and query competition (
get_serp_results,find_serp_competitors,get_competition,get_competitor_keywords).Build content briefs for articles (
build_brief).Track positions over time and review history (
track_query,run_tracking,get_positions,get_position_history).Audit technical SEO and monitor blog article performance (
audit_site,check_articles,get_article_effectiveness).Generate prioritized site-fix plans with evidence, instructions, and verification steps (
get_action_plan).Assess AI-search readiness and citation visibility (
geo_readiness,geo_check_visibility,geo_history).Use many checks for free/local data; paid Yandex, Wordstat, and AI-provider calls include cost estimates and safety caps.
Provides AI-search visibility checks for OpenAI, verifying whether a site is cited in OpenAI's generative answers and identifying cited URLs and competing sites.
Provides AI-search visibility checks for Perplexity, verifying whether a site is cited in Perplexity's generative answers and identifying cited URLs and competing sites.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yaseo Check example.ru's AI search visibility"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Русский · English
yaseo
Напишите Claude «Проверь сайт example.ru» и получите план: что поправить на сайте, в каком порядке и на каком основании.
Бесплатный плагин yaseo для Claude Code показывает сайт с двух сторон: каким его видит Яндекс и каким его видят ИИ-поиски. Сделан для маркетологов и владельцев бизнеса, которые уже работают в Claude Code.

Первая проверка без ключей
Для первой проверки не нужны ни ключи, ни карта.
Поставьте Claude Code и uv.
В Claude Code введите по очереди две команды:
/plugin marketplace add https://github.com/novyiblog-tech/yaseo.git/plugin install yaseo@yaseoНапишите Claude:
Проверь сайт example.ru
Claude обойдёт до 30 страниц, посмотрит, пускает ли сайт ботов ИИ-поиска, и соберёт план правок. Денег это не стоит: yaseo обращается только к вашему сайту.
Если терминал для вас в новинку, есть инструкция с проверкой после каждого шага: docs/INSTALL.md.
Related MCP server: yandex-searchapi-mcp
Что вы получите
План правок
Ради него всё и затевалось. В каждом пункте плана есть страница, что на ней сейчас (цитата или число с датой замера), что сделать, готовая инструкция для Claude или разработчика и способ проверить результат. Порядок задают правила: сначала всё, что мешает индексации, потом страницы, которым до верха выдачи осталось немного. Роста позиций план не обещает.
Если у Claude есть доступ к коду сайта, он выполнит пункт сразу. Сначала покажет, что поменяет, и сохранит только после вашего согласия.
Каким вас видит Яндекс
Технический аудит: индексация, битые ссылки, редиректы, title и description, canonical, разметка, перелинковка.
Позиции по вашим запросам с историей замеров: что выросло и что просело.
Спрос по Wordstat и подбор запросов для раздела сайта.
Живая выдача, конкуренты в топе и запросы, по которым они есть в выдаче, а вас там нет.
Бриф статьи по составу топа. Проверка, та ли страница сайта вышла по запросу статьи.
Показы и клики из Вебмастера, поведение из Метрики. Эти отчёты пока запускаются из терминала.
Каким вас видят ИИ-поиски
Готовность сайта: пускает ли robots.txt ботов ИИ-поиска, есть ли
llms.txtи разметка JSON-LD. Бесплатно, без ключей.Цитирование: ссылаются ли на ваш сайт генеративный ответ Яндекса, Perplexity, OpenAI, Gemini и Claude, каким адресом и кого называют вместо вас. Проверки копятся в истории.
Когда нужны ключи
Аудит, готовность к ИИ-поиску и план работают без ключей. Позиции, выдачу, Wordstat и генеративный ответ yaseo берёт из официального Yandex Search API. Для них нужен ключ Yandex AI Studio с привязанной картой. Как его получить: INSTALL.md, шаг 5. Где лежат ключи и как их сменить: docs/KEYS.md.
Ключи вписываются одной командой в терминале:
uvx --from git+https://github.com/novyiblog-tech/yaseo@v0.1.7 yaseo initЗа обращения платите вы, по прайсу Яндекса: https://aistudio.yandex.ru/ru/docs/search-api/pricing. Перед платным шагом Claude называет, сколько будет обращений, и ждёт вашего «да». Дороже всего генеративный ответ Яндекса: на 16.09.2026 это 5 080 ₽ за 1 000 запросов. Ключи Perplexity, OpenAI, Gemini и Claude добавляются по желанию, платите по своему тарифу у провайдера.
Сам yaseo бесплатный. Код открыт, лицензия MIT.
О чём можно попросить
Проверь сайт example.ruДай план, как поднять позиции example.ruСобери семантику для раздела «ремонт квартир»Подготовь бриф статьи под запрос «как выбрать ламинат»Какие у нас позиции и что изменилось?Цитирует ли ИИ-поиск example.ru по запросу «где заказать ремонт»?Дальше подробности для тех, кому интересно, как всё устроено.
Как устроен
Данные Яндекса приходят от самого Яндекса, через официальный Yandex Search API. Регион по умолчанию: вся Россия.
Выдача по одному запросу скачет: три запроса подряд могут дать 11, 6 и 5 место. Поэтому запрос, который уже бывал в топе, трекер снимает три раза и записывает медиану. Запрос, которого в топе не было, снимается один раз: ещё два «нет в топе» ничего бы не добавили. Трекер смотрит топ-10.
У каждого вывода есть доказательство. Если источник промолчал, yaseo пишет «нет данных» и число не подставляет.
Всё накопленное лежит у вас, в локальной базе SQLite.
MCP-сервер написан на Python и обходится стандартной библиотекой, внешних зависимостей нет.
Другие способы установки
Плагин из раздела выше подключает MCP-сервер yaseo и семь скиллов: yaseo-setup, seo-site-check, keyword-research, position-tracking, content-brief, improve-positions, ai-visibility. Сервер запускается командой uvx --from git+https://github.com/novyiblog-tech/yaseo@v0.1.7 yaseo-mcp, поэтому без uv он не поднимется.
Только MCP-сервер
Для Claude Code без плагина:
claude mcp add --transport stdio yaseo -- uvx --from git+https://github.com/novyiblog-tech/yaseo@v0.1.7 yaseo-mcpВ другом MCP-клиенте укажите команду uvx с аргументами --from git+https://github.com/novyiblog-tech/yaseo@v0.1.7 yaseo-mcp.
Команда yaseo в терминале насовсем:
uv tool install git+https://github.com/novyiblog-tech/yaseo@v0.1.7
yaseo --helpИз исходников
git clone https://github.com/novyiblog-tech/yaseo
cd yaseo
uv run yaseo --help
uv run yaseo-mcp < /dev/null # сервер стартует и сразу выходит: так проверяется запускСписок инструментов вручную:
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | uv run yaseo-mcpИнструменты MCP
В колонке «тратит» сказано, к какому платному API обращается инструмент и сколько раз за вызов. «Нет» значит, что инструмент читает локальную базу или ходит только на ваш сайт. Глубина выдачи набирается страницами по 10 результатов: топ-10 стоит одно обращение, топ-30 три, топ-50 (это предел) пять.
инструмент | что делает | тратит |
| откуда взяты ключи, чего не хватает, где база, какой домен по умолчанию | нет |
| расширить 1–5 фраз через Wordstat: частотность и связанные запросы | Wordstat, 1 на фразу |
| частотность и конкурентность, до 25 запросов | Wordstat и Search API, по 1 на запрос |
| живая выдача Яндекса по запросу | Search API, по страницам глубины |
| кто повторяется в выдаче по набору до 10 запросов | Search API, 1 на запрос |
| конкурентность с разбором по факторам и доказательствами | Search API, 1 на запрос |
| разведка перед статьёй: топ, форматы, разрывы, подзапросы | Wordstat 1, Search API по страницам глубины |
| кандидаты в пул отслеживания с причиной; запись при | Wordstat, 1 |
| поставить запросы на отслеживание или снять | нет |
| снять позиции и записать в историю. Останавливается до первого запроса, если обращений выйдет больше потолка | Search API, до 3 снимков на запрос × страницы глубины (для топ-10 одно обращение на снимок) |
| текущие позиции и изменение к прошлому замеру | нет |
| история позиций по запросу, динамика конкурентности | нет |
| где конкурент в топе, а вас нет, по накопленным снимкам | нет |
| технический аудит сайта; только http/https, внутренние адреса только с | нет |
| вышла ли по запросу именно эта статья блога. Останавливается до первого запроса, если обращений выйдет больше потолка | Search API, по страницам глубины на каждый уникальный запрос; общий запрос нескольких статей оплачивается один раз |
| отчёт по статьям и список каннибализаций | нет |
| что накоплено в базе | нет |
| план правок по приоритету: доказательство, инструкция для Claude, способ проверки | нет: ходит только на сам сайт, остальное берёт из базы |
| готовность сайта к ИИ-поиску; только http/https, внутренние адреса только с | нет |
| какие ИИ-провайдеры настроены и каких ключей не хватает | нет |
| цитирует ли ИИ-поиск сайт; без | только с |
| история проверок: доля цитирований, частые конкуренты | нет |
Смету в самом коде считают три инструмента. run_tracking и check_articles останавливаются до первого платного запроса, если выходят за потолок. geo_check_visibility без confirm=true ничего не тратит. Остальные платные инструменты (get_keyword_metrics, get_serp_results, find_serp_competitors, get_competition, build_brief, research_keywords, expand_query_pool) тратят сразу при вызове, и смету перед ними называет Claude по инструкции из скилла.
Провайдер yandex в geo_check_visibility означает генеративный ответ YandexGPT по результатам Поиска (POST /v2/gen/search в Yandex Search API). С «Нейро» и Алисой его путать не стоит. У каждого источника в ответе есть признак used, и показанный источник не всегда использован: в прогоне 16.09.2026 из пяти источников в ответ пошли три. Процитированным yaseo считает сайт, только если его источник использован.
Как собирается план
get_action_plan (в терминале yaseo plan --domain example.ru) строит список правок из того, что уже измерено или проверяется бесплатно: технического аудита, готовности к ИИ-поиску, истории позиций, выгрузок Вебмастера, реестра статей и накопленных снимков выдачи. Платных запросов он не делает. Если каких-то данных нет, план называет инструмент, который их даст, и сколько это стоит.
Общего балла нет, порядок задают правила:
Индексация. Критичные находки аудита: страница не отдаётся, битая внутренняя ссылка, цепочка редиректов, noindex или Disallow у адреса из sitemap.xml. Сюда же robots.txt, который не отдаётся.
Быстрые выигрыши. Запрос уже показывается, но не на верхних местах: по Вебмастеру средняя позиция 4–15, по трекеру позиция 4–10 (трекер снимает топ-10, и спрос по запросу должен быть известен). Страницу доводят под запрос, текущие title и H1 приводятся цитатой.
Сниппет. Не меньше 30 показов, ноль кликов, позиция не ниже 10-й.
Каннибализация. Две страницы сайта претендуют на один запрос.
ИИ-поиск. robots.txt закрывает ботов ИИ-поиска, нет
llms.txt, нет JSON-LD. Запрет для Google-Extended на Google Поиск не влияет, и план об этом пишет.Разрывы с конкурентами. Конкурент есть в накопленной выдаче по запросу с известной частотностью, а у сайта страницы под этот запрос нет.
Остальное. Прочие находки аудита, по одному пункту на каждый вид.
В каждом пункте указаны страница, что сейчас (цитата или число, источник, дата замера), что сделать, блок «Инструкция для Claude» для своего Claude или разработчика, как проверить результат и когда ждать эффекта. Позиции план предлагает переснимать не раньше срока из настроек трекера.
Параметры: domain, url (адрес для аудита), max_pages (по умолчанию 30), sections (какие разделы собрать), limit (по умолчанию 10 пунктов, остальные сворачиваются в счётчик по разделам) и fresh_audit. Если аудита в базе нет или ему больше 7 дней, он проводится заново и сохраняется.
Как разобрать план и выполнять его по пункту, описано в скилле improve-positions.
Настройки
переменная | что задаёт | по умолчанию |
| домен сайта для «наших» позиций | не задан; если в базе один проект, берётся его домен |
| путь к базе SQLite |
|
| свой файл с ключами | не задан |
|
|
|
| потолок обращений к Search API за один прогон позиций |
|
| сколько суток выжидать между прогонами по одному домену ( |
|
| файл настроек трекера |
|
| потолок обращений к Search API за прогон |
|
|
|
|
| свой файл тарифов для сметы | встроенный |
| цена одного обращения в рублях, для сметы | из |
Если заданы XDG_DATA_HOME и XDG_CONFIG_HOME, каталоги данных берутся оттуда.
Безопасность
Что заложено в код:
Содержимое сайтов и ответы ИИ-провайдеров выводятся отдельным подписанным блоком как данные. Инструкции внутри них Claude не выполняет.
Запросы с ключом или токеном идут только по https и не следуют за перенаправлениями, так что ключ не уедет на чужой домен. За этим следит общий сетевой слой
net.py.Сканер ходит только по http и https. На localhost и внутренние адреса (
10.0.0.0/8,192.168.0.0/16и подобные) он пойдёт только с вашего разрешения:YASEO_ALLOW_PRIVATE=1или флаг--allow-privateуyaseo auditиyaseo plan. Адреса-числа вроде127.0.0.1,[::1]и10.0.0.5отсекаются всегда. Имена сайтов проверяются по адресу, который вернул DNS. За прокси в режиме fake-ip (адреса198.18.0.0/15) такая проверка бессильна: любое имя получает подставной адрес.
Приватность
Куда уходят данные:
Яндекс (
searchapi.api.cloud.yandex.net): ваши запросы для Wordstat, выдачи и генеративного ответа, вместе с вашим ключом.Яндекс ID, Вебмастер и Метрика (
oauth.yandex.ru,api.webmaster.yandex.net,api-metrika.yandex.net), если вы подключили OAuth. Проверка токенаyaseo yandex --checkзаодно спрашивает API Директа (api.direct.yandex.com), открыт ли он этому токену.ИИ-провайдеры (
api.perplexity.ai,api.openai.com,generativelanguage.googleapis.com,api.anthropic.com), если вы положили их ключ, выбрали провайдера и подтвердили проверку. Уходит текст запроса. Ссылки-переадресации в источниках Gemini yaseo раскрывает запросомHEAD.Сайты, которые вы проверяете: аудит и проверка готовности читают их страницы.
Телеметрии нет. Кроме перечисленных адресов, yaseo никуда ничего не отправляет. Это видно по коду: все сетевые обращения идут через net.py, а зовут его только yandex_serp.py, wordstat_client.py, yandex_auth.py, audit.py, geo/providers.py и geo/readiness.py.
Что хранится у вас:
ключи:
~/.config/yaseo/.env, доступ только у владельца;база:
~/.local/share/yaseo/yaseo.db: снимки выдачи, позиции, статьи, ответы ИИ-провайдеров (текст и исходный ответ API);снапшоты Wordstat и отчёты: там же, в
~/.local/share/yaseo/.
Ключи ни в каком выводе не печатаются целиком.
Ограничения
Ссылок yaseo не видит, поэтому конкурентность считается только по составу выдачи.
Глубже топ-50 выдача не снимается. Для задач пакета дальние места ничего не решают, а каждые 10 мест стоят ещё одного платного обращения.
Wordstat принимает 100 запросов в час, большие списки придётся делить.
Ноль в Wordstat ещё не значит, что спроса нет: редкие формулировки Wordstat может не показать.
Генеративный ответ Яндекса дорогой и принимает не больше одного запроса в секунду.
Ответы ИИ меняются от раза к разу. Один прогон даёт снимок, картину дают повторы и история.
Вебмастер и Метрика пока доступны только из терминала.
Лимиты и цены Яндекса меняются, сверяйтесь с https://aistudio.yandex.ru/ru/docs/search-api/concepts/limits и https://aistudio.yandex.ru/ru/docs/search-api/pricing.
Лицензия
MIT, см. LICENSE.
Available Tools
22 toolsaudit_siteB
Технический аудит сайта: индексация, метаданные, заголовки, канонические адреса, разметка, перелинковка. Каждая находка с доказательством.
Inputs: url (required), max_pages.
build_briefA
Разведка перед написанием статьи: частотность, конкурентность, состав топ-10, повторяющиеся форматы заголовков, разрывы и связанные запросы. Вызывать до того, как писать бриф копирайтеру.
Inputs: query (required), n, region, our_domain.
check_articlesB
Снять позиции статей блога по их целевым запросам: вышла ли ИМЕННО эта статья, или вместо неё другая наша страница (каннибализация), или ничего. Здесь тратятся запросы к Search API.
Inputs: depth, region, project_id.
expand_query_poolA
Предложить новые запросы в пул отслеживания по seed-фразе через Wordstat. По умолчанию показывает кандидатов с причиной по каждому; записывает при apply=true.
Inputs: seed (required), apply, limit, region, +2 more.
find_serp_competitorsC
Кто повторяется в выдаче по набору запросов (до 10) — поисковые конкуренты с разделением на сайты и крупные площадки.
Inputs: queries (required), region.
geo_check_visibilityA
Цитирует ли ИИ-поиск сайт: задаёт запросы провайдерам и смотрит, есть ли домен среди источников ответа, каким адресом и на каком месте, кого цитируют вместо. Без confirm=true возвращает только смету (Яндекс 5,08 ₽ за запрос, зарубежные — по тарифу аккаунта). С confirm=true тратит деньги и пишет результат в историю.
Inputs: domain (required), queries (required), match, confirm, +2 more.
geo_historyA
История проверок видимости в ИИ-ответах по домену или запросу: сколько раз процитирован, доля, частые конкуренты. Ничего не тратит.
Inputs: limit, query, domain, provider.
geo_providersA
Какие провайдеры ИИ-ответов настроены (Яндекс, Perplexity, OpenAI, Gemini, Claude), каких ключей не хватает и где их взять, сколько стоит вызов. Ничего не тратит. Вызывать первым перед проверкой видимости.
Inputs: no named parameters.
geo_readinessB
Готовность сайта к ИИ-поиску без ключей: llms.txt по спецификации llmstxt.org, llms-full.txt, доступ ИИ-ботов в robots.txt (GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot, Google-Extended, YandexAdditional и др.), JSON-LD, FAQ-разметка, Markdown-версии страниц. Каждая находка — с доказательством и тем, что сделать. Ничего не тратит.
Inputs: url (required), pages.
get_action_planA
План правок сайта по приоритету: индексация, быстрые выигрыши (по Вебмастеру позиция 4–15, по трекеру 4–10: трекер снимает топ-10), сниппет (показы без кликов), каннибализация, ИИ-поиск, разрывы с конкурентами, остальное. Каждый пункт — с доказательством и датой замера, готовой инструкцией для Claude или разработчика, способом проверки и сроком, раньше которого эффект не проверять. Строится из аудита и проверки готовности (HTTP к самому сайту) и из того, что уже лежит в базе: позиции, выгрузки Вебмастера, статьи, снимки выдачи. Платных запросов не делает; чего нет в базе, того нет в плане — вместо этого называет инструмент и смету.
Inputs: url, limit, domain, sections, +2 more.
get_article_effectivenessA
Отчёт по статьям блога: вердикт и дельта по последнему замеру, отдельно список каннибализаций. Данные из истории, новых запросов к API не делает.
Inputs: project_id.
get_competitionC
Конкурентность запросов с полным разбором по факторам и доказательствами. Использовать, когда нужно понять, ПОЧЕМУ запрос сложный.
Inputs: query, region, queries.
get_competitor_keywordsA
По каким запросам конкурент выходит в топ и где нас рядом нет. Строится из накопленных снимков выдачи, новых запросов к API не делает.
Inputs: domain (required), region, our_domain.
get_keyword_metricsA
Частотность и конкурентность для списка запросов (до 25). Конкурентность считается по составу выдачи Яндекса, ссылочный вес не учитывается.
Inputs: keywords (required), region, with_competition.
get_position_historyC
История позиций домена по одному запросу и динамика конкурентности этого запроса.
Inputs: query (required), domain, region.
get_positionsA
Текущие позиции домена с дельтой к прошлому замеру и списком выросших и просевших запросов. Данные из истории, новых запросов к API не делает.
Inputs: domain, region.
get_serp_resultsC
Живая выдача Яндекса по одному запросу: позиции, домены, заголовки, глубина URL, число страниц домена по теме.
Inputs: query (required), n, region.
get_storage_statsB
Что накоплено в базе yaseo: снимки, замеры позиций, история конкурентности, самые частые домены выдачи.
Inputs: no named parameters.
research_keywordsA
Расширить 1–5 seed-фраз через Wordstat: частотность и связанные запросы по РФ. Основной инструмент подбора семантики.
Inputs: seeds (required), limit, region, min_freq.
run_trackingA
Снять текущие позиции по отслеживаемым запросам и записать замер в историю. Здесь тратятся запросы к Search API. Прогон останавливается ДО первого запроса и ничего не тратит, если обращений вышло бы больше потолка (YASEO_TRACKING_MAX_CALLS) или домен уже мерили недавно (YASEO_TRACKING_MIN_INTERVAL_DAYS) — в обоих случаях ответ говорит, сколько нужно и как снять ограничение на этот раз (параметр now).
Inputs: now, domain, region, queries, +1 more.
track_queryC
Поставить запросы на регулярное отслеживание позиций или снять их. Отслеживаемые запросы использует run_tracking.
Inputs: query, region, remove, queries.
whoamiA
Проверить конфигурацию yaseo: откуда взяты ключи, каких не хватает и где их взять, путь к базе, домен по умолчанию. Ничего не тратит. Вызывать первым, прежде чем тратить запросы.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have clearly distinct purposes, with descriptions clarifying whether they operate on live data, history, or configuration. A few pairs like get_competition vs get_keyword_metrics both mention competition but differ in depth and batch size, making them distinguishable with careful reading. Overall, an agent can reliably select the right tool.
The majority follow a get_* pattern for retrieval actions, but there are also action-oriented names like build_brief, track_query, run_tracking, and check_articles, plus a geo_* sub-family. This mixed convention is readable and generally predictable, though not perfectly uniform.
At 22 tools, the server is on the heavier side, exceeding the typical well-scoped range of 3–15. However, each tool addresses a distinct SEO concern—from research to tracking to AI visibility—so the count is justifiable despite feeling dense.
The tool surface covers the full SEO lifecycle: keyword research, SERP analysis, position tracking, site audit, article performance, competitor analysis, AI search readiness, and an action plan. No critical operations appear missing for the server's stated purpose, making it a complete toolkit.
Maintenance
Related MCP Connectors
SEO & GEO data: keywords, live SERPs with AI Overviews, backlinks, site audits, rank tracking.
Yandex rank tracking and bulk SERP data, billed per result, hosted MCP.
Research Yandex search demand, trends and regions in ChatGPT. Yandex API charges apply.
Affordable SEO & GEO data: rank tracking, keywords, competitors, AI visibility.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables keyword research and search trend analysis for the Russian market through Yandex Wordstat API. Provides access to popular search queries, search volume dynamics over time, and regional distribution data.-
- AlicenseAqualityDmaintenanceProvides tools for web, image, generative search, and Wordstat keyword statistics via Yandex Search API.71MIT

marketscore-seo-mcpofficial
AlicenseNot gradedqualityDmaintenanceConnects AI assistants to SEO data from Yandex Webmaster, Google Search Console, Yandex Metrica, and Topvisor, enabling natural language analysis of search performance, indexation, positions, and audits.MIT- AlicenseAqualityCmaintenanceEnables collecting real Yandex Wordstat v2 data and running managed semantic-core research workflows, including query frequencies, regional demand, dynamics, and AI-assisted cleaning, intent labeling, clustering, and reporting.5MIT