v2.0.0 to v2.0.0

1 added, 1 removed. Audit A to A.

---

name: wordstat-collector

- description: "Яндекс.Вордстат через API. Автоматический сбор поисковой семантики для AI-агента. 100 запросов/час."

+ description: "Яндекс.Вордстат через API — автоматический сбор поисковой семантики для AI-агента (100 запросов/час). Use when нужна частотность, сезонность и кластеризация запросов для RU-рынка — «собери семантику», «вордстат», «частотность запросов», keyword research для Яндекса."

version: 2.0.0

install: "npx hermes skill install axelfreeman/yandex-wordstat-guide"

requires:

env: [WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID]

apis: [yandex-search-api]

---

# Wordstat Collector

## Что делает

Собирает поисковую статистику Яндекса через API и возвращает структурированные данные. Агент может использовать их для генерации SEO-страниц, рекламных кампаний и контент-планов.

## Команды для агента

```

«Собери семантику по теме [тема] через Wordstat»

«Покажи топ-20 запросов по [ключ]»

«Сгенерируй SEO-страницы на основе семантики из semantic_results.json»

```

## Переменные

```bash

WORDSTAT_API_KEY # API-ключ Яндекс.Облака

WORDSTAT_FOLDER_ID # ID каталога (20 символов)

```

## Скрипт

`scripts/collect.py` — принимает список seed-фраз, возвращает JSON с фразами и частотами.

```bash

python3 scripts/collect.py "фраза1" "фраза2"

```

## Лимиты

- 100 запросов в час

- 0.3 sec между запросами

- Не больше 90 запросов за сессию (запас 10%)

## Питфоллы

- Все числа приходят строками → `int(count)`

- folderId ровно 20 символов → `.strip()`

- Дата для dynamics — последний день месяца/недели