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

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

WordStat в Claude: частотность и семантика через MCP

Подключите WordStat к Claude Code или Claude Desktop: частотность, популярные и похожие запросы и прогноз Директа прямо в диалоге. Настройка за 2 минуты.

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

На входе
API-ключ 100CTR с правом «WordStat и прогноз» и Claude Code или Claude Desktop
На выходе
Claude сам получает частотность, расширяет семантику и делает прогноз показов
Для чего
Собирать и чистить семантику в диалоге с Claude без выгрузок из WordStat

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

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

Как подключить WordStat к Claude

Claude хорошо группирует запросы, чистит семантику и пишет объявления, но собственных данных о спросе в Яндексе у него нет: на вопрос «сколько это ищут» он может только предполагать. Чтобы в диалоге появились настоящие цифры WordStat, подключите к Claude MCP-сервер 100CTR. После этого Claude сам запрашивает частотность, собирает популярные и похожие запросы и строит прогноз показов Директа — без ручных выгрузок и копирования таблиц.

Сервер облачный и ничего не требует устанавливать: адрес https://mcp.100ctr.com/mcp, авторизация — API-ключ 100CTR в заголовке Authorization: Bearer. Для WordStat не нужно подключать рекламный кабинет Директа: достаточно бесплатного аккаунта и ключа с правом «WordStat и прогноз». Ниже — настройка для Claude Code и Claude Desktop, примеры запросов и ответы, которые вы получите.

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

  1. Создайте API-ключ

    В кабинете 100CTR откройте «Интеграции и API», создайте ключ и отметьте только право «WordStat и прогноз». Скопируйте ключ сразу — полностью он показывается один раз.

  2. Подключите сервер в Claude Code

    Выполните в терминале claude mcp add --transport http 100ctr https://mcp.100ctr.com/mcp --header "Authorization: Bearer <ВАШ_КЛЮЧ>" --scope user. С --scope user сервер будет доступен во всех ваших проектах.

  3. Или в Claude Desktop

    Откройте «Настройки → Разработчик → Изменить конфигурацию» и добавьте сервер 100ctr в claude_desktop_config.json через мост mcp-remote (блок ниже). Нужен установленный Node.js. Перезапустите приложение.

  4. Проверьте подключение

    В Claude Code выполните /mcp: сервер 100ctr должен быть в статусе подключённого, а в списке инструментов — wordstat_frequency, wordstat_create_task и другие. В Claude Desktop инструменты появятся в меню чата.

  5. Задайте первый вопрос

    Например: «Узнай фразовую частотность для этих 10 фраз по Москве». Claude вызовет инструмент, дождётся данных и покажет таблицу.

Примеры

Настройка Claude Code через .mcp.json

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

Переменная окружения:
CTR100_API_KEY=100ctr_…

Файл .mcp.json в корне проекта:

Результат

{
  "mcpServers": {
    "100ctr": {
      "type": "http",
      "url": "https://mcp.100ctr.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CTR100_API_KEY}"
      }
    }
  }
}

Claude Code подставит значение переменной CTR100_API_KEY при запуске, поэтому файл можно хранить в репозитории: ключа в нём нет. Для Claude Desktop используйте блок с "command": "npx" и "args": ["-y", "mcp-remote", "https://mcp.100ctr.com/mcp", "--header", "Authorization:${AUTH_HEADER}"], а ключ передайте в env как AUTH_HEADER.

Частотность для короткого списка

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

Какая фразовая частотность у этих фраз в Москве?
ремонт посудомоечной машины
ремонт посудомойки на дому
замена тэна посудомоечной машины
не сливает воду посудомойка

Результат

Вызов: wordstat_frequency, kind: phrase, regions: [213]

Фраза                                  | Частотность
ремонт посудомоечной машины            | 4 870
не сливает воду посудомойка            | 1 920
ремонт посудомойки на дому             |   610
замена тэна посудомоечной машины       |   240

Списано из лимита WordStat: 4 фразы

Цифры в примере условные. Для списка до 50 фраз ответ приходит в том же вызове, обычно в течение минуты. Если очередь загружена, Claude получит идентификатор задачи и заберёт результат позже через wordstat_get_task.

Расширение семантики и группировка

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

Собери популярные и похожие запросы по маркерам «ремонт посудомоечной машины» и «ремонт стиральной машины», регион Россия, без фраз реже 30 показов. Сгруппируй по типу поломки.

Результат

Вызов: wordstat_create_task, mode: parsing, regions: [225], minFrequency: 30
Статус: выполняется → готово

Не сливает воду — 14 фраз
Не греет воду — 9 фраз
Течёт — 11 фраз
Ошибки на дисплее — 17 фраз
Общие («ремонт … на дому», «мастер по ремонту …») — 23 фразы

Списано: 2 фразы (по одной на маркер)

В режиме сбора лимит расходуется по числу исходных фраз, а не по числу найденных запросов. Готовые группы удобно перенести в кластеризацию или сразу в проект 100CTR.

Что умеет Claude с WordStat через MCP

Ключ с правом «WordStat и прогноз» открывает Claude пять инструментов. Остальные инструменты сервера (работа с кампаниями Директа и VK Рекламы) в его списке не появятся, пока вы не дадите ключу соответствующие права и не подключите кабинет.

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

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

Ещё запросы, которые стоит попробовать

  • «Проверь точную частотность фраз из файла semantics.txt и удали те, у которых меньше 10 показов в месяц» — Claude Code прочитает файл, отправит фразы задачей и перепишет файл.
  • «Сравни спрос на "натяжные потолки" в Москве и Санкт-Петербурге с телефонов» — два вызова с разными регионами и фильтром устройств.
  • «Сделай прогноз бюджета по этим 40 фразам на ближайший месяц для Москвы без Зеленограда» — прогноз с минус-регионом.
  • «Найди в собранных запросах нецелевые слова и предложи список минус-слов» — Claude работает с уже полученными данными, лимит не расходуется повторно.

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

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

Быстрый вызов wordstat_frequency рассчитан на 50 фраз; если передать больше, задача уйдёт в фон. Одна задача wordstat_create_task вмещает до 50 000 фраз, но не больше остатка лимита. Остаток виден в кабинете — там же лежат все задачи, созданные Claude, с пометкой источника, их можно скачать в CSV или отправить в проект.

Безопасность ключа

Права ключа проверяются на сервере при каждом вызове, поэтому ключ «только WordStat» не даст Claude доступа к рекламным кабинетам, даже если об этом попросить в промпте. Заведите для Claude отдельный ключ: его можно отозвать в «Интеграциях и API», не затрагивая другие подключения.

Не вставляйте ключ в общие файлы проекта. Для Claude Code храните его в переменной окружения CTR100_API_KEY и ссылайтесь на неё из .mcp.json; для Claude Desktop ключ лежит в локальном конфиге на вашем компьютере. Claude Code по умолчанию спрашивает подтверждение перед вызовом инструмента — это удобный момент проверить, сколько фраз уйдёт в задачу.

Если используете Claude в браузере

Веб-версия Claude подключает удалённые серверы как коннекторы с авторизацией через OAuth, а сервер 100CTR принимает API-ключ в заголовке. Поэтому для WordStat используйте Claude Code или Claude Desktop. Если вам удобнее другой ассистент, посмотрите настройку для Codex или общую страницу MCP для WordStat.

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

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

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

Какой тариф Claude нужен?

Любой, в котором доступны Claude Code или Claude Desktop с MCP-серверами. Со стороны 100CTR хватит бесплатного тарифа: 300 фраз в месяц и до 100 вызовов MCP в сутки.

Почему Claude вернул идентификатор задачи вместо цифр?

Фраз было больше 50 или очередь не успела обработать их за минуту. Попросите Claude проверить задачу позже — он вызовет wordstat_get_task с тем же идентификатором, лимит повторно не спишется.

Чем это отличается от парсера WordStat на сайте?

Данные и лимит общие. Парсер WordStat удобен для разовой выгрузки в таблицу, а через MCP Claude сам ставит задачи и сразу анализирует результат в диалоге.

Можно ли отправить фразы с операторами?

Да. Фраза, в которой уже есть кавычки, ! или квадратные скобки, отправляется как есть. Если операторов нет, их расставит сервер по выбранному типу частотности.

Сервер 100ctr не появился в /mcp. Что проверить?

Что команда выполнена без ошибок и Claude Code перезапущен, что в заголовке есть слово Bearer перед ключом и что ключ не отозван. При ошибке 401 создайте новый ключ.

Видны ли задачи Claude в кабинете?

Да, в разделе WordStat. Их можно скачать в CSV, отфильтровать по частотности или отправить фразы в проект для генерации объявлений.

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

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

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

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