Перейти к содержимому
100CTR

Автоматизация

MCP для WordStat: частотность в ИИ-ассистенте

MCP-инструменты WordStat для Claude, Codex и Cursor: частотность до 50 000 фраз, расширение семантики и прогноз показов Яндекс Директа.

Работает в кабинете 100CTRЕсть бесплатный тариф

На входе
Список фраз, регионы, устройства и тип частотности — в запросе к ассистенту
На выходе
Частотность, популярные и похожие запросы WordStat, прогноз показов и бюджета
Для чего
Проверять спрос и собирать семантику прямо в диалоге с ИИ-ассистентом

Работает в кабинете 100CTR

Инструмент использует сервер 100CTR, поэтому запускается из личного кабинета. Регистрация бесплатная и занимает минуту — нужен только e-mail.

WordStat внутри ИИ-ассистента

Чтобы ИИ-ассистент мог честно ответить на вопрос «сколько это ищут?», ему нужны данные Яндекс WordStat, а не догадки. MCP для WordStat от 100CTR даёт Claude, Codex, Cursor и другим MCP-клиентам инструменты для сбора частотности, расширения семантики и прогноза показов Яндекс Директа. Сервер облачный, адрес тот же, что и у инструментов Директа: https://mcp.100ctr.com/mcp.

Ассистент ставит задачу в очередь 100CTR, следит за прогрессом и забирает результат постранично. Для коротких списков есть быстрый инструмент: до 50 фраз, ответ приходит в том же вызове, обычно за минуту. Большие списки — до 50 000 фраз в задаче — обрабатываются в фоне, а ассистент возвращается за результатом, когда он готов.

Как пользоваться

  1. Создайте ключ с правом «WordStat и прогноз»

    В разделе «Интеграции и API» кабинета 100CTR создайте API-ключ и отметьте право wordstat. Подключать кабинет Директа для WordStat не обязательно.

  2. Добавьте MCP-сервер в ассистента

    Адрес https://mcp.100ctr.com/mcp, заголовок Authorization: Bearer <ключ>. Команды для Claude Code, Codex и Cursor — в кабинете и на страницах Claude и Codex.

  3. Попросите собрать частотность

    Например: «Узнай точную частотность этих 30 фраз по Москве». Ассистент вызовет wordstat_frequency и вернёт цифры.

  4. Для больших списков — задача

    «Расширь семантику по этим 200 фразам, регион Россия, без фраз с частотой меньше 20». Ассистент создаст задачу wordstat_create_task и будет проверять её через wordstat_get_task.

  5. Заберите результат

    Ассистент выгрузит фразы в файл или таблицу. Те же задачи видны в кабинете 100CTR в разделе WordStat — оттуда их можно скачать в CSV или отправить в проект.

Пример

Быстрая частотность из чата

Исходные данные

Какая фразовая частотность у фраз
«ремонт айфона», «замена экрана айфон»
в Санкт-Петербурге?

Результат

wordstat_frequency({
  phrases: ["ремонт айфона", "замена экрана айфон"],
  kind: "phrase",
  regions: [2]
})
→ frequencies: { фраза: частотность, … }

Тип частотности задаёт параметр kind: base — как есть, phrase — в кавычках, exact — с «!» перед словами, superexact — с фиксированным порядком слов. Регионы — идентификаторы Яндекса: 225 — Россия, 213 — Москва, 2 — Санкт-Петербург.

Инструменты MCP для WordStat и прогноза

  • wordstat_frequency — до 50 фраз; создаёт задачу частотности и ждёт результат примерно минуту. Если не успела — вернёт идентификатор задачи.
  • wordstat_create_task — задача на сбор: режим parsing (популярные и похожие запросы, левая и правая колонки WordStat) или frequency (частотность каждой фразы); параметры: регионы, устройства, тип частотности, минимальная частотность.
  • wordstat_get_task — прогресс и страница результатов (до 1 000 строк за вызов), фильтр по колонке и минимальной частотности.
  • direct_forecast_create — прогноз показов, кликов, CTR, ставки и бюджета Яндекс Директа по фразам, с регионами (в том числе минус-регионами) и периодом.
  • direct_forecast_get — статус и результаты прогноза.

Очередь и скорость

Сбор идёт через очередь: задачи разных пользователей обрабатываются по очереди небольшими порциями, а короткие задачи получают приоритет над огромными. Поэтому запрос на 30 фраз не будет ждать, пока закончится чужая выгрузка на 50 000. Частичные результаты видны по мере выполнения — ассистент может начать анализ, не дожидаясь конца.

Если источник данных временно недоступен, фраза повторяется автоматически; фразы, которые так и не удалось обработать, помечаются отдельно, и за них лимит возвращается.

Лимиты и стоимость

Каждая уникальная фраза задачи — одна единица месячного лимита WordStat: 300 фраз на тарифе Free, 10 000 на Pro (590 ₽ в месяц) и 50 000 на «Агентстве»; сверх лимита можно докупить пакет 10 000 фраз за 290 ₽. На Free также действует лимит 100 вызовов MCP в сутки. Дубликаты и пустые строки не списываются. Прогноз Директа расходует тот же лимит. При отмене задачи необработанные фразы возвращаются в лимит сразу.

Сценарии для ассистента

  • Проверить, ищут ли вообще формулировки из брифа клиента, и отсеять нулевые.
  • Расширить семантику по маркерам и сразу сгруппировать фразы по смыслу.
  • Сравнить спрос по регионам перед запуском кампании.
  • Оценить бюджет: частотность → прогноз показов и кликов → ставка и бюджет для первого места.
  • Собрать семантику и передать её в генератор объявлений 100CTR.

REST API для своих скриптов

Те же операции доступны без MCP — по REST API с тем же ключом: /api/v1/wordstat и /api/v1/forecast на api.100ctr.com, заголовок Authorization: Bearer 100ctr_.... Это удобно для регулярных выгрузок по расписанию.

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

Нужно ли подключать кабинет Яндекс Директа?

Для WordStat и прогноза — нет. Достаточно API-ключа 100CTR с правом «WordStat и прогноз».

Сколько фраз можно отправить за раз?

Быстрый инструмент wordstat_frequency — до 50 фраз. Задача wordstat_create_task — до 50 000 фраз, в пределах месячного лимита тарифа.

Какие типы частотности поддерживаются?

Базовая, фразовая (в кавычках), точная (с «!») и с фиксированным порядком слов (в квадратных скобках). Фразы с уже расставленными операторами отправляются как есть.

Можно ли выбрать устройства?

Да: компьютеры, телефоны и планшеты — по отдельности или вместе. По умолчанию — все устройства.

Где посмотреть задачи, созданные ассистентом?

В кабинете 100CTR, в разделе WordStat. Задачи из MCP помечены источником и доступны для выгрузки в CSV и отправки в проект.

Что если часть фраз не обработалась?

Задача завершится с частичным результатом, а необработанные фразы вернутся в лимит. Их список ассистент или вы можете посмотреть отдельно.

Похожие инструменты

Соберите всю кампанию за один проход

В проекте 100CTR фразы группируются автоматически, в каждую группу пишутся объявления с подстановкой ключа, а результат выгружается файлом для Директ Коммандера.

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