MCP Topvisor — позиции и частотность в Claude и ChatGPT

Через MCP-сервер Сейки ИИ-агент работает с вашим аккаунтом Topvisor — сервиса мониторинга позиций: читает проекты, позиции, частотность и снимки выдачи, а по вашему согласию запускает платные проверки. 13 инструментов: 7 для чтения и 3 платные задачи, каждая — парой _quote / _run.

Что нужно

Topvisor, подключённый в интеграциях Сейки: указываются User ID и API-ключ вашего аккаунта Topvisor. OAuth здесь нет — Сейка хранит ключ и подставляет его сама, в конфиге ИИ-клиента живёт только ваш API-ключ Сейки.
Тариф Сейки Плюс и выше.
Для платных задач — деньги на балансе Topvisor: они списываются с него, а не с баланса Сейки.

Инструменты Topvisor появляются в списке агента, только когда интеграция подключена. Начинать нужно с topvisor_list_projects: остальные инструменты требуют project_id и индекс региона оттуда.

Чтение

Инструмент	Что делает
`topvisor_list_projects`	Проекты аккаунта с поисковыми системами и регионами — отправная точка
`topvisor_positions_summary`	Сводка по проекту в одном регионе между двумя датами: рост и падение, распределение по топ-10/30/50/100, средняя позиция, видимость
`topvisor_positions_history`	Позиции каждого запроса в одном регионе на одну или две даты; вне глубины проверки позиция пуста
`topvisor_keywords`	Запросы проекта с группой и, по желанию, частотностью для одного региона
`topvisor_snapshots`	Снимки выдачи (топ URL, домены, заголовки) по конкретным запросам на одну или две даты, до 100 запросов
`topvisor_ai_tracker_summary`	Сводка AI-трекера проекта по одной модели: упоминания и видимость
`topvisor_balance`	Баланс и тариф аккаунта Topvisor — проверьте перед платной задачей

Даты передаются как YYYY-MM-DD. Инструменты со списками принимают limit (до 200, по умолчанию 50) и offset.

Платные задачи

Три задачи тратят деньги с вашего баланса Topvisor, поэтому у каждой два инструмента:

Инструменты	Что делает
`topvisor_rank_check_quote`, `topvisor_rank_check_run`	Проверка позиций запросов проекта: все регионы и группы или выбранные (`regions_indexes`, `groups_ids`)
`topvisor_collect_volumes_quote`, `topvisor_collect_volumes_run`	Сбор частотности для всех запросов проекта по сочетаниям регион × поисковик × тип частоты (`qualifiers`)
`topvisor_cluster_quote`, `topvisor_cluster_run`	Кластеризация запросов по общей выдаче; кластеры появляются в проекте как новые (отключённые) группы

Параметры у _quote те же, что у задачи; у _run только один — quote_id.

Как это работает

<задача>_quote только считает цену и ничего не тратит. В ответе — quote_id, стоимость и описание того, что будет запущено. Если цена выше баланса Topvisor, расчёт отклоняется.
Агент показывает вам цену. MCP-клиент обязан получить ваше явное подтверждение именно этого расчёта и только после него вызывать _run.
<задача>_run принимает только quote_id и запускает ровно те параметры, что были рассчитаны — изменить их нельзя, нужен новый расчёт.

Правила расчёта:

расчёт действует 10 минут и одноразовый: после запуска или неудачной попытки нужен новый _quote;
перед стартом _run пересчитывает цену и отказывается запускать, если она выросла больше чем на 10 % против расчёта;
если на проекте уже идёт такая же проверка, повторный запуск отклоняется;
старт отправляется ровно один раз, повторно задача не запускается;
на один ключ API по умолчанию — не больше 10 платных запусков в сутки, общих для Topvisor, Rush Analytics и Keys.so (лимит может меняться); он не зависит от лимита на переобход страниц в Вебмастере.

Результат запуска

Через MCP _run ждёт завершения задачи до 40 секунд. Успела — ответ done; нет — started: задача идёт в Topvisor и закончится сама. Тогда повторно _run не вызывают, а читают результат позже: позиции — через topvisor_positions_history или topvisor_positions_summary, частотность и кластеры — через topvisor_keywords. Если Topvisor не подтвердил старт, ответ скажет проверить баланс и проект в самом Topvisor.

Примеры вопросов агенту

«Покажи мои проекты в Topvisor и как изменились позиции за месяц»
«Какие запросы выпали из топ-10 между 1 и 15 октября?»
«Сколько стоит проверить позиции проекта в Москве? Запускай, если до 200 ₽»
«Кто в топе по запросу „купить диван“ в моём проекте?»

Подключение

Быстрый старт — регистрация, интеграции, API-ключ.
Клиенты: Claude Desktop · Claude Code · Codex CLI · OpenCode · Cursor · ChatGPT.
Для данных о трафике и индексации тех же сайтов подключите Яндекс Метрику или Search Console.