Позиции и выдача Топвизора в руках ИИ-агента
Плагин к приложению MCP открывает данные Топвизора для ИИ-агентов по протоколу Model Context Protocol. Claude, Cursor или свой скрипт подключаются к сайту и сами разбирают, что с позициями: кто вырос, кто просел, кто стоит в выдаче выше вас — и сами заводят проект, регионы, запросы и страницы аудита. 51 инструмент: 25 читающих (с ценами), 20 пишущих и 6 платных запусков; запись — только с подтверждением, всё платное — только с подтверждением цены.
Позиции и сводки
Позиции запросов по датам съёма, сводка между двумя датами (сколько запросов выросло и упало, ТОП-10/30/50/100, средняя позиция, видимость) и ряд для вопросов «как менялось за квартал». «Нет в выдаче» агент получает как null, а не как ноль.
Снимки выдачи и конкуренты
Кто стоял на местах 1…N по вашим запросам, и какие домены чаще всего попадают в ТОП — по видимости и средней позиции. Отдельно — конкуренты, добавленные в проект. Ответ по умолчанию сжат: ТОП-10 и двадцать запросов, чтобы не забивать контекст модели.
Индексация и Радар
Сколько страниц сайта в индексе Яндекса, Google и Bing и что изменилось. Радар: какие страницы поменяли title, description, H1, контент или код ответа между проверками — с прежним и новым значением по запросу.
Платные проверки под контролем
Съём позиций, частотность, релевантные страницы, кластеризация, подбор запросов и проверки аудита списывают деньги с вашего баланса в Топвизоре. Поэтому сначала агент узнаёт цену, показывает её вам, и только по вашему «да» запускает — а плагин перед запуском ещё раз сверяет цену и откажет, если она выросла. Платные проверки выключены по умолчанию, есть потолок цены, а повторный запуск той же выборки блокируется.
Запись под контролем
Агент не только читает, но и ведёт проект: создаёт проект и регионы, добавляет запросы, группы и конкурентов, включает страницы в индексацию и Радар, настраивает аудит и расписание. Каждый пишущий инструмент сначала возвращает preview — что изменится, сколько объектов, какие последствия — и ничего не отправляет, пока вы не подтвердите. Удалённые группы и запросы хранятся в корзине Топвизора 3 дня; проект можно не удалять, а отправить в архив. Запись не повторяется автоматически: если ответа нет, агент перечитывает объект, а не пишет второй раз. Права на запись выдаются отдельно — например, добавление без удаления.
Сценарии
- Проект с нуля: проект → регион → запросы (список вы видите до записи) → конкуренты → цена первого съёма → ваше «да» → позиции через несколько минут. Расписание агент предлагает только после первого съёма и с оценкой расхода в месяц.
- Аудит после выкатки: агент включает изменённые страницы в индексацию и Радар, проверяет настройки аудита, называет цену, запускает по вашему «да» и читает, что изменилось.
- Чистка запросов: частотность и позиции по проекту, список кандидатов на удаление (нулевая частота, вне ТОП-100) — вам на согласование; удаление уходит в корзину на 3 дня, а группу можно просто выключить.
- Контроль автосписаний: что и когда запускается по расписанию, сколько это стоит в месяц, как сократить — и выключение лишнего.
- Кластеризация семантики: подбор запросов (по желанию), цена кластеризации по ТОП-10, запуск по «да» и разбор новых групп-кластеров. Кластеризация перестраивает группы проекта, и агент предупреждает об этом заранее.
Деньги не тратятся втихую
У платной операции три замка, и открыть их можно только сознательно:
- право в токене MCP — без него агент не видит инструментов запуска вовсе;
- галка в настройках плагина — выключена, пока администратор не включит; цену при этом узнать можно всегда, это бесплатно;
- подтверждение цены в самом вызове — агент обязан передать цену, которую увидел пользователь; выросла — отказ, и нужно новое «да».
Сверх этого — необязательный потолок цены одного запуска, обязательный явный проект и журнал запусков в wa-log. Цену Топвизора плагин не обещает: показывает её сам Топвизор перед запуском.
Расписание, которое запускает платные проверки само, защищено теми же замками, плюс оценкой расхода в месяц до включения. Через агента включается только конкретное время («09:00»), запуски «каждый час» и чаще — только в кабинете Топвизора. Выключить расписание можно без платных проверок.
Агент предупреждён о ловушках Топвизора
Вместе с инструментами плагин отдаёт агенту страницу документации — MCP-клиент читает её сам. В ней то, обо что спотыкаются модели:
- region_index — это индекс региона внутри проекта, а не номер региона Яндекса; без путаницы с ними не работает ни один запрос позиций;
- съём асинхронный: после запуска данные появляются через минуты или часы, а ход смотрят отдельным вызовом;
- снимки выдачи есть, только если их записывали при съёме;
- меньшая позиция — лучше; за один вызов не больше 31 даты съёма;
- позиции Топвизора и средняя позиция в Вебмастере — разные цифры, сравнивать можно динамику, но не значения.
Чего здесь нет
Нет отчётов по расписанию на e-mail и в Telegram, биддера, ИИ-трекера, тегов, копирования проекта и создания папок, а также вызова произвольного метода API — он обошёл бы подтверждение цены. Разведка спроса вне проекта — в плагине «Яндекс.Вордстат для MCP»; частотность по запросам проекта считает сам Топвизор.
Что нужно для работы
- приложение MCP версии 1.3.0 или новее — оно держит сервер и токены
- аккаунт в Топвизоре с User-Id и API-ключом; ключ выдаётся после первого пополнения баланса
- исходящий HTTPS к api.topvisor.com — ни Node, ни cron, ни своих таблиц в базе плагин не требует
- MCP-клиент: Claude Desktop, Cursor, любой другой или собственный скрипт
Как подключить
- В профиле Топвизора, раздел «API», скопировать User-Id и API-ключ.
- Вставить их в настройки плагина (Приложения → MCP → Плагины → Топвизор), сохранить и выбрать проект по умолчанию.
- В токене MCP отметить права группы «Топвизор»: «Чтение» — для чтения и цен, «Запись: проекты, регионы, запросы» и «Запись: аудит и расписание» — если агент может вести проект, «Платные проверки» — только если ему разрешено запускать платные проверки.
Мы в социальных сетях
Узнавайте первыми о наших новых решениях и акциях.
- Вконтакте - https://vk.com/easyweb_su
- Телеграм - https://t.me/easyweb_su














