MCP-сервер для Topvisor

@scom82/topvisor-mcp

Неофициальный MCP-сервер для Topvisor API v2: 17 инструментов для отслеживания позиций в Яндексе и Google по проектам и регионам

MCP-серверРоссийский стек

scom-82/topvisor-mcpАвтор:scom-82

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/scom82-topvisor-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'TOPVISOR_USER_ID=<значение TOPVISOR_USER_ID>' --env 'TOPVISOR_API_KEY=<ваш TOPVISOR_API_KEY>' topvisor -- npx -y @scom82/topvisor-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"topvisor","type":"stdio","command":"npx","args":["-y","@scom82/topvisor-mcp"],"env":{"TOPVISOR_USER_ID":"<значение TOPVISOR_USER_ID>","TOPVISOR_API_KEY":"<ваш TOPVISOR_API_KEY>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "topvisor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add topvisor --env 'TOPVISOR_USER_ID=<значение TOPVISOR_USER_ID>' --env 'TOPVISOR_API_KEY=<ваш TOPVISOR_API_KEY>' -- npx -y @scom82/topvisor-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.topvisor]
command = "npx"
args = ["-y", "@scom82/topvisor-mcp"]
env = { TOPVISOR_USER_ID = "<значение TOPVISOR_USER_ID>", TOPVISOR_API_KEY = "<ваш TOPVISOR_API_KEY>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "topvisor": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "environment": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@scom82/topvisor-mcp"
      ],
      "env": {
        "TOPVISOR_USER_ID": "<значение TOPVISOR_USER_ID>",
        "TOPVISOR_API_KEY": "<ваш TOPVISOR_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

TOPVISOR_USER_IDобязательная
TOPVISOR_API_KEYсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит f22f06c.

Текст для агента

Добавь сервер в конфигурацию клиента с командой npx -y @scom82/topvisor-mcp и переменными TOPVISOR_USER_ID и TOPVISOR_API_KEY из настроек аккаунта Topvisor.

Другие способы из описания автора

{
  "mcpServers": {
    "topvisor": {
      "command": "npx",
      "args": ["-y", "@scom82/topvisor-mcp"],
      "env": {
        "TOPVISOR_USER_ID": "your_user_id",
        "TOPVISOR_API_KEY": "your_api_key"
      }
    }
  }
}

Фрагмент из README, npx подтягивает пакет сам, локальная установка не нужна.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер реализует полный рабочий цикл Topvisor: создать проект по URL, добавить поисковую систему и регион, импортировать ключевые слова через CSV, оценить стоимость проверки, запустить асинхронную проверку позиций, прочитать историю, сводку за два периода, график распределения позиций и SERP-снимки, а также посмотреть баланс аккаунта. Отдельно описана путаница между region_key (каталожный идентификатор при добавлении региона) и region_index (порядковый номер, который Topvisor присваивает после добавления и который нужен во всех остальных вызовах). README дает таблицу с реальными значениями для нескольких городов, чтобы показать, что совпадение этих чисел не гарантировано.

Для кого. Для SEO-специалистов с аккаунтом Topvisor, которым нужно отслеживать позиции в Яндексе и Google через агента.

Подходит, если

Уже есть платный аккаунт Topvisor с балансом на проверки
Нужны и Яндекс, и Google в одном отслеживании позиций по регионам
Нужны SERP-снимки на момент проверки позиций

Не подходит, если

Нет аккаунта Topvisor: сервер только оборачивает его API, без Topvisor не работает
Нужен результат проверки сразу, а не через асинхронную очередь с ручным поллингом

Пример запроса к агенту

Проверь позиции проекта green-line24.ru по ключевым словам купить окна в Самаре и Тольятти

Ограничения

Проверка позиций асинхронная и может занимать от минут до часов, встроенного ожидания результата нет, нужно вручную опрашивать topvisor_list_projects. Часть методов редактирования и удаления недокументированы Topvisor и доступны только через универсальный topvisor_request. Rate limit API не документирован, повторов при лимите сервер не делает. Инструмент неофициальный и явно не аффилирован с Topvisor.

Как отключить. Удалите блок topvisor из конфигурации MCP-клиента.

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
API-ключ Topvisor дает доступ ко всем проектам аккаунта

Коротко о README

README на английском описывает 17 инструментов таблицей, установку через npx без локальной сборки, пошаговый пример стейтфул-модели Topvisor от создания проекта до чтения истории, отдельные разделы про путаницу region_key и region_index, асинхронность проверки позиций, формат SERP-снимков и известные особенности API вроде HTTP 200 при ошибках.

Частые вопросы

В чем разница между 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.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO

Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Claude SEO

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

Скиллы DataLens

MCP Яндекс Метрики со всеми 108 методами API

OpenSEO

Claude SEO