Skip to content

README_ru.md

Latest commit

 

History

History
102 lines (73 loc) · 8.97 KB

README_ru.md

File metadata and controls

102 lines (73 loc) · 8.97 KB

Static Badge

Static Badge

Рекомендация перед использованием

🔥🔥 Используйте PYTHON версии 3.10 🔥🔥

🇪🇳 README in english available here

Sticker Parser + Buyer

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

Как работает софт

  1. Ожидание выхода новых подарков: Софт постоянно отслеживает новые подарки.
  2. Уведомление: Как только новый подарок обнаружен, уведомление отправляется в личный чат, канал или группу.
  3. Автоматическая покупка: Софт приступает к покупке необходимого количества нового подарка.

Подробный рабочий процесс:

  1. Мониторинг: Софт сравнивает список всех доступных подарков с теми, что находятся в файле .json, каждые 8-15 секунд. Если найден новый подарок (т.е. его нет в файле .json), он переходит к следующему шагу.
  2. Детали уведомления: Отправляется анимация подарка и сообщение с информацией о коллекции. Получателя этих сообщений можно настроить, указав NOTIFICATIONS_ID в файле data/config.py.
  3. Логика покупки: Софт проверяет, находится ли саплай подарка в допустимом диапазоне SUPPLY_LIMIT и находится ли его цена в диапазоне PRICE_LIMIT. Если оба условия соблюдены, бот покупает GIFT_COUNT_TO_BUY подарков для идентификатора чата, указанного в ID_TO_BUY.

Возможности

  • Автоматический парсинг подарков: Отслеживание новых подарков, доступных для покупки в Telegram.
  • Гибкие настройки покупки: Установка лимитов по цене, количеству и другим параметрам для автоматического приобретения подарков.
  • Уведомления: Получение уведомлений о новых подарках или статусе покупки.

Установка и настройка

📋 Требования

  • Python 3.9+

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

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

    git clone https://github.com/kakashkus/StickerParser_Buyer.git
cd StickerParser_Buyer

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

    python -m venv venv
source venv/bin/activate  # Linux/Mac
# или
venv\Scripts\activate  # Windows

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

    pip install -r requirements.txt

  4. Настройка data/config.py

    • Откройте data/config.py и заполните свои API_ID, API_HASH, BOT_TOKEN_WRITER, NOTIFICATIONS_ID, ADMIN_ID и другие настройки автоматической покупки (BUY_GIFT, PRICE_LIMIT, SUPPLY_LIMIT, GIFT_COUNT_TO_BUY, ID_TO_BUY).
    • API_ID, API_HASH: Получите их на my.telegram.org/auth.
    • BOT_TOKEN_WRITER: Получите его у @BotFather.
    • Для ADMIN_ID и NOTIFICATIONS_ID вы можете использовать @userinfobot для получения ID вашего чата.

  5. Важное примечание для сессии пользовательского бота

    • Telegram-бот обрабатывает уведомления, в то время как пользовательский бот (ваш аккаунт Telegram) выполняет фактические покупки подарков.
    • При первом запуске main.py будет создана пользовательская сессия. Вам будет предложено ввести свой номер телефона и код подтверждения.

Запуск софта

🏃‍♂️ Основное приложение

python main.py

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

Ключевые параметры конфигурации расположены в файле data/config.py:

  1. API_ID, API_HASH: Это необходимо для доступа к Telegram API. Вы можете получить их на my.telegram.org/auth.
  2. DELAYS: Настройка задержек между операциями.
  3. COUNT_BUY: Количество стикер паков для покупки.
  4. PRICE_LIMIT: Допустимый промежуток по цене стикер пака (цена в звездах).
  5. SUPPLY_LIMIT: Допустимый промежуток по саплаю стикер пака.
  6. PROXY: Настройка типа прокси (рекомендуется использовать socks5 для Telegram, независимо от реального типа прокси).
  7. BOT_TOKEN_WRITER: Токен Telegram-бота, используемый для отправки уведомлений о новых подарках и логов покупки. Получите его у @BotFather.
  8. NOTIFICATIONS_ID: ID чата (группа/канал/ID вашего аккаунта для личных сообщений), куда бот будет отправлять уведомления о новых подарках.
  9. SEND_NOTIFICATIONS: Установите True или False, чтобы включить или отключить уведомления.
  10. ADMIN_ID: ID вашего основного аккаунта, на который бот будет присылать логи покупки подарков.
  11. BUY_GIFT: Установите True или False, чтобы включить или отключить автоматическую покупку подарков.
  12. GIFT_COUNT_TO_BUY: Количество подарков, которое бот должен купить из новой коллекции.
  13. ID_TO_BUY: ID чата, на который должен быть куплен подарок.

Интересные особенности

  • Вы можете отключить покупку подарков (BUY_GIFT = False) и установить NOTIFICATIONS_ID на ID канала. Это превратит ваш канал в простой парсер подарков, похожий на @auto_gifts.
  • Софт может покупать подарки напрямую для канала, вашего собственного аккаунта или другого аккаунта.
  • Если автоматическая покупка отключена, нет необходимости входить в аккаунт Telegram (сессия пользовательского бота).

Важные примечания

Telegram-бот ищет и отправляет уведомления о новых подарках, в то время как пользовательский бот (аккаунт Telegram) обрабатывает фактическую покупку подарков. Поэтому необходимо создать пользовательскую сессию. Во время первого тестового запуска будет отображена информация о подарке (если подарок не новый, покупка не произойдет).