LLM-классификатор Telegram-сообщений из фриланс/нишевых чатов на категории лидов. Возвращает {category, score 0-10, reason}. Используется в wixter-leads-bot (159 каналов) и аналогичных парсерах. Категории: video, design, dev, smm, text, ai_jobs, travel + новые по мере подключения вертикалей.
Пока нет рефлексий. Запиши через ~/.claude/bin/append-reflection.py после следующего вызова.
## 🔴 ЖЕЛЕЗНОЕ ПРАВИЛО: Read ЗАПРЕЩЁН для PDF, изображений и офисных документов
Инструмент Read НЕ извлекает текст из этих форматов — он возвращает только размер файла,
а агент решает, что прочитал, и выдумывает содержимое. Проверено измерением 2026-08-25.
- PDF: `pdftotext "файл.pdf" - | head -300`
- PDF-скан (pdftotext дал пусто): `pdftoppm -r 150 -png "файл.pdf" /tmp/p`, затем `tesseract /tmp/p-1.png stdout -l rus+eng`
- PNG/JPG/скриншот: `tesseract "файл.png" stdout -l rus+eng`
- DOCX/ODT: `pandoc "файл.docx" -t plain | head -300`
- XLSX: `libreoffice --headless --convert-to csv --outdir /tmp "файл.xlsx"`, затем `cat /tmp/*.csv`
- Read допустим ТОЛЬКО для txt, md, кода, DXF, json, yaml
Конвертер вернул пусто или ошибку — ОСТАНОВИСЬ и скажи честно «файл технически не прочитал».
НЕ выдумывай ни одной цифры, реквизита, адреса или позиции сметы. Полные правила: ~/.claude/RULES.md §0.
## КРИТИЧЕСКОЕ ПРАВИЛО: Реквизиты и документы
При работе с юридическими данными (реквизиты, адреса, ИНН, ОГРН, договоры):
1. **НИКОГДА не генерируй реквизиты самостоятельно**
2. **ВСЕГДА читай существующие файлы проекта**:
- `state_dir/company_info.md` или `.json`
- `state_dir/contracts/` (предыдущие договоры)
- `state_dir/documents/requisites.md`
- Спроси Макса где лежат актуальные данные
3. **Если файла нет — ОСТАНОВИ работу и спроси Макса**, не выдумывай:
> "Нужны реквизиты компании. Где найти актуальные данные?"
4. **Проверь ВСЕ реквизиты перед отправкой**:
- ИНН: ровно 10 или 12 цифр
- ОГРН: ровно 13 или 15 цифр
- Адрес: полный, с индексом
- Название: точное совпадение с учредительными документами
Галлюцинация реквизитов = юридические проблемы для Макса.
## INVARIANTS — never override
1. Categories — **строго из реестра**. Не выдумывать новые. Текущий: `video, design, dev, smm, text, ai_jobs, travel, noise`.
2. Score 0-10. Threshold для отправки в канал заявок: **≥7**.
3. Reason — одна короткая фраза (≤80 chars), не «лонгрид».
4. Если сообщение от **исполнителя** (предлагает услуги) — категория `noise`, score 0.
5. Если сообщение от **заказчика** (ищет исполнителя) — реальная категория, score высокий.
6. Output **строго JSON**, без markdown-обёртки, без комментариев.
7. Использовать только free chain через litellm-router (RULES.md §9). Прямой OpenAI/Anthropic API запрещён.
## Назначение
Анализ Telegram-сообщений из мониторируемых чатов на предмет «это лид или мусор». Используется в системе автоматического сбора лидов для:
- Никиты (видеомонтаж) — Wixter Leads Bot
- Туризм (СНГ travel-операторы) — планируется
- Контент/разработка/IT — уже работает
## Анти-спам сигналы (обязательно учитывать)
- Туроператоры спамят рекламой → детект по «предлагаем туры», «забронируйте у нас», «наша компания», «акция»
- Сетевики/MLM → детект по «доход от X тыс», «партнёр», «команда мечты», «работа для своих»
- Курсы/инфобизнес → детект по «обучение», «вебинар», «бесплатный курс», «менторская программа»
Все эти → `noise`, score 0.
## Промпт (шаблон)
```
Ты классификатор Telegram-сообщений из фриланс/нишевых чатов. Задача: найти ВАКАНСИИ ОТ ЗАКАЗЧИКОВ.
Категории:
- video — монтаж, обработка видео, цветокор, motion design, видеопродакшен
- design — графический дизайн, иллюстрация, UX/UI, презентации, логотипы
- dev — разработка ПО, frontend, backend, mobile, DevOps
- smm — ведение соцсетей, контент-маркетинг, продвижение
- text — копирайтинг, рерайт, переводы, тексты для сайтов
- ai_jobs — ML/AI разработка, prompt engineering, AI продукт-менеджмент
- travel — организация туров, гид по СНГ, тур-операторы для физлиц
- noise — реклама, MLM, исполнитель ищет работу, курсы, инфо-бизнес
Текст: «{message_text}»
Ответь JSON: {"category": "...", "score": 0-10, "reason": "кратко 1 фраза"}
```
## Когда вызывать
- Каждое сообщение из мониторируемых SOURCE_CHANNELS в wixter-leads-bot
- При запросе ручной проверки «это лид или нет»
- При расширении системы на новые вертикали (нужно сначала добавить категорию в реестр)
## Когда НЕ вызывать
- Сообщения от наших же аккаунтов (исключать на этапе regex до LLM)
- Сообщения с ссылками на другие боты (часто рекламы) — отсекать раньше
- Слишком короткие сообщения (<30 chars) → автоматом `noise`