MCP Keys.so — конкуренты, запросы доменов и частотность в Claude и ChatGPT

Через MCP-сервер Сейки ИИ-агент работает с вашим аккаунтом Keys.so — сервиса анализа конкурентов по поиску и контекстной рекламе: показывает, по каким запросам домен в выдаче, кто его конкуренты и какая у фразы частотность. 10 инструментов: 8 для чтения и пакетная проверка списка фраз — пара _quote / _run.

Что нужно

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

Инструменты Keys.so появляются в списке агента, только когда интеграция подключена. Начинать удобно с keyso_quota: он показывает, сколько запросов API и проверок списка осталось на тарифе.

Квота

Keys.so считает два счётчика, и оба списываются с вашего аккаунта Keys.so, а не с баланса Сейки:

запросы API — тратят все инструменты чтения (keyso_keyword_lookup делает два запроса; keyso_quota — один; keyso_domain_overview и keyso_competitor_pages по ещё не построенному домену — до четырёх);
проверки списка фраз — тратит пакетная проверка: одну проверку в сутки, сколько бы фраз ни было в списке; в списке — не больше 500 фраз (и не больше, чем разрешает ваш тариф).

Чтение

Инструмент	Что делает
`keyso_quota`	Остаток запросов API и проверок списка (сегодня и в этом месяце) и максимальный размер списка
`keyso_domain_overview`	Обзор домена: видимость, число запросов в топ-1/3/5/10/50, реклама, лучшие запросы, конкуренты и страницы, история за 12 месяцев
`keyso_domain_keywords`	Запросы, по которым домен (или его страница) в выдаче: позиция, URL, частотность, дата выдачи; с типизированными фильтрами
`keyso_organic_competitors`	Конкуренты домена в органике: общие запросы, видимость, запросы в топ-10 и топ-50
`keyso_competitor_pages`	Страницы конкурентов, которые ранжируются по запросам одной вашей страницы
`keyso_keyword_lookup`	Одна фраза: частотность, конкуренция, число объявлений, домены в топе, похожие фразы
`keyso_ad_competitors`	Конкуренты домена в контекстной рекламе (Яндекс Директ и Google Ads)
`keyso_check_result`	Результат уже запущенной пакетной проверки по её `uid`

Домен, который Keys.so ещё не построил, строится по запросу: если за ~20 секунд он не готов, ответ так и скажет — повторите запрос через несколько минут. Пока отчёт строится, Сейка переспрашивает Keys.so — отсюда до четырёх запросов API на один вызов. Регион задаётся базой Keys.so (msk — Яндекс Москва, по умолчанию, spb, gru — Google Москва и другие).

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

Инструменты	Что делает
`keyso_keywords_check_quote`, `keyso_keywords_check_run`	Частотность, точная частотность, число объявлений, средняя ставка и CTR для списка фраз (до 500) в одной базе

Проверка тратит квоту вашего аккаунта Keys.so, поэтому у неё два инструмента. Параметры у _quote те же, что у проверки; у _run только один — quote_id.

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

keyso_keywords_check_quote только считает цену и ничего не тратит. В ответе — quote_id, число фраз и «≈ 1 из N оставшихся проверок сегодня». Если проверок не осталось или список длиннее лимита тарифа, расчёт отклоняется.
Агент показывает вам расчёт. MCP-клиент обязан получить ваше явное подтверждение именно этого расчёта и только после него вызывать _run.
keyso_keywords_check_run принимает только quote_id и запускает ровно те параметры, что были рассчитаны — изменить их нельзя, нужен новый расчёт.

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

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

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

Проверка Keys.so отвечает сразу, поэтому _run в том же вызове читает и возвращает результат: частотность по каждой фразе. Фразы, по которым у Keys.so нет данных, в результат не попадают и названы в ответе. Если проверка стартовала, а результат прочитать не удалось, ответ даст uid — прочитайте его позже через keyso_check_result, _run повторно не вызывают. Если Keys.so не подтвердил старт, ответ скажет проверить лимиты в личном кабинете Keys.so, прежде чем делать новый расчёт.

Указание источника

Условие Keys.so: данные из сервиса показываются с пометкой «Данные получены с использованием сервиса keys.so, https://www.keys.so». Каждый ответ инструментов Keys.so заканчивается этой строкой, а сервер передаёт ответ без изменений. Если вы выводите эти данные пользователям — в отчёте, на странице или в интерфейсе, — оставляйте её рядом с данными.

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

«Сколько запросов API осталось в Keys.so и сколько проверок списка на сегодня?»
«Кто органические конкуренты seyka.ru и по скольким запросам мы пересекаемся?»
«По каким запросам mysite.ru в топ-10 Яндекса и какие у них частотности?»
«Проверь частотность этих 200 фраз в Keys.so. Сначала скажи, что это потратит»

Подключение

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