Tutorial
https://t.me/starlabs_shop_bot
⚙️ Установка
Требования:
Телеграм аккаунт
ПК
Скачивание:
Перейти в телеграмм бота https://t.me/starlabs_shop_bot
Выбрать количество лицензий и выполнить оплату
Бот выдаст вам API ключ и архив с минтером
В архиве будут две версии: для Windows (main.exe) и для Linux (main)
Софт проверен на Windows 11 и Ubuntu 24.04
Распакуйте архив и выберите версию минтера соответствующую вашей системе
📁 Подготовка (папка data)
В данной папке находятся необходимые для заполнений файлы.
buy_accounts.txt - текстовый файл который содержит в себе данные телеграмм аккаунтов, которые будут использованы ДЛЯ ПОКУПКИ. Аккаунтами из этого тхт файла бот будет покупать подарки. Пример формата аккаунтов ниже. monitor_accounts.txt - текстовый файл который содержит в себе данные телеграмм аккаунтов, которые будут использованы ДЛЯ ПОИСКА НОВЫХ ПОДАРКОВ. Аккаунтами из этого тхт файла бот НЕ будет покупать подарки, только смотреть. Пример формата аккаунтов ниже. Пример данных: 1585892733:no_pass:512123124:deiauncq938h1298dhdcdc:no_proxy
Аккаунты вставляйте построчно - 1 строка = 1 аккаунт. 1585892733 - номер телефона вашего телеграмм аккаунта, без +. no_pass: 2FA пароль на аккаунте, если он у вас есть. Если пароля нет всегда пишите no_pass. 512123124 - APP ID телеграмм аккаунта. Где его взять читайте в ▶️ Использование. deiauncq938h1298dhdcdc - API HASH телеграмм аккаунта. Где его взять читайте в ▶️ Использование. no_proxy: просто пишите везде no_proxy, прокси не поддерживаются. /sessions - папка в которой содержатся телеграмм сессии всех ваших аккаунтов
ВАЖНО! Хоть в конфиге можно выставить максимальное количество подарков которые купит бот, мы всё же рекомендуем хранить на аккаунте не больше той суммы, которую вы готовы потратить. Связано это с тем что в момент выхода подарков бот пытается максимально быстро купить подарки и от сервера не всегда приходит правильный ответ.
logs - папка в которой лежит текстовый файл со всеми логами бота.
📝 Config
Бот имеет два файла для конфига, здесь будет описан каждый из них.
config.yaml
В этой секции будет написано детально про каждую функцию в файле config.yaml.
config.yaml используется для настройки рабочего процесса бота.
hide_sender_name: true - скрывать имя пользователя который подарил подарок или нет. true - когда на ваш аккаунт придет подарок, отправитель будет анонимным и не будет видно от кого пришел подарок. false - будет видно от кого пришел подарок.
user_ids: ["username1", "username2"] - юзернеймы получателей подарков. Именно ЮЗЕРНЕЙМЫ, без знака @. Бот на каждый подарок будет выбирать 1 рандомный юзернейм из списка и дарить ему подарок. Вы можете вставить несколько юзернеймов. Так же, вы можете вставлять юзернеймы как юзера, так и телеграмм канала. ТЕЛЕГРАММ КАНАЛ ДОЛЖЕН БЫТЬ ОТКРЫТЫЙ.
notification_bot_token: "asfh0127yhdca76g21" - токен вашего телеграмм бота для уведомлений. По желанию, можете вставить сюда токен бота созданного вами в https://t.me/BotFather и он будет отправлять в чат уведомления о процессе работы.
channel_id: -12656128722 - ID телеграмм канала в который бот будет отправлять уведомления. Не забудьте пригласить бота в ваш канал и дать ему права писать посты. Получить ID вашего канала можно через бота https://t.me/GetChatID_IL_BOT.
timezone - оставьте как есть.
filter.yaml
В этой секции будет написано детально про файл filter.yaml в котором хранятся все ваши фильтры для покупки новых подарков.
Важно! Все фильтры в этом файле должны соблюдать четкое форматирование, а именно количество пробелов и тд. Придерживайтесь формата который показан в примере, либо используйте ChatGPT чтобы выровнять отступы в случае ошибки.
Пример конфига:
gift_groups:
- name: "low_price"
min_price: 1
max_price: 1000
num_gifts: 5
purchase_non_limited: false
total_amount_max: 10001
- name: "medium_price"
min_price: 1001
max_price: 2000
num_gifts: 3
purchase_non_limited: false
total_amount_max: 3001
Для каждого фильтры необходимо будет создать записать которая начинается с - и дальше заполняется необходимая информация.
В примере указанном выше, вы можете видеть два фильтра, каждый из который начинается с - и имеет отступ в конце.
Первый фильтр называется "low_price". Он ожидает, что выйдет новый подарок, у которого будет цена от 1 до 1000 звезд. По этому фильтру, бот купит максимум 5 таких подарков. Поскольку стоит false в поле покупать не лимитированные подарки, то бот НЕ будет покупать подарки у которых бесконечный саплай. И максимальный саплай/количество подарков не должно превышать 10001 штук. Если у вышедшего подарка цена будет выше 1000 звезд или саплай будет больше чем 10001 подарок, то бот его пропустит и не будет покупать.
Во втором фильтре "medium_price" аналогично, только минимальная цена ожидаемого подарка ожидается от 1001 звезд до 2000 звезд. Будет куплено 3 таких подарка в случае если все фильтры подойдут. И максимальное количество подарков не должно быть больше 3001 штук.
Теперь про каждое поле детальнее.
name - название вашего фильтра, можно использовать буквы и нижнее подчеркивание.
min_price - минимальная цена ожидаемого подарка в звездах. Только целое число, не меньше нуля.
max_price - максимальная цена ожидаемого подарка в звездах. Только целое число, не меньше нуля.
num_gifts - количество данных подарков, которые купит бот в случае если все фильтры подходят. Стоит 10, значит бот купит 10 таких подарков.
purchase_non_limited: false - покупать ли подарки у которых бесконечных саплай. Есть подарки у которых бесконечная коллекция, самые дешевые к примеру. Если не хотите чтобы бот их купил (а вы скорее всего не хотите) то ставьте здесь всегда false. Либо поставьте true если хотите к примеру затестировать как работает бот. Можете выставить true и цену подарков повыше и купить 1 подарок для теста, всё ли настроено у вас правильно.
total_amount_max: 1000 - сколько максимум подарков будет в коллекции (саплай/supply). Только целое число. К примеру, вы ожидаете что выйдет коллекции как Pepe, у которой всего 3000 штук саплай. Тогда это значение ставите 3000.
▶️ Использование
Внимательно изучите этот раздел (а лучше всю инструкцию) чтобы избежать потери времени или средств. Все особо важные заметки на этой странице отмечены словом "важно". Можете использовать поиск по странице чтобы не пропустить их.
Первым этапом будет приобретение и установка бота. Данный процесс описан в разделе ⚙️ Установка.
После распаковки бота запустите файл main.exe и введите API ключ который вы получили в телеграмм боте после покупки. Каждый API ключ по умолчанию имеет в себе 1 сессию. 1 сессия означает что одновременно по вашему API ключу может быть запущен только один бот. Вы можете закрыть бота на одном ПК и запустить на другом, но одновременно работать они не могут, для этого понадобится 2 или больше сессий в API ключе, которые вы можете докупить там же в телеграмм боте.
Подготовка телеграмм аккаунтов.
Для работы бота вам понадобятся телеграмм аккаунты. Вначале вам необходимо получить APP ID и HASH ID каждого вашего аккаунта. Следуйте этому видео чтобы получить данные: https://www.youtube.com/watch?v=8naENmP3rg4. Если у вас несколько аккаунтов, может быть ситуация что в антидетект браузере не логинится на сайт my telegram. В таком случае вы можете раздать мобильный интернет на ПК + использовать режим инкогнито в браузере, и после каждого аккаунта включать/выключать режим полета на телефоне.
На этом этапе у вас должны быть все необходимые данные чтобы заполнить buy_accounts.txt и monitor_accounts.txt. Заполните этот файл согласно тому формату данных как это расписано в разделе ⚙️ Установка.
Заполнелние файла config.yaml.
Все поля конфига можете настроить под себя, детально всё описано в разделе config.yaml. Имейте ввиду, что после редактирования конфига нужно перезапустить бота, чтобы он запустился с новыми настройками.
Создание телеграмм сессий.
Вам необходимо вставить данные своих телеграмм аккаунтов в файлы buy_accounts.txt и monitor_accounts.txt в папке data. Детальнее как заполнять данные в разделе 📁 Подготовка (папка data) Вы можете вставить один и тот же аккаунт как для покупки, так и для продажи. Либо разделить их, например чтобы ваш аккаунт с балансом использовался только в момент покупки, а другие аккаунты использовались для поиска подарков. После того как вы заполнили txt файлы, запустить бота файлом main.exe. Бот будет спрашивать вас номер телефона для каждого аккаунта (только при создании сессии в первый раз) и затем отправлять на него пароль для авторизации. Номер телефона будет отображен в консоли. Вам нужно будет ввести код из 5 цифр который придет на аккаунт и нажать Enter. И так для каждого аккаунта. Когда бот создает сессии для каждого аккаунта, вы сможете найти их в папке data/sessions. Прочитать про папки можете в разделе 📁 Подготовка (папка data).
Настройка и фильтр стикеров для покупки.
На этом этапе откройте файл filter.yaml и настройте фильтры для покупки подарков как вам того хочется. Весь процесс подробно описан в разделе filter.yaml.
Проверка сессий перед запуском.
Теперь вы можете запустить бота. Бот покажет вам список всех ваших сессий, отдельно те что для покупки и для чека. Проверьте правильно ли заполнены все файлы, если нет, то переместите или удалите и пересоздайте сессии как вам нужно.
Запуск бота.
После того как вы выполнили все настройки, можете запустить файл main.exe.
Для запуска на Linux есть файл main (без .exe).
Чтобы запустить его переместите этот файл на ваш сервер, откройте консоль в папке с ботом и выполните команды:
chmod +x main
./main
Бот выведет на экран все ваши данные аккаунтов и фильтров.
Количество аккаунтов для покупки и проверки (убедитесь что число аккаунтов больше чем 0).
Дальше вы будете видеть как бот выводит на экран ваши фильтры и получает список подарков
С этого момента вам остается просто ждать. В момент выхода новых подарков бот начнет незамедлительно их покупать. Если вы хотите закрыть бота, то используйте клавиши CTRL + C. Если закрыть консоль полностью, необходимо будет ждать 2 минуты для обновления сессии. Для повышения шансов на успех, можете установить бота на удаленный сервер с хорошим интернет соединением.
Перех выходом и в момент выхода новых подарков (и даже после) в логах бота может быть много ошибок — это вполне нормально. Телеграмм может работать нестабильно при дропе коллекции, поэтому не закрывайте бота и оставьте его открытым до тех пор, пока не увидите что все подарки распроданы.
Когда сейл окончательно закончился, закройте бота и проверьте аккаунты вручную.
Вы можете протестировать всё ли правильно работает и настроено, выставив фильтры чтобы купить бесконечные подарки. К примеру, поставит цену подарка от 1 до 200 звезд, 1 подарок к покупке и non_limited_purchase: true, и бот должен купить 1 подарок. Проверьте купил ли он его и получили ли вы его.
Известные ошибки и их фикс
Если при запуске бота видите ошибку HTTP ошибка: 403 которая повторяется раз за разом, то перезапустите бота еще раз. Так же имейте ввиду, что удаленный сервер лучше устанавливать в европейском регионе.
Ошибка: Maximum number of sessions reached. Если вы уверены что запускаете не больше сессий, чем доступно по вашему API ключу, то подождите 2-3 минуты пока перезапустится ваша сессия, это нормально. Если ошибка не проходит больше 5 минут, то обратитесь к нам в поддержку.
Last updated