К содержимому
Начало работы

Обзор

Обновлено

Что делает плагин

«Топвизор для MCP» — плагин приложения MCP в Вебасисте. Он предоставляет ИИ-агенту инструменты API Топвизора: агент может читать SEO-данные и управлять проектами по вашим просьбам.

Владельцу сайта или магазина плагин помогает разбирать позиции и результаты проверок без ручного переноса данных в чат. Разработчик может подключить MCP-клиент или собственный скрипт и вызывать те же инструменты с правами выданного токена.

Основные возможности

  • Проекты, их поисковики и регионы, запросы, группы и добавленные конкуренты.
  • История позиций, сводка между датами и ряд средней позиции, видимости и распределения по ТОПам.
  • Снимки выдачи и домены из этих снимков с числом попавших в них URL.
  • Результаты индексации страниц и изменений Радара.
  • Создание и изменение проектов, регионов, конкурентов, групп, запросов, страниц и настроек аудита.
  • Получение стоимости и запуск съёма позиций, частотности, подбора релевантных страниц, кластеризации, подбора запросов и проверок аудита.
  • Чтение, включение и выключение расписания проверок.
  • Тариф и журнал операций по счёту Топвизора. Текущий остаток счёта API не возвращает.

Всего зарегистрирован 51 инструмент: 25 для чтения и получения цен, 20 для изменений и 6 для платных запусков. Полный список приведён в статье «Инструменты MCP».

Изменения требуют confirm=true. Платные запуски требуют confirm_price — цены, показанной пользователю и одобренной им. Доступ к инструментам ограничивается правами токена MCP.

Редакции и оплата проверок

В коде и карточке продукта нет разделения на обычную и премиум-редакции. Перечисленные возможности относятся к одному плагину. Права токена и настройка «Разрешить платные проверки» ограничивают доступ к действиям, а не выбирают редакцию.

Проверки оплачиваются в Топвизоре. Плагин получает актуальную стоимость через API перед запуском; стоимость лицензии плагина не заменяет оплату этих операций.

Совместимость и требования

Компонент Требование
Вебасист / Инсталлер Версия не ниже 2.9.0
Приложение MCP Версия не ниже 1.3.0
PHP Версия не ниже 7.4
Расширения PHP json, mbstring
Сеть сервера Исходящие HTTPS-запросы к api.topvisor.com
Топвизор Аккаунт с User-Id и API-ключом
Клиент MCP-клиент, например Claude Desktop, Cursor или собственный скрипт

Плагин работает внутри приложения MCP. Привязки к Shop-Script в требованиях нет. Собственных задач cron и CLI-команд у плагина нет; расписание выполняется в Топвизоре.

Границы возможностей

Плагин не выводит блоки на витрине и не предоставляет хелперов для темы. Не предусмотрены отправка отчётов по расписанию на e-mail или в Telegram, биддер, ИИ-трекер, управление тегами, копирование проектов и отдельный инструмент создания папок. Произвольные методы API вызывать нельзя: доступны только зарегистрированные инструменты.