MCP-сервер для Topvisor
@scom82/topvisor-mcp
Неофициальный MCP-сервер для Topvisor API v2: 17 инструментов для отслеживания позиций в Яндексе и Google по проектам и регионам
- 1 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает платные проверки позиций, которые списывают баланс аккаунта Topvisor
- API-ключ Topvisor дает доступ ко всем проектам аккаунта
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/scom82-topvisor-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает платные проверки позиций, которые списывают баланс аккаунта Topvisor
- API-ключ Topvisor дает доступ ко всем проектам аккаунта
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер реализует полный рабочий цикл Topvisor: создать проект по URL, добавить поисковую систему и регион, импортировать ключевые слова через CSV, оценить стоимость проверки, запустить асинхронную проверку позиций, прочитать историю, сводку за два периода, график распределения позиций и SERP-снимки, а также посмотреть баланс аккаунта. Отдельно описана путаница между region_key (каталожный идентификатор при добавлении региона) и region_index (порядковый номер, который Topvisor присваивает после добавления и который нужен во всех остальных вызовах). README дает таблицу с реальными значениями для нескольких городов, чтобы показать, что совпадение этих чисел не гарантировано.
Для кого. Для SEO-специалистов с аккаунтом Topvisor, которым нужно отслеживать позиции в Яндексе и Google через агента.
Подходит, если
- Уже есть платный аккаунт Topvisor с балансом на проверки
- Нужны и Яндекс, и Google в одном отслеживании позиций по регионам
- Нужны SERP-снимки на момент проверки позиций
Не подходит, если
- Нет аккаунта Topvisor: сервер только оборачивает его API, без Topvisor не работает
- Нужен результат проверки сразу, а не через асинхронную очередь с ручным поллингом
Пример запроса к агенту
Проверь позиции проекта green-line24.ru по ключевым словам купить окна в Самаре и ТольяттиMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
TOPVISOR_USER_IDобязательная- User ID из настроек аккаунта Topvisor
TOPVISOR_API_KEYобязательная, секрет- API-ключ, генерируется в настройках аккаунта Topvisor
TOPVISOR_API_URL- По умолчанию https://api.topvisor.com/v2/json
TOPVISOR_HTTP_TIMEOUT_MS- Таймаут запроса, по умолчанию 30000 мс
Ограничения
Проверка позиций асинхронная и может занимать от минут до часов, встроенного ожидания результата нет, нужно вручную опрашивать topvisor_list_projects. Часть методов редактирования и удаления недокументированы Topvisor и доступны только через универсальный topvisor_request. Rate limit API не документирован, повторов при лимите сервер не делает. Инструмент неофициальный и явно не аффилирован с Topvisor.
Как отключить. Удалите блок topvisor из конфигурации MCP-клиента.
Частые вопросы
В чем разница между region_key и region_index?
region_key это каталожный идентификатор при добавлении региона через topvisor_add_region, а region_index это порядковый номер, который Topvisor назначает после добавления и который нужен во всех остальных вызовах. Совпадение этих чисел не гарантировано, нужно вызывать topvisor_list_regions.
Проверка позиций возвращает результат сразу?
Нет, topvisor_check_positions только ставит задачу в очередь Topvisor и возвращает projectsIds, результат нужно получать отдельным опросом topvisor_list_projects и затем topvisor_get_history.
Чем MCP-сервер Topvisor отличается от работы в кабинете Topvisor?
Неофициальный сервер на 17 инструментов реализует рабочий цикл по API v2: создать проект по URL, добавить поисковую систему и регион, импортировать ключевые слова через CSV, оценить стоимость проверки, запустить асинхронную проверку позиций в Яндексе и Google.
В чем разница между region_key и region_index и результат приходит сразу?
region_key это ключ региона из каталога Topvisor, он нужен при добавлении региона, а region_index это индекс уже добавленного региона из topvisor_list_regions. Проверка позиций асинхронная: сначала запускается задача, затем результат запрашивается отдельно. Ключ API Topvisor нужен в конфиге, конфиг с npx в блоке установки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыDirect Manager: MCP для Яндекс Директа по подписке
Direct Manager
Платный сервис-коннектор к Яндекс Директу, VK и Авито с аналитикой, поиском бесполезных трат и автопилотом поверх Direct API
Восемь read-only MCP-серверов для SEO
seo-tools-mcp
SERP, Wordstat, GSC, GA4, Яндекс Вебмастер, Метрика и A-Parser: восемь read-only MCP-серверов со строгим JSON и мультиаккаунтом для Claude Code
Неофициальный MCP-сервер к Rush Analytics: топ выдачи, Вордстат, подсказки, позиции и AI-трекинг брендов, 14 инструментов
MCP-сервер для Яндекс Вебмастер API v4.1
Яндекс Вебмастер MCP-сервер
Python MCP-сервер с полным покрытием Яндекс Вебмастер API v4.1: 37 инструментов от диагностики и sitemap до мониторинга важных URL
MCP-сервер Яндекс Вебмастера (npm)
@theyahia/yandex-webmaster-mcp
MCP-сервер на TypeScript для API Яндекс Вебмастера: сайты, индексация, поисковые запросы, карты сайта, диагностика и переобход, 13 инструментов
MCP-сервер Yandex Webmaster для локальной SEO-рутины
kurerok-yandex-webmaster-mcp
Локальный MCP-сервер Yandex Webmaster с рекомендованным недельным сценарием: запросы, индексация, переобход и диагностика по порядку
Коротко о README
README на английском описывает 17 инструментов таблицей, установку через npx без локальной сборки, пошаговый пример стейтфул-модели Topvisor от создания проекта до чтения истории, отдельные разделы про путаницу region_key и region_index, асинхронность проверки позиций, формат SERP-снимков и известные особенности API вроде HTTP 200 при ошибках.