vk-client-search-repetitor

# Поиск клиентов для репетитора (VK Monitor)

## 1. Description
Этот скилл предназначен для репетиторов по математике. Он автоматизирует рутинный процесс поиска учеников в социальных сетях. Агент мониторит заданный список сообществ ВКонтакте (группы для мам, доски объявлений, сообщества по поиску репетиторов), фильтрует рекламный спам от коллег-репетиторов и выделяет целевые запросы от родителей. Особое внимание уделяется запросам на онлайн-обучение. Результаты сохраняются в структурированный файл, а пользователь получает сводный отчет.

## 2. When to use
Скилл активируется при следующих запросах пользователя:
- "Найди клиентов для репетитора в ВК"
- "Кто ищет репетитора по математике онлайн?"
- "Собери запросы на репетиторство в группах"
- "Запусти мониторинг учеников по математике"
- "Найди родителей, которые ищут репетитора для ЕГЭ"
- "Поиск клиентов в ВК с приоритетом на онлайн"

## 3. How to use

Выполни следующую последовательность действий:

### Шаг 1: Инициализация и получение данных
1. **Проверь наличие конфигурации**: Убедись, что пользователь предоставил `VK Service Token` (или попроси ввести его).
2. **Получи список групп**: Запроси у пользователя список URL или ID групп ВКонтакте (10-15 шт.), если они не заданы ранее.
3. **Настрой расписание**: Установи таймер повторения задачи на каждые **3 часа**.

### Шаг 2: Сбор данных (Iterative Process)
Для каждой группы из списка:
1. Используй метод API `wall.get` (для стен) или парсинг HTML, чтобы получить последние 20-30 постов.
2. *Опционально:* Если это группа-обсуждение, проверь последние комментарии в актуальных ветках.

### Шаг 3: Анализ и Фильтрация
Для каждого поста/комментария примени логику:

**А. Фильтр "Анти-спам" (Исключение коллег)**
Если текст содержит фразы: *"предлагаю услуги", "набираю учеников", "мой стаж", "первое занятие бесплатно", "помогу с..."* — **ПРОПУСТИТЬ** (это реклама другого репетитора).

**Б. Поиск ключевых слов (Match Logic)**
Приведи текст к ни...

# 🎓 VK Client Search (Repetitor Edition)
**Скилл для OpenClaw: Автоматический поиск учеников по математике**

Этот навык превращает вашего AI-агента в неутомимого менеджера по продажам. Он каждые 3 часа сканирует целевые группы ВКонтакте, находит живые запросы от родителей и фильтрует их по приоритету (Онлайн/Офлайн).

## 🚀 Быстрый старт

1.  **Установка**: Положите папку `vk-client-search-repetitor` в директорию `/skills/` вашего OpenClaw.
2.  **Настройка**: Откройте файл `config.json` и заполните два поля:
    * `access_token`: Вставьте ваш сервисный ключ доступа VK (инструкция ниже).
    * `target_groups`: Впишите ссылки на 10-15 групп, где сидит ваша аудитория.
3.  **Запуск**: Скажите агенту: *"Запусти мониторинг клиентов в ВК"*.

## 🔑 Где взять Access Token? (Для пользователя)

Вам не нужно быть программистом. Это бесплатно и занимает 2 минуты:
1. Перейдите в [VK Developers](https://vk.com/apps?act=manage).
2. Нажмите **"Создать приложение"** (выберите "Доверенное приложение").
3. Перейдите в раздел **"Настройки"**.
4. Скопируйте **"Сервисный ключ доступа"**. Это и есть ваш `access_token`. 
*Никому не передавайте этот ключ!*

## 📊 Что вы получите на выходе?

Агент будет вести таблицу `leads_math.csv`, разделяя заявки:
* 🔥 **ВЫСОКИЙ ПРИОРИТЕТ**: Родители прямо пишут "Онлайн", "Zoom", "Skype".
* ⚡ **СРЕДНИЙ ПРИОРИТЕТ**: Общий запрос "Ищу репетитора".

Раз в 3 часа вы будете получать краткую сводку в чат: сколько новых "лидов" найдено и ссылки на них.

---
*Разработано для OpenClaw. Версия 1.0.0*