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

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

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

Подключите WordStat к OpenAI Codex через MCP-сервер 100CTR: блок для config.toml, ключ в переменной окружения, частотность и прогноз Директа в задачах Codex.

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

На входе
API-ключ 100CTR с правом «WordStat и прогноз» и Codex CLI или расширение Codex
На выходе
Codex получает частотность, похожие запросы и прогноз и сохраняет их в файлы проекта
Для чего
Встроить сбор семантики в скрипты и рабочие задачи Codex

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

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

WordStat для Codex: зачем и как

Codex от OpenAI работает с файлами и командами: читает списки из репозитория, запускает скрипты, сохраняет результат в CSV. Если подключить к нему MCP-сервер 100CTR, в этот рабочий процесс встраиваются данные Яндекс WordStat. Codex сам получает частотность, собирает популярные и похожие запросы, строит прогноз показов Директа и записывает итог туда, куда вы скажете, — например в semantics/freq.csv рядом с остальными материалами кампании.

Подключение — три строки в ~/.codex/config.toml и переменная окружения с API-ключом. Ключ создаётся в кабинете 100CTR с правом «WordStat и прогноз»; рекламный кабинет Директа для этого подключать не нужно. Сервер облачный: https://mcp.100ctr.com/mcp, устанавливать ничего не требуется.

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

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

    Раздел «Интеграции и API» в кабинете 100CTR → новый ключ → отметьте только это право. Ключ показывается один раз, сохраните его в менеджере паролей.

  2. Положите ключ в переменную окружения

    macOS и Linux: строка export CTR100_API_KEY="100ctr_..." в ~/.zshrc или ~/.bashrc. Windows: setx CTR100_API_KEY "100ctr_...", затем откройте новый терминал — setx не меняет уже открытые окна.

  3. Добавьте сервер в config.toml

    Откройте ~/.codex/config.toml (в Windows — %USERPROFILE%\.codex\config.toml) и вставьте блок [mcp_servers."100ctr"] из примера ниже. Файл общий для Codex CLI и расширения Codex в редакторе.

  4. Перезапустите Codex и проверьте

    Выполните /mcp: сервер 100ctr должен быть в списке, а среди инструментов — wordstat_frequency, wordstat_create_task, wordstat_get_task, direct_forecast_create и direct_forecast_get.

  5. Дайте задачу с файлами

    Например: «Возьми фразы из semantics/raw.txt, получи точную частотность по России и сохрани в semantics/freq.csv». Codex прочитает файл, вызовет инструменты и запишет результат.

Примеры

Блок для ~/.codex/config.toml

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

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

Результат

[mcp_servers."100ctr"]
url = "https://mcp.100ctr.com/mcp"
bearer_token_env_var = "CTR100_API_KEY"

Codex подключается к серверу по Streamable HTTP и сам формирует заголовок Authorization: Bearer из переменной CTR100_API_KEY. В конфигурации ключа нет, поэтому файл можно спокойно переносить между машинами.

Частотность из файла проекта в CSV

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

Прочитай semantics/raw.txt (38 фраз), узнай точную частотность в Санкт-Петербурге и сохрани в semantics/freq.csv, отсортировав по убыванию.

Результат

Вызов: wordstat_frequency, kind: exact, regions: [2]

semantics/freq.csv
phrase;frequency
купить диван;2140
диван кровать купить;1380
угловой диван купить;960
диван с ортопедическим матрасом;310
…

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

Цифры условные. До 50 фраз результат приходит за один вызов; если очередь не успела за минуту, Codex получит идентификатор задачи и дочитает результат через wordstat_get_task.

Большой список: фоновая задача

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

Расширь семантику по 300 маркерам из markers.txt, регион Россия, только телефоны, отбрось фразы реже 20 показов. Результат — в parsed.csv с колонками phrase, frequency, source.

Результат

Вызов: wordstat_create_task, mode: parsing,
  regions: [225], devices: [phone], minFrequency: 20
Прогресс: 120 / 300 … 300 / 300 — готово
wordstat_get_task: 4 страницы по 1 000 строк

parsed.csv: 3 412 уникальных фраз
Списано: 300 фраз

Codex проверяет прогресс задачи и забирает результаты страницами до 1 000 строк. Колонка source в файле — исходный маркер, из которого найдена фраза.

Сценарии, где Codex удобнее чата

Codex ценен там, где семантика живёт в файлах и проходит через несколько шагов обработки. Он может прочитать выгрузку из CRM, нормализовать фразы скриптом, получить частотность, отфильтровать нули и подготовить таблицу для импорта — в одной задаче, без ручного копирования между вкладками.

  • Регулярная проверка спроса: файл с маркерами в репозитории, Codex обновляет частотность раз в месяц и показывает разницу с прошлым запуском.
  • Чистка семантики перед запуском: убрать фразы с нулевой частотностью, затем передать оставшиеся в кластеризацию.
  • Прогноз бюджета по готовому списку: direct_forecast_create по фразам кампании, результат — таблица с показами, кликами и ставками в forecast.csv.
  • Сравнение регионов: один список, несколько регионов, итоговая сводная таблица.

Параметры, которые Codex передаёт в WordStat

  • kind — тип частотности: base (базовая), phrase (фразовая, в кавычках), exact (точная, с !), superexact (с фиксированным порядком слов). Фразы с уже расставленными операторами отправляются как есть.
  • regions — идентификаторы регионов Яндекса: 225 — Россия, 213 — Москва, 2 — Санкт-Петербург; пустой список — все регионы. Для прогноза Директа регион можно исключить знаком минус.
  • devices — desktop, phone, tablet; без параметра учитываются все устройства.
  • mode — для задач: parsing собирает левую и правую колонки WordStat, frequency возвращает частотность каждой фразы.
  • minFrequency — отсекает редкие фразы ещё на стороне сервера, чтобы не тащить их в файлы.

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

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

Быстрый инструмент wordstat_frequency рассчитан на 50 фраз за вызов. Задача wordstat_create_task принимает до 50 000 фраз, но не больше остатка лимита: если фраз не хватает, сервер откажет до начала сбора, и Codex сообщит об этом. Перед большим запуском попросите Codex сначала посчитать уникальные фразы в файле.

Безопасность и права

Ключ хранится только в переменной окружения: параметр bearer_token_env_var говорит Codex, откуда взять значение, и в config.toml оно не попадает. Не добавляйте ключ в файлы репозитория и в промпты — Codex может сохранить их содержимое в истории задачи.

Ключ с одним правом «WordStat и прогноз» не открывает инструменты кампаний Директа и VK Рекламы: сервер фильтрует список по правам ключа и проверяет их при каждом вызове. Если позже понадобится работа с кабинетом, создайте для этого отдельный ключ — настройка описана на странице Codex и Яндекс Директ.

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

Нужен ли подключённый кабинет Директа?

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

Codex пишет 401 Unauthorized. Что не так?

Чаще всего Codex не видит переменную окружения: проверьте echo $CTR100_API_KEY (в PowerShell — $env:CTR100_API_KEY) в том же терминале, где запускаете Codex. Если переменная на месте — ключ мог быть отозван.

Работает ли это в расширении Codex для редактора?

Да, расширение читает тот же ~/.codex/config.toml. Переменная окружения должна быть видна процессу редактора — после setx перезапустите его.

Можно ли указать ключ прямо в config.toml?

Технически можно через заголовки, но тогда ключ окажется в файле, который легко скопировать или закоммитить. bearer_token_env_var безопаснее.

Сколько фраз Codex может обработать за раз?

До 50 фраз с ответом в том же вызове и до 50 000 фраз в фоновой задаче — в пределах месячного лимита тарифа.

Где посмотреть задачи, которые запустил Codex?

В кабинете 100CTR, раздел WordStat: задачи из MCP помечены источником, их можно скачать в CSV или отправить в проект.

Есть ли такая же настройка для Claude?

Да, сервер тот же — инструкция для Claude Code и Claude Desktop на странице WordStat в Claude.

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

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

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

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