{
  "schemaVersion": "1.0",
  "item": {
    "slug": "vk-client-search-repetitor",
    "name": "Автоматический поиск клиентов (родителей) для репетитора по математике в группах ВКонтакте с умной фильтрацией и приоритизацией онлайн-запросов.",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Danil4091/vk-client-search-repetitor",
    "canonicalUrl": "https://clawhub.ai/Danil4091/vk-client-search-repetitor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/vk-client-search-repetitor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=vk-client-search-repetitor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "config.json",
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/vk-client-search-repetitor"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/vk-client-search-repetitor",
    "agentPageUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "1. Description",
        "body": "Этот скилл предназначен для репетиторов по математике. Он автоматизирует рутинный процесс поиска учеников в социальных сетях. Агент мониторит заданный список сообществ ВКонтакте (группы для мам, доски объявлений, сообщества по поиску репетиторов), фильтрует рекламный спам от коллег-репетиторов и выделяет целевые запросы от родителей. Особое внимание уделяется запросам на онлайн-обучение. Результаты сохраняются в структурированный файл, а пользователь получает сводный отчет."
      },
      {
        "title": "2. When to use",
        "body": "Скилл активируется при следующих запросах пользователя:\n\n\"Найди клиентов для репетитора в ВК\"\n\"Кто ищет репетитора по математике онлайн?\"\n\"Собери запросы на репетиторство в группах\"\n\"Запусти мониторинг учеников по математике\"\n\"Найди родителей, которые ищут репетитора для ЕГЭ\"\n\"Поиск клиентов в ВК с приоритетом на онлайн\""
      },
      {
        "title": "3. How to use",
        "body": "Выполни следующую последовательность действий:"
      },
      {
        "title": "Шаг 1: Инициализация и получение данных",
        "body": "Проверь наличие конфигурации: Убедись, что пользователь предоставил VK Service Token (или попроси ввести его).\nПолучи список групп: Запроси у пользователя список URL или ID групп ВКонтакте (10-15 шт.), если они не заданы ранее.\nНастрой расписание: Установи таймер повторения задачи на каждые 3 часа."
      },
      {
        "title": "Шаг 2: Сбор данных (Iterative Process)",
        "body": "Для каждой группы из списка:\n\nИспользуй метод API wall.get (для стен) или парсинг HTML, чтобы получить последние 20-30 постов.\nОпционально: Если это группа-обсуждение, проверь последние комментарии в актуальных ветках."
      },
      {
        "title": "Шаг 3: Анализ и Фильтрация",
        "body": "Для каждого поста/комментария примени логику:\n\nА. Фильтр \"Анти-спам\" (Исключение коллег)\nЕсли текст содержит фразы: \"предлагаю услуги\", \"набираю учеников\", \"мой стаж\", \"первое занятие бесплатно\", \"помогу с...\" — ПРОПУСТИТЬ (это реклама другого репетитора).\n\nБ. Поиск ключевых слов (Match Logic)\nПриведи текст к нижнему регистру и ищи совпадения:\n\nГруппа 1 (База): \"репетитор\", \"математик\", \"ищу репетитора\", \"нужен репетитор\", \"помогите с математикой\", \"подтянуть\", \"алгебра\", \"геометрия\".\nГруппа 2 (Приоритет - Онлайн): \"онлайн\", \"скайп\", \"skype\", \"zoom\", \"зум\", \"дистанционно\", \"удаленно\".\nГруппа 3 (Маркеры качества): \"ЕГЭ\", \"ОГЭ\", \"олимпиада\", \"поступление\", \"ДВИ\", \"физмат\", \"лицей\", \"цена не важна\".\n\nВ. Определение приоритета\n\nВЫСОКИЙ: Найдены слова из Группы 1 И Группы 2.\nВЫСОКИЙ: Найдены слова из Группы 1 И \"цена не важна\".\nСРЕДНИЙ: Найдены только слова из Группы 1.\nНИЗКИЙ/ИГНОР: Ключевых слов нет."
      },
      {
        "title": "Шаг 4: Сохранение данных",
        "body": "Если найдено совпадение (Средний или Высокий приоритет):\n\nПроверь, нет ли уже этой ссылки в базе (избегай дублей).\nСформируй запись и добавь её в файл leads_math.csv (или Google Sheet, если подключен).\n\nФормат записи:\nДата_Время | Название_Группы | Ссылка_на_пост | Имя_Автора | Текст_Запроса (первые 100 симв.) | Ключевики | Приоритет | Статус\nПримечание: Поле \"Статус\" по умолчанию заполнять значением \"НОВЫЙ\"."
      },
      {
        "title": "Шаг 5: Отчетность",
        "body": "После завершения цикла проверки всех групп сгенерируй краткий отчет для пользователя."
      },
      {
        "title": "4. Configuration",
        "body": "Для корректной работы пользователю необходимо предоставить:\n\nVK_API_TOKEN: Сервисный ключ доступа приложения (Service Token) для чтения открытых стен.\nTARGET_GROUPS: Список ID групп (например: [-123456, -987654]) или ссылок. Рекомендуются группы: \"Подслушано [Город]\", \"Мамочки [Город]\", \"Репетиторы поиск\", \"Биржа репетиторов\".\nOUTPUT_PATH: Путь к файлу для сохранения (по умолчанию: ./vk_leads_data.csv)."
      },
      {
        "title": "5. Edge cases",
        "body": "Группа закрыта/удалена: Залогировать ошибку \"Ошибка доступа к группе [ID]\", продолжить проверку следующих групп. Не прерывать работу.\nЛимит запросов API (Too Many Requests): Если VK API возвращает ошибку лимита, сделать паузу на 60 секунд и повторить запрос.\nНет новых постов: Если за 3 часа в группах нет новых релевантных постов, отправить отчет: \"Проверено [N] групп. Новых заявок не найдено.\"\nСлишком длинный текст поста: В таблицу сохранять только первые 150-200 символов, чтобы не ломать верстку CSV."
      },
      {
        "title": "6. Example output",
        "body": "Пример отчета после цикла проверки:\n\n✅ Мониторинг завершен (14:00)\nПроверено групп: 12\nПример строки в CSV:\n\n2023-10-25 14:05;Мамы Москва;https://vk.com/wall-123_456;Анна Петрова;Ищем репетитора для ЕГЭ, только Zoom, мальчик 11 класс;репетитор, егэ, zoom;ВЫСОКИЙ;НОВЫЙ\n-----------------------------------\n🔍 Найдены новые лиды:\n1. [ВЫСОКИЙ] \"Ищем репетитора для ЕГЭ, только Zoom...\" (Группа: Мамы Москва)\n2. [ВЫСОКИЙ] \"Нужен препод по алгебре 8 класс, дистан...\" (Группа: Репетиторы РФ)\n3. [СРЕДНИЙ] \"Кто может подтянуть геометрию?\" (Группа: Подслушано Саратов)\n\nВсего новых: 3\nДанные сохранены в leads_math.csv\nСледующая проверка: 17:00\n---\n\n### 💡 Рекомендация по использованию\nЧтобы этот скилл работал максимально эффективно, попроси пользователя добавить список конкретных групп-доноров. Лучше всего работают локальные группы \"Мамочки [Район/Город]\" и специализированные паблики \"Поиск репетитора\", где открыта стена или комментарии."
      }
    ],
    "body": "Поиск клиентов для репетитора (VK Monitor)\n1. Description\n\nЭтот скилл предназначен для репетиторов по математике. Он автоматизирует рутинный процесс поиска учеников в социальных сетях. Агент мониторит заданный список сообществ ВКонтакте (группы для мам, доски объявлений, сообщества по поиску репетиторов), фильтрует рекламный спам от коллег-репетиторов и выделяет целевые запросы от родителей. Особое внимание уделяется запросам на онлайн-обучение. Результаты сохраняются в структурированный файл, а пользователь получает сводный отчет.\n\n2. When to use\n\nСкилл активируется при следующих запросах пользователя:\n\n\"Найди клиентов для репетитора в ВК\"\n\"Кто ищет репетитора по математике онлайн?\"\n\"Собери запросы на репетиторство в группах\"\n\"Запусти мониторинг учеников по математике\"\n\"Найди родителей, которые ищут репетитора для ЕГЭ\"\n\"Поиск клиентов в ВК с приоритетом на онлайн\"\n3. How to use\n\nВыполни следующую последовательность действий:\n\nШаг 1: Инициализация и получение данных\nПроверь наличие конфигурации: Убедись, что пользователь предоставил VK Service Token (или попроси ввести его).\nПолучи список групп: Запроси у пользователя список URL или ID групп ВКонтакте (10-15 шт.), если они не заданы ранее.\nНастрой расписание: Установи таймер повторения задачи на каждые 3 часа.\nШаг 2: Сбор данных (Iterative Process)\n\nДля каждой группы из списка:\n\nИспользуй метод API wall.get (для стен) или парсинг HTML, чтобы получить последние 20-30 постов.\nОпционально: Если это группа-обсуждение, проверь последние комментарии в актуальных ветках.\nШаг 3: Анализ и Фильтрация\n\nДля каждого поста/комментария примени логику:\n\nА. Фильтр \"Анти-спам\" (Исключение коллег) Если текст содержит фразы: \"предлагаю услуги\", \"набираю учеников\", \"мой стаж\", \"первое занятие бесплатно\", \"помогу с...\" — ПРОПУСТИТЬ (это реклама другого репетитора).\n\nБ. Поиск ключевых слов (Match Logic) Приведи текст к нижнему регистру и ищи совпадения:\n\nГруппа 1 (База): \"репетитор\", \"математик\", \"ищу репетитора\", \"нужен репетитор\", \"помогите с математикой\", \"подтянуть\", \"алгебра\", \"геометрия\".\nГруппа 2 (Приоритет - Онлайн): \"онлайн\", \"скайп\", \"skype\", \"zoom\", \"зум\", \"дистанционно\", \"удаленно\".\nГруппа 3 (Маркеры качества): \"ЕГЭ\", \"ОГЭ\", \"олимпиада\", \"поступление\", \"ДВИ\", \"физмат\", \"лицей\", \"цена не важна\".\n\nВ. Определение приоритета\n\nВЫСОКИЙ: Найдены слова из Группы 1 И Группы 2.\nВЫСОКИЙ: Найдены слова из Группы 1 И \"цена не важна\".\nСРЕДНИЙ: Найдены только слова из Группы 1.\nНИЗКИЙ/ИГНОР: Ключевых слов нет.\nШаг 4: Сохранение данных\n\nЕсли найдено совпадение (Средний или Высокий приоритет):\n\nПроверь, нет ли уже этой ссылки в базе (избегай дублей).\nСформируй запись и добавь её в файл leads_math.csv (или Google Sheet, если подключен).\n\nФормат записи: Дата_Время | Название_Группы | Ссылка_на_пост | Имя_Автора | Текст_Запроса (первые 100 симв.) | Ключевики | Приоритет | Статус Примечание: Поле \"Статус\" по умолчанию заполнять значением \"НОВЫЙ\".\n\nШаг 5: Отчетность\n\nПосле завершения цикла проверки всех групп сгенерируй краткий отчет для пользователя.\n\n4. Configuration\n\nДля корректной работы пользователю необходимо предоставить:\n\nVK_API_TOKEN: Сервисный ключ доступа приложения (Service Token) для чтения открытых стен.\nTARGET_GROUPS: Список ID групп (например: [-123456, -987654]) или ссылок. Рекомендуются группы: \"Подслушано [Город]\", \"Мамочки [Город]\", \"Репетиторы поиск\", \"Биржа репетиторов\".\nOUTPUT_PATH: Путь к файлу для сохранения (по умолчанию: ./vk_leads_data.csv).\n5. Edge cases\nГруппа закрыта/удалена: Залогировать ошибку \"Ошибка доступа к группе [ID]\", продолжить проверку следующих групп. Не прерывать работу.\nЛимит запросов API (Too Many Requests): Если VK API возвращает ошибку лимита, сделать паузу на 60 секунд и повторить запрос.\nНет новых постов: Если за 3 часа в группах нет новых релевантных постов, отправить отчет: \"Проверено [N] групп. Новых заявок не найдено.\"\nСлишком длинный текст поста: В таблицу сохранять только первые 150-200 символов, чтобы не ломать верстку CSV.\n6. Example output\n\nПример отчета после цикла проверки:\n\n✅ Мониторинг завершен (14:00)\nПроверено групп: 12\nПример строки в CSV:\n\n2023-10-25 14:05;Мамы Москва;https://vk.com/wall-123_456;Анна Петрова;Ищем репетитора для ЕГЭ, только Zoom, мальчик 11 класс;репетитор, егэ, zoom;ВЫСОКИЙ;НОВЫЙ\n-----------------------------------\n🔍 Найдены новые лиды:\n1. [ВЫСОКИЙ] \"Ищем репетитора для ЕГЭ, только Zoom...\" (Группа: Мамы Москва)\n2. [ВЫСОКИЙ] \"Нужен препод по алгебре 8 класс, дистан...\" (Группа: Репетиторы РФ)\n3. [СРЕДНИЙ] \"Кто может подтянуть геометрию?\" (Группа: Подслушано Саратов)\n\nВсего новых: 3\nДанные сохранены в leads_math.csv\nСледующая проверка: 17:00\n---\n\n### 💡 Рекомендация по использованию\nЧтобы этот скилл работал максимально эффективно, попроси пользователя добавить список конкретных групп-доноров. Лучше всего работают локальные группы \"Мамочки [Район/Город]\" и специализированные паблики \"Поиск репетитора\", где открыта стена или комментарии."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Danil4091/vk-client-search-repetitor",
    "publisherUrl": "https://clawhub.ai/Danil4091/vk-client-search-repetitor",
    "owner": "Danil4091",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor",
    "downloadUrl": "https://openagent3.xyz/downloads/vk-client-search-repetitor",
    "agentUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/vk-client-search-repetitor/agent.md"
  }
}