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

---

name: vk-client-search-repetitor

description: Автоматический поиск клиентов (родителей) для репетитора по математике в группах ВКонтакте с умной фильтрацией и приоритизацией онлайн-запросов.

version: 1.0.0

author: OpenClaw @Danil4091

permissions:

- internet_access

- file_system_read_write

- schedule_task

---

# Поиск клиентов для репетитора (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)**

Приведи текст к нижнему регистру и ищи совпадения:

* **Группа 1 (База):** "репетитор", "математик", "ищу репетитора", "нужен репетитор", "помогите с математикой", "подтянуть", "алгебра", "геометрия".

* **Группа 2 (Приоритет - Онлайн):** "онлайн", "скайп", "skype", "zoom", "зум", "дистанционно", "удаленно".

* **Группа 3 (Маркеры качества):** "ЕГЭ", "ОГЭ", "олимпиада", "поступление", "ДВИ", "физмат", "лицей", "цена не важна".

**В. Определение приоритета**

* **ВЫСОКИЙ:** Найдены слова из Группы 1 **И** Группы 2.

* **ВЫСОКИЙ:** Найдены слова из Группы 1 **И** "цена не важна".

* **СРЕДНИЙ:** Найдены только слова из Группы 1.

* **НИЗКИЙ/ИГНОР:** Ключевых слов нет.

Шаг 4: Сохранение данных

Если найдено совпадение (Средний или Высокий приоритет):

1. Проверь, нет ли уже этой ссылки в базе (избегай дублей).

2. Сформируй запись и добавь её в файл `leads_math.csv` (или Google Sheet, если подключен).

**Формат записи:**

`Дата_Время | Название_Группы | Ссылка_на_пост | Имя_Автора | Текст_Запроса (первые 100 симв.) | Ключевики | Приоритет | Статус`

*Примечание: Поле "Статус" по умолчанию заполнять значением "НОВЫЙ".*

Шаг 5: Отчетность

После завершения цикла проверки всех групп сгенерируй краткий отчет для пользователя.

4. Configuration

Для корректной работы пользователю необходимо предоставить:

1. **VK_API_TOKEN**: Сервисный ключ доступа приложения (Service Token) для чтения открытых стен.

2. **TARGET_GROUPS**: Список ID групп (например: `[-123456, -987654]`) или ссылок. Рекомендуются группы: "Подслушано [Город]", "Мамочки [Город]", "Репетиторы поиск", "Биржа репетиторов".

3. **OUTPUT_PATH**: Путь к файлу для сохранения (по умолчанию: `./vk_leads_data.csv`).

5. Edge cases

* **Группа закрыта/удалена:** Залогировать ошибку "Ошибка доступа к группе [ID]", продолжить проверку следующих групп. Не прерывать работу.

* **Лимит запросов API (Too Many Requests):** Если VK API возвращает ошибку лимита, сделать паузу на 60 секунд и повторить запрос.

* **Нет новых постов:** Если за 3 часа в группах нет новых релевантных постов, отправить отчет: "Проверено [N] групп. Новых заявок не найдено."

* **Слишком длинный текст поста:** В таблицу сохранять только первые 150-200 символов, чтобы не ломать верстку CSV.

6. Example output

**Пример отчета после цикла проверки:**