# search-term-miner

Разбирает отчёты по поисковым фразам рекламы, находит конвертящие запросы для новых объявлений и отсекает неэффективные траты через списки минус-слов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 установок · ★ 3013
- Автор: aaron-he-zhu
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/ad/research/search-term-miner/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/search-term-miner

## Что делает

Скилл обрабатывает выгрузки поисковых фраз рекламных систем. Он находит запросы с конверсиями выше заданного порога и распределяет их в новые ключевые слова или подходящие группы объявлений. Для запросов с расходом и нулевым результатом инструмент составляет перечень минус-слов с точным или фразовым соответствием.

Скилл разбивает неконвертящие фразы на токены из одного, двух или трёх слов. Затем он подсчитывает расходы по каждому токену и формирует диффы изменений на добавление и исключение. Результаты и оценку фактора Spend-efficiency инструмент сохраняет в каталог `memory/ad/search-term-miner/`.

Инструменту обязательно нужны столбцы стоимости и конверсий в исходном файле. Без данных о конверсиях скилл сразу остановит работу — на одних только кликах он решения не принимает. Архитектуру аккаунта и общий бюджет он также не настраивает.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill search-term-miner -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/search-term-miner/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/search-term-miner/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill search-term-miner -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/search-term-miner/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill search-term-miner -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/search-term-miner/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aaron-he-zhu/aaron-marketing-skills search-term-miner
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/search-term-miner/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill search-term-miner -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aaron-he-zhu/aaron-marketing-skills --path ad/research/search-term-miner
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/search-term-miner/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aaron-he-zhu/aaron-marketing-skills --skill search-term-miner -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/HEAD/ad/research/search-term-miner/SKILL.md

## Когда брать
- выгрузить конвертящие поисковые запросы в новые ключевые фразы
- собрать список минус-слов для кампаний и общих списков
- выявить токены и фразы, впустую расходующие рекламный бюджет
- рассчитать оценку фактора Spend-efficiency для анализа ROAS

## Примеры запросов агенту
- Разбери поисковые запросы из отчёта `search-terms.csv` с целью `direct-response` и колонкой конверсий `Conversions`.
- Собери список минус-слов и отчёт по n-граммам без конверсий из файла `search-terms.csv`.
- Какие конвертящие фразы из отчёта `terms.csv` стоит превратить в новые ключевые слова?

## Похожие
- [google-ads-manager](https://affpapa.org/nevibecode/skills/google-ads-manager.md) — скилл · 6300 установок
- [amazon-search-optimization](https://affpapa.org/nevibecode/skills/amazon-search-optimization.md) — скилл · 1200 установок
- [ad-account-diagnostic](https://affpapa.org/nevibecode/skills/ad-account-diagnostic.md) — скилл · 20600 установок
- [ad-negative-keywords](https://affpapa.org/nevibecode/skills/ad-negative-keywords.md) — скилл · 20500 установок
- [ads-plan](https://affpapa.org/nevibecode/skills/ads-plan.md) — скилл · 4000 установок
- [google-ads](https://affpapa.org/nevibecode/skills/google-ads.md) — скилл · 1600 установок

Из того же набора: [aaron-he-zhu/aaron-marketing-skills](https://affpapa.org/nevibecode/by/aaron-he-zhu/aaron-marketing-skills.md) — 116 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md