⚠️ Статус проекта

Эта открытая версия проекта больше не будет получать функциональных обновлений. Она остается доступной как демонстрация возможностей и основа для ваших собственных экспериментов.

Разработка продолжается в рамках Pro-версии, которая является коммерческим продуктом с активной поддержкой. Она включает в себя:

• Значительно расширенный функционал и гибкие настройки.
• Улучшенную стабильность и регулярные обновления для адаптации к изменениям на Kufar.
• Продвинутые возможности, такие как отслеживание истории объявлений пользователя и мониторинг конкретных продавцов.
• И множество других улучшений.

Если вы заинтересованы в приобретении Pro-версии, свяжитесь со мной через SimpleX Chat (актуальная ссылка в профиле GitHub) или Email.
Актуальная ссылка на Codeberg.

---

Telegram-бот для уведомлений с Kufar.by

Продвинутый Telegram-бот для мониторинга новых объявлений на белорусской площадке Kufar.by. Бот позволяет пользователям создавать персонализированные поисковые запросы и получать мгновенные уведомления с фото, ценой и подробной информацией прямо в Telegram.

🚀 Ключевые возможности

• Персональные подписки: Каждый пользователь может создавать и настраивать свои собственные поисковые запросы.
• Интерактивное управление: Удобное управление запросами через inline-кнопки в Telegram. Не нужно писать JSON или сложные команды.
• Информативные уведомления: Уведомления приходят с фотографией товара, ценой, местоположением, датой публикации и описанием.
• Админ-панель: Администраторы могут управлять доступом пользователей к боту.
• Надежная фильтрация: Бот игнорирует объявления, опубликованные до его запуска, и защищен от отправки дубликатов.
• Современный стек: Написан на Python с использованием aiogram3, curl-cffi c продвинутым фингерпринтингом для обхода защиты от ботов и FSM для управления состояниями.

🛠️ Технологический стек

• Python 3.10+
• aiogram3 — асинхронный фреймворк для создания Telegram-ботов.
• curl-cffi — библиотека для выполнения HTTP-запросов, имитирующих отпечаток браузера.
• python-dotenv — библиотека для управления переменными окружения.

⚙️ Установка и запуск

1. Клонирование репозитория

git clone https://github.com/lonesomestranger/kufar-notifier-bot.git
cd kufar-notifier-bot

2. Создание виртуального окружения

Рекомендуется использовать виртуальное окружение для изоляции зависимостей.

# Для Windows
python -m venv .venv
.venv\Scripts\activate

# Для macOS/Linux
python3 -m venv .venv
source .venv/bin/activate

3. Установка зависимостей

pip install -r requirements.txt

4. Конфигурация

Создайте файл .env в корневой папке проекта, скопировав в него содержимое файла .env.example (если он есть) или создав с нуля:

# Получите токен у @BotFather в Telegram
TELEGRAM_BOT_TOKEN="12345:ABC-DEF12345"

# Укажите через запятую числовые ID администраторов бота
# Свой ID можно узнать у @userinfobot
ADMIN_IDS="555111222,444333222"

5. Запуск бота

python main.py

При первом запуске администраторы, указанные в ADMIN_IDS, будут автоматически добавлены в список разрешенных пользователей.

📖 Как пользоваться ботом

Для администратора

Административные команды по-прежнему доступны через слеш для удобства:

1. Используйте команду /adminhelp для просмотра списка админ-команд.
2. Чтобы дать пользователю доступ к боту, используйте команду /adduser <ID_пользователя>.
3. Чтобы забрать доступ, используйте /deluser <ID_пользователя>.

Для обычного пользователя

Взаимодействие с ботом происходит через удобное меню.

1. Запуск и вызов меню:

   • Отправьте команду /start. Появится кнопка "Меню" внизу экрана.
   • Нажмите на эту кнопку, чтобы открыть главное меню в виде сообщения.

2. Добавление запроса:

   • В главном меню нажмите кнопку "➕ Добавить запрос".
   • Бот попросит вас ввести текст для поиска.
   • Отправьте текст нужного запроса (например, iPhone 14 Pro Max) обычным сообщением.
   • Бот подтвердит создание и вернет вас в главное меню.

3. Управление запросами:

   • В главном меню нажмите кнопку "📜 Мои запросы".
   • Вы увидите список ваших запросов в виде кнопок.
   • Нажмите на кнопку с нужным запросом, чтобы открыть меню управления, где можно:
     • Установить минимальную и максимальную цену.
     • Задать лимит на количество объявлений в одном запросе.
     • Включить/выключить поиск только в заголовках.
     • Удалить запрос.

📜 Отказ от ответственности

Данный проект является неофициальным инструментом и не имеет никакого отношения к компании Kufar.by. Он использует внутренние API сайта, которые могут быть изменены или заблокированы в любой момент без предварительного уведомления.

Автор проекта не несет ответственности за:

• Любые возможные блокировки вашего аккаунта на Kufar.by.
• Некорректную работу бота из-за изменений в API Kufar.
• Любые другие проблемы, возникшие в результате использования данного программного обеспечения.

Используйте на свой страх и риск.

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.