Надежный сборщик Yandex Wordstat
Yandex Wordstat Collector
CLI-сборщик частот Yandex Wordstat с восстановлением после сбоев: null-результат никогда не считается завершенными данными
- 3 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Каждый запрос тратит платный лимит Yandex Search API с биллингом на сервисном аккаунте
- Ключ API с правом search-api.webSearch.user хранится в переменной окружения или файле на диске
Установка
- Работает в
- Сервисы
Ручная установка
npm test && node ./bin/wordstat.js --phrases "куда вложить деньги,робо эдвайзер" --regions 225,213 --out-dir docs/analysis/wordstat --max-requests 20Установка из исходников, ключ читается из WORDSTAT_API_KEY, YANDEX_SEARCH_API_KEY или файла в ~/.config/codex-tools/.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Каждый запрос тратит платный лимит Yandex Search API с биллингом на сервисном аккаунте
- Ключ API с правом search-api.webSearch.user хранится в переменной окружения или файле на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент собирает частотность фраз через инструмент topRequests официального Yandex Search API с повторами при 429 и 5xx с задержкой и джиттером. Состояние сбора хранится в wordstat-state-v2.json тремя корзинами: завершено, не завершено, ошибка, плюс учет квоты. Ключевая идея: результат с totalCount: null никогда не считается завершенными данными, а помечается как подлежащий повтору или исчерпанный после нескольких попыток. Прерванный сбор можно продолжить командой --retry-incomplete. В комплекте Codex-скилл skills/wordstat, который при SEO-запросе дополнительно строит словарь из 25 существительных, прилагательных и глаголов, 25 примеров фраз и 10 приоритетных рекомендаций для связки заголовок плюс подзаголовок.
Для кого. Для тех, кто собирает большие списки ключевых слов из Wordstat и не хочет получить на выходе тихо неполные данные.
Подходит, если
- Нужен сбор частот по большому списку фраз с возможностью продолжить после сбоя
- Важно отличать честный ноль от временной ошибки API (null-результат)
- Нужен Codex-скилл, который сам собирает частоты и строит SEO-словарь по запросу
Не подходит, если
- Нужны данные по динамике или сезонности (dynamics), пока не реализовано, только в roadmap
- Нет сервисного аккаунта Yandex Cloud с ролью search-api.webSearch.user и активным биллингом
Пример запроса к агенту
Собери частотность Wordstat для фраз купить окна и установка окон под ключ в регионах Москва и Санкт-ПетербургОграничения
Нужен сервисный аккаунт с ролью search-api.webSearch.user на каталоге и ключ со скоупом yc.search-api.execute при активном биллинге, обычного ключа AI Studio мало. Поддержки regions и dynamics пока нет, MCP-обертки и публикации в npm тоже нет. Wordstat принимает не больше 100 запросов в час.
Как отключить. Удалите склонированный репозиторий и, если ставили Codex-скилл, папку ~/.codex/skills/wordstat.
Частые вопросы
Что делать, если часть фраз упала с ошибкой?
Запустить node ./bin/wordstat.js --retry-incomplete --out-dir docs/analysis/wordstat, инструмент подхватит только незавершенные и ошибочные пары фраза-регион из сохраненного состояния.
Почему null-результат не считается готовыми данными?
Автор объясняет: если частотность влияет на SEO-страницы или продуктовые ставки, строка с totalCount: null не прогресс, а риск, поэтому такие результаты попадают в отдельную корзину на повтор.
Обсуждение
Вопросов и отзывов пока нет.
sm-wordstat: скилл статистики Wordstat
sm-wordstat
Скилл на Python-скрипте для статистики Яндекс Wordstat: топ запросов, динамика по месяцам и распределение по регионам
Простой MCP для Яндекс Wordstat
wordstat-mcp
Компактный MCP-сервер на официальном SDK для пяти операций Яндекс Wordstat: топ, динамика, регионы, дерево регионов, данные аккаунта
MCP для Яндекс Wordstat с контролем бюджета
@cododel/yandex-wordstat-mcp
MCP-сервер на Bun для официального Yandex Wordstat API v2 с учетом стоимости запросов и лимитами расходов в рублях
Wordstat MCP Server: частоты Яндекса с лимитами и кешем
wordstat-mcp-server
Неофициальный MCP-сервер Вордстата на TypeScript, только чтение: пять инструментов, локальные лимиты вызовов, кеш регионов и счетчики расходов
MCP-сервер для Яндекс Вордстата через официальный Yandex Cloud Search API: частотность, похожие запросы, динамика и регионы
MCP-сервер к Яндекс Вордстату через Yandex Cloud Search API: частотность, динамика, регионы и построитель фраз с операторами
Коротко о README
Двуязычное README описывает философию инструмента (получить данные и знать наверняка, что они собраны), возможности: retry с backoff, resumable state, quota ledger, null-result policy, atomic writes. Показаны быстрый старт, настройка сервисного аккаунта Yandex Cloud с точными ролями и скоупами, CLI-флаги надежности, формат состояния и summary, а также встроенный Codex-скилл с субагентной оркестрацией.