seo-tools-mcp
This server provides tools to access Google and Yandex search results (SERP), images, news, and video data via the XMLStock API, along with account management capabilities.
xmlstock_auth_status— Check which API credentials are configured (masked) and which are missing. Recommended to call first before using any other tool.xmlstock_set_credentials— Save XMLStock API key, user ID, and optional excluded domains to config without restarting. Supports named multi-account profiles.xmlstock_serp— Fetch Google or Yandex organic search results including snippets, text highlights, and SERP features (People Also Ask — Google only, related searches, packs). Configurable by region, device, safe search, sorting (Yandex), time period, and ads. Supports pagination up to depth 30 (each page is a paid request).xmlstock_images— Search Google Images, returning image URLs, source page URLs, and titles. Supports region, device, safe search, and domain zone.xmlstock_news— Search Google News, returning article URLs, titles, sources, dates, and snippets. Supports region, device, safe search, and domain zone.xmlstock_video— Search Google Videos, returning URLs, titles, thumbnails, host (e.g., YouTube), channel, duration, and snippets. Supports region, device, safe search, and domain zone.xmlstock_balance— Check account balance and daily API credit usage (free call, also useful for verifying API key validity). Supports multi-account profiles.
Provides tools for interacting with Google Search Console, including querying search analytics, inspecting URLs, listing sites, and managing sitemaps via OAuth or service account authentication.
Provides access to Yandex Wordstat API for retrieving keyword frequency, dynamics, and regional data through Yandex Cloud Search API.
seo-tools-mcp
Русский | English
Семь универсальных stdio MCP-серверов для SEO: доступ к SERP, Wordstat, Google Search Console, Яндекс.Вебмастеру, Яндекс.Метрике и self-hosted A-Parser прямо из Claude Code (и любого MCP-клиента). Все инструменты read-only, вывод — строгий JSON. К конкретному сайту не привязаны: дефолты (свойство GSC, хост Вебмастера, счётчик Метрики) настраиваются на лету.
🛰 Эти серверы мы используем в продакшене в PBN Workers — инфраструктура поискового топа: семантика, PBN и сателлиты, автоматизация SEO. Нужен стабильный органический трафик — приходите.
Сервер | Рабочие инструменты | Авторизация |
|
| API-ключ |
|
| API-ключ |
|
| Api-Key Yandex Cloud |
|
| OAuth (все свойства аккаунта) / service account |
|
| OAuth (авто-refresh) |
|
| OAuth (авто-refresh) |
|
| self-hosted A-Parser (URL + пароль API) |
У каждого сервера дополнительно есть auth-инструменты <server>_auth_status и <server>_set_credentials (см. Интерактивная авторизация).
Инструменты по сервисам
xmlstock — SERP Google/Яндекс
xmlstock_serp— веб-выдача Google/Яндекса (органика + подсветки + SERP-фичи): регион, устройство, safe search, сортировка (Яндекс), период, рекламные блокиxmlstock_images— поиск картинок Google (url страницы + url изображения + заголовок)xmlstock_news— новости Google (заголовок, источник, дата, сниппет)xmlstock_video— видео Google (url, заголовок, превью, хост, канал, длительность)xmlstock_wordstat— Яндекс Wordstat: топ + похожие запросы с частотностью (можно по региону), операторы Wordstatxmlstock_wordstat_dynamics— динамика частотности по времени (день/неделя/месяц)xmlstock_wordstat_regions— спрос по регионам (count, share, affinity index + имена регионов)xmlstock_wordstat_regions_tree— дерево регионов Wordstat (id + имя + путь)xmlstock_balance— баланс аккаунта / проверка ключа (бесплатно)
Wordstat через XMLStock — тем же ключом
XMLSTOCK_*, что и SERP; не нужен Yandex Cloud (в отличие от отдельного сервераwordstat).
xmlriver — SERP Google/Яндекс + проверка индексации
xmlriver_serp— органика Google/Яндекса (глубина добирается пагинацией: каждые 10 позиций = 1 платный запрос), флаг наличия AI Overview; опцияincludeAIOverview— полный текст Обзора от ИИ + цитируемые ссылки (платныйai=1, только Google); гео-таргетинг Google —location(город →loc, «Moscow»/«1011969») иcountry(ISO/числовой id, автовыводится из города)xmlriver_images— картинки Google (страница + url картинки + заголовок + источник + размеры)xmlriver_news— новости Google (заголовок, источник, дата, сниппет), фильтр по времениxmlriver_check_index— проверка индексации URL в Google/Яндексе (inindex)xmlriver_suggest— поисковые подсказки Google (до 50 фраз за вызов, платно за каждую фразу); гео подсказок —location/countryxmlriver_related_questions— блок «Вопросы по теме» / People Also Ask Google (вопросы всегда; ответы — только при включённой платной опции «Related Questions с ответами» в кабинете)xmlriver_balance— баланс аккаунта / проверка ключа (бесплатно)
wordstat — частотности Яндекса
wordstat_frequency— широкая и точная частотность, уточняющие запросы (related) и ассоциацииwordstat_dynamics— частотность по времени (день/неделя/месяц)wordstat_regions— распределение по регионам с индексом аффинити и именами регионовwordstat_regions_tree— полное дерево регионов Вордстата (id + имя)
gsc — Google Search Console
gsc_query— Search Analytics (клики/показы/CTR/позиция), авто-пагинация,dataStatefinal/allgsc_inspect_url— URL Inspection: статус индексации, покрытие, canonical, последний обход, mobile usability, rich resultsgsc_list_sites— свойства, доступные авторизацииgsc_get_site— уровень доступа к свойствуgsc_list_sitemaps— отправленные sitemap со статусомgsc_get_sitemap— детали одного sitemap
Даты Search Analytics — по Pacific Time (не МСК); история ~16 месяцев; финальные данные отстают на ~2-3 дня (свежие — dataState=all); ctr в ответе — доля 0..1.
ywm — Яндекс.Вебмастер
ywm_hosts— id пользователя + подтверждённые сайтыywm_summary— ИКС, страниц в поиске, исключено, проблемы сайта по важностиywm_search_queries— аналитика запросов по URL (~2 недели по умолчанию; переопределяется dateFrom/dateTo)ywm_queries_history— суммарные показы/клики/позиции по времениywm_recommended_queries— приближённые рекомендованные запросы (спрос + недобор кликов)ywm_popular— популярные запросы хостаywm_indexing_history— страниц в поиске по времениywm_sqi_history— ИКС по времениywm_external_links— выборка внешних ссылок + общее числоywm_broken_links— битые внутренние/внешние ссылкиywm_diagnostics— проблемы сайтаywm_important_urls— отслеживаемые URL со статусом индексации/поискаywm_sitemaps— sitemap со статусом
metrika — Яндекс.Метрика
metrika_report— произвольный отчёт: любые dimensions × metrics, фильтры, сортировка (полный Stat API)metrika_bytime— метрики по времени (день/неделя/месяц/час)metrika_traffic_sources— визиты/пользователи/отказы по источникам трафикаmetrika_geo— визиты по стране/региону/городуmetrika_devices— визиты по устройству/ОС/браузеруmetrika_goals— список целей (конверсий)metrika_counters— доступные счётчикиmetrika_landing_behavior— поведение на посадочных + достижения целейmetrika_search_phrases— поисковые фразы (органика)metrika_top_landings— топ органических посадочных
aparser — мост к self-hosted A-Parser
aparser_ping— проверка связи с инстансом и пароля APIaparser_status— вердикт готовности: версия, установленные парсеры, очередь, живые проксиaparser_proxies— живые прокси инстанса (можно по пачкам proxy checkers; креды прокси не выводятся)aparser_parsers— парсеры, установленные на инстансеaparser_parser_fields— поля результата, которые умеет вернуть парсер (flat + arrays)aparser_get_preset— опции config-пресета парсера (чувствительные значения маскируются)aparser_serp_google— органика Google (парсерSE::Google); прокси по умолчанию + preflight живых проксиaparser_serp_yandex— органика Яндекса (SE::Yandex); регион черезlraparser_suggest— поисковые подсказки Google/Яндексаaparser_request— универсальный синхронный запрос к любому парсеру (oneRequest)aparser_bulk_request— пакетный запрос: один парсер, много запросов в N потоков (bulkRequest)
Нужен свой запущенный инстанс A-Parser (лицензия + сервер): мост им управляет, но не хостит и не проксирует его. Прокси и прокси-чекеры (пачки) настраиваются один раз в GUI A-Parser — мост их читает, проверяет (preflight) и выбирает (
checkers), но не создаёт. v1 синхронный и read-only: очередь задач и большие асинхронные выгрузки не подключены.
Related MCP server: gsc-mcp-connector
Быстрый старт
Вариант А — через npx (без клонирования)
Каждый сервер — самодостаточный npm-пакет seo-tools-mcp-<сервер>; ставится одной командой:
claude mcp add xmlstock --scope user -- npx -y seo-tools-mcp-xmlstock
claude mcp add xmlriver --scope user -- npx -y seo-tools-mcp-xmlriver
claude mcp add wordstat --scope user -- npx -y seo-tools-mcp-wordstat
claude mcp add gsc --scope user -- npx -y seo-tools-mcp-gsc
claude mcp add ywm --scope user -- npx -y seo-tools-mcp-ywm
claude mcp add metrika --scope user -- npx -y seo-tools-mcp-metrika
claude mcp add aparser --scope user -- npx -y seo-tools-mcp-aparserНужен только один сервер?
Серверы не связаны между собой: возьмите один пакет и игнорируйте остальные. Каждый самодостаточен — общий код @seo-tools/shared вшит в сборку, так что лишних зависимостей и «хвоста» монорепы не тянется. Достаточно установить нужный пакет с npm — там уже всё из коробки (npx -y скачает и запустит его сам):
Пакет (npm) | Сервер |
SERP Google/Яндекс + Wordstat | |
SERP Google/Яндекс + проверка индексации | |
частотности Яндекса (Yandex Cloud) | |
Google Search Console | |
Яндекс.Вебмастер | |
Яндекс.Метрика | |
мост к self-hosted A-Parser |
# добавить один сервер в Claude Code
claude mcp add xmlstock --scope user -- npx -y seo-tools-mcp-xmlstock
# или запустить напрямую (ключи через env)
XMLSTOCK_USER=... XMLSTOCK_KEY=... npx -y seo-tools-mcp-xmlstockВ любом MCP-клиенте (Claude Desktop, Cursor…) — прописывается один блок в mcpServers:
{
"mcpServers": {
"xmlstock": {
"command": "npx",
"args": ["-y", "seo-tools-mcp-xmlstock"],
"env": { "XMLSTOCK_USER": "...", "XMLSTOCK_KEY": "..." }
}
}
}Прямая установка одного пакета по GitHub-ссылке (
npm i github:antohins/seo-tools-mcp) не поддерживается: это pnpm-монорепа, отдельный подпакет так не ставится. Для установки из исходников — вариант Б ниже (клонировать + собрать). Готовые пакеты живут на npm.
Вариант Б — из исходников
git clone https://github.com/antohins/seo-tools-mcp.git && cd seo-tools-mcp
pnpm install && pnpm build
ROOT=$(pwd)
for s in xmlstock xmlriver wordstat gsc ywm metrika aparser; do
claude mcp add "$s" --scope user -- node "$ROOT/servers/$s/dist/index.js"
doneДальше (любой вариант) — прямо в диалоге Claude Code: «настрой доступ к xmlstock» → агент вызовет xmlstock_auth_status, подскажет, какие ключи нужны и где их взять, примет их через xmlstock_set_credentials и сохранит. После этого спрашивайте данные обычным языком: «сними топ-10 Яндекса по запросу X», «частотность фраз …», «клики/показы из GSC за месяц». Ключи и OAuth настраиваются один раз (см. Получение доступов).
Интерактивная авторизация (в любой сессии)
У каждого сервера есть auth-инструменты — ключи можно выдавать прямо в диалоге, без правки файлов и перезапуска:
<server>_auth_status— вызывается в начале работы: показывает, какие ключи заданы (маскированно), каких не хватает и как их получить (шаги регистрации).<server>_set_credentials— сохраняет переданные значения в~/.config/seo-tools-mcp/.env(права 600) и применяет сразу.gsc_save_sa_json— принимает содержимое JSON-ключа сервис-аккаунта, кладёт его в конфиг-директорию и возвращает email, который нужно добавить в GSC.ywm_oauth_start/metrika_oauth_start→ ссылка авторизации Яндекса; пользователь открывает, разрешает, копирует код →*_oauth_finishобменивает код на access+refresh токены. Дальше токен обновляется автоматически при протухании (code flow, не implicit).
Типовой сценарий новой сессии: «настрой доступ к xmlstock» → агент вызывает xmlstock_auth_status → просит недостающие ключи → xmlstock_set_credentials → работает.
⚠ Ключи, переданные через чат, проходят через контекст модели. Для максимальной гигиены можно по-прежнему вписать их в ~/.config/seo-tools-mcp/.env руками — серверы подхватят файл сами.
Мультиаккаунт
Клиентские сайты раскиданы по разным аккаунтам Google/Яндекса — поддерживаются именованные профили:
Каждый рабочий инструмент принимает опциональный параметр
account(«clientX», «agency»...). Без него используется основной профиль — обратная совместимость полная.Ключи профиля хранятся в том же конфиге с суффиксом:
GSC_REFRESH_TOKEN__clientX,YANDEX_OAUTH_TOKEN__clientX,XMLSTOCK_KEY__clientX…Добавление профиля:
gsc_oauth_start(account="clientX")→ пользователь авторизуется под другим Google-аккаунтом →gsc_oauth_finish(account="clientX"). Аналогичноywm_oauth_start/finish(account=...)для Яндекса; API-ключи —<server>_set_credentials(account="clientX", ...).OAuth-приложения общие: один Google-client и одно Яндекс-приложение обслуживают все профили (клиент создаётся один раз, авторизаций — сколько угодно). Per-account хранятся только токены; refresh обновляет токен своего профиля.
Резолв строгий:
account="clientX"без настроенных ключей → ошибка со списком настроенных профилей (никаких тихих фолбэков в чужой аккаунт). Дефолты (GSC_SITE_URL__clientX,YWM_HOST_ID__clientX,METRIKA_COUNTER_ID__clientX) — тоже per-account.<server>_auth_statusпоказывает все профили и их ключи (маскированно).Альтернатива для жёсткой изоляции: отдельный env-файл через
SEO_TOOLS_MCP_ENV(при заданном пути домашний конфиг НЕ читается).
Установка
cd seo-tools-mcp
pnpm install
pnpm buildСекреты
Единый env-файл: ~/.config/seo-tools-mcp/.env (права 600). Все серверы читают его при старте, а *_set_credentials/*_oauth_finish пишут в него сами — ручная правка не обязательна. Шаблон — .env.example. Переменные из окружения процесса имеют приоритет над файлом. Альтернативный путь к файлу — SEO_TOOLS_MCP_ENV (так один хост может держать несколько независимых профилей: разные claude mcp add с разным SEO_TOOLS_MCP_ENV).
Регистрация в Claude Code
ROOT=/path/to/seo-tools-mcp
claude mcp add xmlstock --scope user -- node $ROOT/servers/xmlstock/dist/index.js
claude mcp add wordstat --scope user -- node $ROOT/servers/wordstat/dist/index.js
claude mcp add gsc --scope user -- node $ROOT/servers/gsc/dist/index.js
claude mcp add ywm --scope user -- node $ROOT/servers/ywm/dist/index.js
claude mcp add metrika --scope user -- node $ROOT/servers/metrika/dist/index.js--scope user — доступно во всех сессиях/проектах. Для шаринга на команду — --scope project (создаст .mcp.json в репозитории; секреты подставлять только через ${VAR}).
Получение доступов (по сервису)
Всё из этого раздела продублировано в ответах
<server>_auth_status— агент сам подскажет шаги. Ниже — для чтения человеком.
XMLStock (приоритет 1) — SERP Google + Яндекс
Регистрация: https://xmlstock.com → личный кабинет, пополнить баланс (Google XML и Яндекс Live — от 12 ₽/1000 запросов).
Взять ID пользователя и API-ключ →
XMLSTOCK_USER,XMLSTOCK_KEY(или черезxmlstock_set_credentials).Проверка:
xmlstock_balance.
Нюансы (выяснено на живых ответах):
подсветки выдачи (
text_bolds) — параметрhlword=1, тег<hlword>вложенным XML (парсится через stopNodes, соседние слова склеиваются во фразы); PAA и related searches —related=1(PAA только у Google);mobile-выдача не отдаёт hlword/PAA/related — мобильный слепок только позиции+сниппеты, подсветки снимать с desktop;
страницы с 0 у обоих движков; органики на странице бывает <10 — сервер сам добирает страницей (+1 платный запрос);
lrпринимает id регионов Яндекса для обоих движков (XMLStock маппит на Google сам);ошибки HTTP 200 +
<error code>: 20–25/101/110/111/500 ретраятся, 55 — rate-limit с паузой, 15 = пустая выдача (деньги списаны), 31/42 — фатальные (авторизация);Wordstat у XMLStock НЕТ — частотности через отдельный сервер (официальный API Вордстата Яндекса).
Wordstat (приоритет 1) — частотности Яндекса
Официальный Wordstat API v2 (в составе Yandex Cloud Search API) — бесплатный, без заявок и OAuth. Один раз в https://console.yandex.cloud:
Создать каталог (folder) или взять существующий → его ID в
WORDSTAT_FOLDER_ID.Создать сервисный аккаунт с ролью
search-api.webSearch.user.Выпустить для него API-ключ с областью действия
yc.search-api.execute→WORDSTAT_API_KEY.Проверка:
wordstat_frequencyпо любой фразе.
Нюансы: точная частотность = операторы "!слово !слово" (поддерживаются в topRequests/regions; в dynamics — только при period=daily); данные topRequests — за последние 30 дней; count приходит строками (парсится); квоты 10 rps / 100 запросов в час (429 ретраится, но для массового съёма закладывать троттлинг); associations максимум 20.
Google Search Console (приоритет 1)
Два пути; рекомендуемый — OAuth: токен наследует доступ твоего Google-аккаунта и видит все его свойства GSC разом (включая будущие), добавлять пользователя в каждое свойство не нужно.
Путь A — OAuth (один раз):
https://console.cloud.google.com → проект → APIs & Services → Library → включить Google Search Console API.
OAuth consent screen: тип External; себя — в Test users. (Для refresh-токена дольше 7 дней — нажать Publish app; предупреждение «unverified» при авторизации — норма для личного использования.)
Credentials → Create credentials → OAuth client ID → Desktop app → взять client ID + secret.
В чате:
gsc_oauth_start(передать clientId+secret) → открыть ссылку → разрешить → браузер редиректнется наlocalhost:8585, код подхватится автоматически →gsc_oauth_finish.Проверка:
gsc_list_sites— покажет все свойства аккаунта.
Путь B — сервис-аккаунт (для headless-кронов): IAM → Service Accounts → JSON-ключ → gsc_save_sa_json (или путь в GSC_SA_JSON) → добавить email аккаунта в каждое нужное свойство GSC (Настройки → Пользователи и права, «Полный»).
Если заданы оба — приоритет у OAuth.
Яндекс OAuth (Вебмастер + Метрика — одно приложение, один токен)
Один раз: https://oauth.yandex.ru/client/new → «Веб-сервисы», Redirect URI:
https://oauth.yandex.ru/verification_code. Права (scope): Яндекс.Вебмастер — «Получение информации о сайтах» (webmaster:hostinfo) + «Управление сайтами» (webmaster:verify); Яндекс.Метрика — «Получение статистики» (metrika:read). Взять ClientID и Client secret.Дальше — интерактивно в чате:
ywm_oauth_start(передать ClientID + secret, сохранятся) → открыть ссылку под аккаунтом-владельцем сайта/счётчика → скопировать код →ywm_oauth_finish. Получатся access+refresh токены, общие для ywm и metrika; обновляются автоматически.Дефолты:
YWM_HOST_ID(список —ywm_hosts),METRIKA_COUNTER_ID(список —metrika_counters) — задать через*_set_credentials, либо передавать в каждом вызове.Ручная альтернатива: получить токен implicit-flow (
response_type=token) и сохранить вYANDEX_OAUTH_TOKEN— но без refresh он протухнет (Вебмастер ~6 мес, Метрика ~1 год).
Ограничения API Яндекса (не баги серверов): фильтр по URL в Вебмастере есть только в query-analytics (данные ~2 недели); эндпоинта «рекомендованные запросы» в API v4 нет — ywm_recommended_queries аппроксимирует через спрос (DEMAND) + недобор кликов; поисковые фразы в Метрике в основном «Не определено» (шифрование).
A-Parser (self-hosted) — SERP и сотни парсеров через свою коробку
Свой запущенный инстанс A-Parser (лицензия + сервер) — мост им управляет, но не хостит и не проксирует его.
В A-Parser: Settings → API — включить API-сервер, запомнить порт (обычно 9091) и пароль.
APARSER_URL=http://<IP-инстанса>:<порт>/API(обязательно с путём/API),APARSER_PASSWORD= пароль оттуда же →aparser_set_credentials.Проверка:
aparser_ping, затемaparser_status(готовность инстанса + живые прокси).
Нюансы: прокси и прокси-чекеры (пачки) настраиваются один раз в GUI — без живых прокси Google/Яндекс быстро банят, поэтому serp/suggest-инструменты делают preflight и предупреждают (use_proxy=false — на свой риск); пресеты и пачки по умолчанию задаются env (APARSER_GOOGLE_PRESET, APARSER_YANDEX_PRESET, APARSER_PROXY_CHECKERS, APARSER_USE_PROXY); v1 синхронный и read-only — очередь задач и мутирующие методы API не подключены.
Формат дат и регионы
Даты — YYYY-MM-DD (МСК). Регионы: имя из встроенного списка частых регионов («Москва», «спб», «Казахстан»…) или числовой id региона Яндекса (213, 225…) — числовой id работает всегда. Несколько регионов через запятую поддерживает только сервер wordstat; SERP-инструменты xmlstock_*/xmlriver_* принимают ОДИН регион. Полный справочник id — инструмент wordstat_regions_tree.
Где и как использовать
Серверы — обычные stdio-процессы без привязки к машине. Четыре сценария:
1. Claude Code, локально
Зарегистрировать через claude mcp add --scope user (блок «Регистрация в Claude Code» выше) — доступно во всех проектах и сессиях.
2. Claude Code, другая машина
git clone https://github.com/antohins/seo-tools-mcp.git && cd seo-tools-mcp
pnpm install && pnpm build
# зарегистрировать серверы (блок «Регистрация в Claude Code» выше)
# ключи: скопировать ~/.config/seo-tools-mcp/.env со старой машины (chmod 600)
# ЛИБО выдать в диалоге через <server>_auth_status → <server>_set_credentials3. Claude Desktop (локально)
В claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/):
{
"mcpServers": {
"xmlstock": { "command": "node", "args": ["/ABS/PATH/seo-tools-mcp/servers/xmlstock/dist/index.js"] },
"wordstat": { "command": "node", "args": ["/ABS/PATH/seo-tools-mcp/servers/wordstat/dist/index.js"] }
}
}Ключи подхватятся из ~/.config/seo-tools-mcp/.env автоматически.
4. Удалённо: claude.ai / Claude Code с любого места
claude.ai (web/mobile) умеет только remote MCP (Streamable HTTP по публичному HTTPS). Наши stdio-серверы выносятся на VPS через мост supergateway:
# на сервере: клонировать/собрать как в сценарии 2, ключи в ~/.config/seo-tools-mcp/.env
npx -y supergateway --stateful --outputTransport streamableHttp --port 8801 \
--stdio "node /opt/seo-tools-mcp/servers/xmlstock/dist/index.js" # и так для каждого сервера, порты 8801–8805Дальше nginx: TLS + proxy_pass на 127.0.0.1:880X под секретным путём (например /mcp-<длинный-случайный-токен>/xmlstock/) — supergateway слушать только на localhost. Подключение:
Claude Code:
claude mcp add --transport http xmlstock https://host/<секретный-путь>/xmlstock/mcpclaude.ai: Settings → Connectors → Add custom connector → тот же URL.
⚠ Секретный путь — минимальный гейт (custom connectors claude.ai не передают произвольные заголовки авторизации). За эндпоинтом — все ключи сервисов, поэтому: только HTTPS, длинный токен в пути, отдельный access-лог.
Альтернатива для Claude Code без HTTP-моста — stdio через ssh:
claude mcp add xmlstock --scope user -- ssh root@SERVER node /opt/seo-tools-mcp/servers/xmlstock/dist/index.jsРазработка
pnpm build # собрать все воркспейсы
pnpm typecheck # только типы
pnpm test # юнит-тесты (vitest, без сети)
pnpm test:live # лайв-смоук по реальным API (нужны креды в конфиге; free-эндпоинты)
node servers/xmlstock/dist/index.js # ручной запуск (stdio)Юнит-тесты покрывают чистую логику: маскирование секретов, классификацию OAuth-ошибок, пагинацию Метрики/GSC (дедуп, truncated), фильтры, парсер SERP, регионы. Лайв-смоук поднимает каждый сервер и дёргает бесплатный инструмент (xmlstock_balance, xmlriver_balance, wordstat_frequency, gsc_list_sites, ywm_hosts, metrika_counters, aparser_ping) — проверка авторизации end-to-end.
Общий код (shared/): HTTP-клиент с ретраями на 429/5xx (3 попытки, экспоненциальный backoff, Retry-After), загрузчик env + персистентный конфиг, фабрика auth-инструментов, Яндекс-OAuth с авто-refresh, JSON-хелперы MCP, счётчик расхода платных вызовов. XMLStock дополнительно ретраит свои «временные» коды из тела XML, код 15 («ничего не найдено») трактуется как пустая выдача.
Сборка серверов — tsup: shared/ вбивается в единый dist/index.js каждого сервера (рантайм-зависимости остаются external), поэтому npm-пакет самодостаточен.
Публикация в npm (мейнтейнерам)
Каждый сервер публикуется как отдельный пакет seo-tools-mcp-<сервер>; shared/ приватный и в npm не уходит (вбит в серверы). Версии всех серверов держим синхронно.
npm login
pnpm -r build # shared (tsc) → серверы (tsup-бандл)
pnpm -r publish --access public # публикует 5 серверов; private-пакеты (shared, корень) пропускаютсяpnpm publish сам подставляет реальные версии вместо workspace:* и не даст опубликовать при грязном рабочем дереве. Бамп версии — pnpm -r exec npm version patch (или вручную в каждом package.json).
Контрибьютинг
PR приветствуются — см. CONTRIBUTING.md. История изменений — CHANGELOG.md. Уязвимости — приватно через Security Advisories (детали — SECURITY.md).
Лицензия
MIT © antohins
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for querying Google Search Console data — search analytics, URL inspection, sitemap monitoring, and more — read-only tools for any MCP-compatible AI client.Last updated7Apache 2.0
- Alicense-qualityBmaintenanceSelf-hosted MCP server that exposes Google Search Console tools (list sites, query analytics, inspect URL, list sitemaps) via natural language to AI assistants like ChatGPT and Claude.Last updatedMIT
- AlicenseBqualityBmaintenanceProfessional Google Search Console MCP server providing 40+ SEO tools for performance analysis, content decay, CTR opportunities, and more, enabling real search data in clients like Cursor and Claude.Last updated40156MIT
- AlicenseAqualityCmaintenanceLocal-first MCP server for Yandex Webmaster that exposes tools for SEO operations including search query analytics, sitemap management, indexing history, recrawl quota, and diagnostics.Last updated15MIT
Related MCP Connectors
Live SEO workflow tools for Claude Code, Codex, and AI agents.
MCP server for Google search results via SERP API
SEO MCP server: crawl your site, find AI-visibility gaps, and ship the fix from your coding agent.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/antohins/seo-tools-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server