seo-tools-mcp

by antohins

449 downloads Not rated yet

GitHub Website

About

Five read-only MCP servers for SEO on the Google/Yandex (RU/CIS) market: SERP (XMLStock), Yandex Wordstat, Google Search Console, Yandex.Webmaster, Yandex.Metrica.

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name seo-tools-mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "seo-tools-mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "seo-tools-mcp-aparser"
                ],
                "env": {
                    "APARSER_URL": "",
                    "APARSER_PASSWORD": "",
                    "APARSER_GOOGLE_PRESET": "",
                    "APARSER_YANDEX_PRESET": "",
                    "APARSER_PROXY_CHECKERS": "",
                    "APARSER_USE_PROXY": ""
                }
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "npx",
        "args": [
            "-y",
            "seo-tools-mcp-aparser"
        ],
        "env": {
            "APARSER_URL": "",
            "APARSER_PASSWORD": "",
            "APARSER_GOOGLE_PRESET": "",
            "APARSER_YANDEX_PRESET": "",
            "APARSER_PROXY_CHECKERS": "",
            "APARSER_USE_PROXY": ""
        }
    }
}

Transport

"stdio"

Package

"seo-tools-mcp-aparser"

Registry

"npm"

Восемьуниверсальныхstdio MCP-серверов для SEO: доступ к SERP, Wordstat, Google Search Console, Google Analytics 4, Яндекс.Вебмастеру, Яндекс.Метрике и self-hosted A-Parser прямо из Claude Code (и любого MCP-клиента). Все инструментыread-only, вывод — строгий JSON. К конкретному сайту не привязаны: дефолты (свойство GSC, свойство GA4, хост Вебмастера, счётчик Метрики) настраиваются на лету.

🛰 Эти серверы мы используем в продакшене вPBN Workers— инфраструктура поискового топа: семантика, PBN и сателлиты, автоматизация SEO. Нужен стабильный органический трафик —приходите.

У каждого сервера дополнительно есть auth-инструменты<server>_auth_statusи<server>_set_credentials(см.Интерактивная авторизация).

- xmlstock_serp— веб-выдача Google/Яндекса (органика + подсветки + SERP-фичи): регион, устройство, safe search, сортировка (Яндекс), период, рекламные блоки; третий движокyandex_xml— официальный Яндекс XML (groupby до 100 за 1 запрос, hlword на любых устройствах, статистика found/found-docs; тариф от 24 ₽/1000)
- xmlstock_images— поиск картинок Google (url страницы + url изображения + заголовок)
- xmlstock_news— новости Google (заголовок, источник, дата, сниппет)
- xmlstock_video— видео Google (url, заголовок, превью, хост, канал, длительность)
- xmlstock_wordstat— Яндекс Wordstat: топ + похожие запросы с частотностью (можно по региону), операторы Wordstat
- xmlstock_wordstat_dynamics— динамика частотности по времени (день/неделя/месяц)
- xmlstock_wordstat_regions— спрос по регионам (count, share, affinity index + имена регионов)
- xmlstock_wordstat_regions_tree— дерево регионов Wordstat (id + имя + путь)
- xmlstock_balance— баланс аккаунта / проверка ключа (бесплатно)

Wordstat через XMLStock — тем же ключомXMLSTOCK_, что и SERP;не нужен Yandex Cloud(в отличие от отдельного сервераwordstat).

- <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).

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 ga4 --scope user -- node $ROOT/servers/ga4/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.

Путь B — сервис-аккаунт (для headless-кронов):IAM → Service Accounts → JSON-ключ →gsc_save_sa_json(или путь вGSC_SA_JSON) → добавить email аккаунта вкаждоенужное свойство GSC (Настройки → Пользователи и права, «Полный»).

Авторизация та же, что у GSC, иOAuth-приложение общее(GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRETпереиспользуются). Но scope у GA4 свой, поэтому нужна отдельная авторизация — один раз.
- В том же проекте console.cloud.google.com → APIs & Services → Library → включитьGoogle Analytics Data APIиGoogle Analytics Admin API.
- В чате:ga4_oauth_start(если client ID/secret уже сохранены для GSC — без аргументов) → открыть ссылку → разрешить → браузер редиректнется наlocalhost:8586(порт отличается от GSC, чтобы серверы не конфликтовали), код подхватится автоматически →ga4_oauth_finish.
- Проверка:ga4_list_properties— покажет все свойства аккаунта и ихpropertyId.
- Удобно сохранить свойство по умолчанию:ga4_set_credentials→GA4_PROPERTY_ID(числовой id из п. 3), иначе передаватьpropertyIdв каждом вызове.

Путь B — сервис-аккаунт:JSON-ключ →ga4_save_sa_json→ добавить email аккаунта в свойство GA4 (Администратор → Управление доступом к ресурсу, роль «Просмотр»).

Яндекс 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-процессы без привязки к машине. Четыре сценария:

Зарегистрировать черезclaude mcp add --scope user(блок «Регистрация в 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_credentials

В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/mcp
- claude.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 («ничего не найдено») трактуется как пустая выдача.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

Claude Desktop / Cursor

McpServers

Transport

Package

Registry

xmlriver — SERP Google/Яндекс + проверка индексации

Вариант 0 — в один клик для Claude Desktop (.mcpb)

Вариант А — через npx (без клонирования)

Интерактивная авторизация (в любой сессии)

XMLStock (приоритет 1) — SERP Google + Яндекс

Wordstat (приоритет 1) — частотности Яндекса

Яндекс OAuth (Вебмастер + Метрика — одно приложение, один токен)

A-Parser (self-hosted) — SERP и сотни парсеров через свою коробку

4. Удалённо: claude.ai / Claude Code с любого места

More like this

Aws Kb Retrieval Server

Memory

Brave Search

Context 7