# Yandex Wordstat

> |

- **Type:** Skill
- **Install:** `agentstack add skill-atomachinskiy-claude-yandex-skills-yandex-wordstat`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [atomachinskiy](https://agentstack.voostack.com/s/atomachinskiy)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [atomachinskiy](https://github.com/atomachinskiy)
- **Source:** https://github.com/atomachinskiy/claude-yandex-skills/tree/main/plugins/yandex-wordstat/skills/yandex-wordstat

## Install

```sh
agentstack add skill-atomachinskiy-claude-yandex-skills-yandex-wordstat
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# yandex-wordstat

Анализ поискового спроса в Яндексе. **Один скилл, два бэкенда.**

## Backends

| Backend | Когда использовать | Конфиг | Доступ |
|---|---|---|---|
| `legacy` | Если есть одобренная заявка в Директе под прошлым приложением (`YANDEX_WORDSTAT_TOKEN`) | `YANDEX_WORDSTAT_TOKEN` в `.env` | Yandex закрыл onboarding для новых юзеров |
| `cloud` | Yandex Cloud Search API v2 — preview, для новых пользователей | `YANDEX_CLOUD_FOLDER_ID` + `YANDEX_CLOUD_SA_KEY_FILE` | SA с ролью `search-api.user` |
| auto | Auto-resolve | Если есть SA-key → cloud, иначе → legacy | по контексту |

Override через `YANDEX_WORDSTAT_BACKEND=legacy|cloud` в `config/.env`.

## Configuration

### Legacy (для существующих пользователей)

```
# config/.env
YANDEX_WORDSTAT_TOKEN=
```

Если у тебя был отдельный OAuth-app под Wordstat с одобренной заявкой — токен оттуда работает here as-is.

Если такого нет, скилл попробует использовать общий токен из `yandex-auth/secrets/yandex-app.json`. Скорее всего вернёт 403, потому что новые приложения не получают `direct:api-stats` scope автоматически.

### Cloud (для новых пользователей)

```
# config/.env
YANDEX_WORDSTAT_BACKEND=cloud
YANDEX_CLOUD_FOLDER_ID=b1g0123456789abc
YANDEX_CLOUD_SA_KEY_FILE=/Users//.claude/secrets/yandex-cloud-sa-key.json
```

Создание SA и выпуск ключа:

```bash
yc iam service-account create --name claude-wordstat
yc iam key create --service-account-name claude-wordstat \
  --output ~/.claude/secrets/yandex-cloud-sa-key.json
yc resource-manager folder add-access-binding  \
  --role search-api.user \
  --service-account-name claude-wordstat
```

Скилл сам генерит JWT (PS256), обменивает на IAM token, кеширует на 1 час.

## Workflow

### Sanity-check

```bash
bash scripts/top-requests.sh "таргетолог" --limit 5
```

Должен вывести шапку с `backend: legacy|cloud`, total volume и top-N запросов.

## Скрипты

| Скрипт | Назначение | Аргументы |
|---|---|---|
| `top-requests.sh` | Топ запросов по фразе с частотностью | ` [--region 225] [--limit 30] [--json] [--full]` |
| `common.sh` | Backend dispatcher, JWT/IAM helper, call wrappers | — |

## Регионы

`225` — Россия (default). Список region IDs: https://yandex.ru/dev/wordstat/doc/concepts/geographyRussia.html

Несколько регионов через запятую: `--region 225,213,2`.

## Особенности

- **Cloud caveat**: при `dynamics` operator restriction — для weekly/monthly работает только оператор `+`. Минус-слова, кавычки и группировки — только daily.
- **Rate limit**: легаси — 1000 запросов/день на токен. Cloud — по квоте Yandex Cloud.
- **Кеш**: `cache/iam_token.txt` хранит IAM на 1 час (cloud backend).

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [atomachinskiy](https://github.com/atomachinskiy)
- **Source:** [atomachinskiy/claude-yandex-skills](https://github.com/atomachinskiy/claude-yandex-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-atomachinskiy-claude-yandex-skills-yandex-wordstat
- Seller: https://agentstack.voostack.com/s/atomachinskiy
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.