# filtering-bot-traffic

Скилл filtering-bot-traffic учит агента отделять в PostHog людей от ботов и AI-краулеров: чистит метрики или показывает, какая доля трафика пришла от роботов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 208 установок · ★ 101 у репозитория
- Автор: PostHog
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/filtering-bot-traffic/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/filtering-bot-traffic

## Что делает

Скилл даёт агенту карту классификации трафика в PostHog. Каждый запрос разбирается по user agent и попадает в одну из четырёх групп: `Regular`, `AI Agent`, `Bot`, `Automation`. Дальше агент либо выкидывает лишнее из инсайта, либо считает, сколько пришло от роботов и какая компания ими управляет.

В конструкторе инсайтов и в фильтрах работают виртуальные свойства: `$virt_is_bot`, `$virt_traffic_type`, `$virt_traffic_category`, `$virt_bot_name`, `$virt_bot_operator`. Они сами читают user agent, передавать ничего не нужно. В ручном SQL те же ответы дают функции `isLikelyBot`, `getTrafficType`, `getBotType` и соседние.

В HogQL аргумент передают как есть — `properties.$raw_user_agent`. Обернёшь его в `coalesce(...)`, и события серверных и мобильных SDK перестанут попадать под исключение для пустого user agent, а счётчики ботов раздуются. Фильтр меняет только цифры в запросе, сохранённые события остаются на месте. За живьём и плитками на вкладке Live иди в соседний скилл `exploring-live-traffic`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill filtering-bot-traffic -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill filtering-bot-traffic -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill filtering-bot-traffic -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install PostHog/ai-plugin skills/filtering-bot-traffic
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill filtering-bot-traffic -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/PostHog/ai-plugin --path skills/filtering-bot-traffic
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add PostHog/ai-plugin --skill filtering-bot-traffic -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/PostHog/ai-plugin/tree/HEAD/skills/filtering-bot-traffic/SKILL.md

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

## Примеры запросов агенту
- Убери ботов из просмотров страниц: оставь только события, где `$virt_is_bot` равно false.
- Сколько трафика за месяц дают AI-краулеры? Разбей по `$virt_bot_name`.
- Покажи, какие операторы ботов чаще всего заходят в документацию.

## Похожие
- [exploring-live-traffic](https://affpapa.org/nevibecode/skills/exploring-live-traffic.md) — скилл · 469 установок
- [seo-traffic-diagnosis](https://affpapa.org/nevibecode/skills/seo-traffic-diagnosis.md) — скилл · 290 установок
- [similarweb-traffic](https://affpapa.org/nevibecode/skills/similarweb-traffic.md) — скилл · 227 установок
- [traffic-analysis](https://affpapa.org/nevibecode/skills/traffic-analysis.md) — скилл · 1300 установок
- [seo-posthog](https://affpapa.org/nevibecode/skills/seo-posthog.md) — скилл · 141 установка
- [querying-posthog-data](https://affpapa.org/nevibecode/skills/querying-posthog-data.md) — скилл · 890 установок

Из того же набора: [posthog/ai-plugin](https://affpapa.org/nevibecode/by/posthog/ai-plugin.md) — 82 карточки

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