/mbplugin

Mbplugin, самостоятельная программа, которая может работать и как плагин для Mobilebalance. (Умеет получать балансы для большой четверки МТС, Билайн, Мегафон, Теле2 и еще десятка других сервисов). Умеет работать как бот телеграм. Имеет открытый код. Плагины пишутся на python. Для работы со сложными сайтами используется playwright. Работает на Windows, Linux и Mac.

Primary LanguagePythonMIT LicenseMIT

Автоматический контроль баланса сотовых операторов и не только их

Возможности программы MBplugin

Есть три варианта использования данного продукта:

  • Самостоятельное приложение (в инструкции описывается как standalone)
  • как плагин для программы MobileBalance
  • как python модуль в вашем собственном коде

Программа, позволяет автоматизировать получение балансов МТС, Билайн, Мегафон, Теле2, Yota(modem), Ростелеком, ОнЛайм, Zadarma/Novofon, Cardtel, SipNet, Карта стрелка, Автодор транспондер, Московский паркинг, Мосэнергосбыт, курсы валют и акций, список операторов пополняется.
Изначально была написана как надстройка для MobileBalance и такой вариант работы по прежнему возможен.
В инструкции вариант использования без MobileBalance называется standalone.
Интерфейс программы организован в виде веб сервера, есть интеграция с телеграммом - можно отправлять в телеграм результаты запросов и производить запросы балансов.
Для работы с личными кабинетами используется где это возможно API и простые запросы. В сложных случаях (коих как показала практика большинство) используется библиотека playwright-python Все возможности standalone версии доступны и в режиме работы как плагина для MobileBalance (см соответствующий раздел в инструкции в Standalone версии) за исключением того момента что если запрос баланса был инициирован не через интерфейс MobileBalance, то его результаты не попадут в базу MobileBalance

Инструкцию по настройке в режиме самостоятельной программы смотрите в standalone.md

Работает на Windows, Linux и MacOs на архитектуре i386 и arm.
Полное отсутствие ограничений, накладываемых лицензией mobilebalance, можно проверять любое количество телефонов.
Инструкция по варианту использования standalone

Инструкцию по настройке в режиме мега-плагина для программы MobileBalance смотрите в mobilebalance.md

Инструкция по варианту использования mobilebalance

Инструкцию использованию в качестве python модуля в своем коде (beta)

Инструкция по варианту использования как python модуль

Дополнительная информация

История изменения (в ней часть информации не попавшая в документацию)
Описание параметров mbplugin.ini (почти все параметры из секции Options из mbplugin.ini могут быть прописаны индивидуально в секцию к телефону)

На данный момент реализованы плагины

(Источником информации послужили как собственное изучение так и существующие плагины, так что, пользуясь случаем, хочу выразить благодарность всем авторам: leha3d, Pasha, comprech, y-greek и другим, кто тратил свои силы и время на реверс сайтов операторов и разработку)
mts - mts.ru МТС (сотовая связь)
beeline - beeline.ru Билайн (сотовая связь)
beeline_uz - beeline.uz Билайн Узбекистан (сотовая связь)
megafon - megafon.ru Мегафон (сотовая связь)
megafonb2b - b2blk.megafon.ru Мегафон b2b (сотовая связь)
tele2 - tele2.ru (сотовая связь)
yota - yota.ru (сотовая связь)
a1by - a1.by A1(velcom) Беларусь (сотовая связь) (автор Exemok)
lifeby - life.com.by A1(velcom) Беларусь (сотовая связь)
rostelecom - lk.rt.ru Ростелеком (телефония и интернет)
smile-net - smile-net.ru Infoline/smile-net/Virgin connect (Интернет провайдер)
onlime - onlime.ru (Интернет провайдер)
lovit - lovit.ru (Интернет провайдер)
east - east.ru (East Telecom internet provider)
uminet - uminet.ru (Интернет провайдер)
zadarma - Zadarma.com/Novofon.com (IP телефония)
cardtel - cardtel.ru (IP телефония)
sipnet - Sipnet.ru (IP телефония)
mangooffice - www.mango-office.ru (IP телефония) (автор Pasha)
ntvplus - NTV+ быстрая проверка баланса по номеру договора и фамилии (TV)
strelka - strelka.ru Баланс карты стрелка
sodexo - sodexo.com Получение баланса карты Sodexo (подарочные карты)
currency - Курсы валют USD, EUR, с ЦБ и с MOEX, курсы акций с MOEX и yahoo finance (заменил плагины eur, usd, moex и yahoo)
stock - Расчет цены портфеля ценных бумаг
avtodor-tr - avtodor-tr.ru Автодор транспондер
parking_mos - parking.mos.ru оплата парковки (Вход через логин/пароль на login.mos.ru)
mosenergosbyt - mosenergosbyt.ru Сайт мосэнергосбыт (ЖКХ) chailand - chailand.ru Карта парка атракционов vscale - vscale.ru Облачные серверы для разработчиков
beget - beget.ru (хостинг-провайдера BEGET) (автор d1mas)
smsru - sms.ru оператор SMS.RU (sms рассылки) (автор Pasha)
Для плагинов rostelecom и mosenergosbyt можно указывать конкретный лицевой счет если их несколько в формате login/лицевой_счет

Тестовые плагины

test1 - Простой тест с демонстрацией всех полей (на нем хорошо видно что из DLL плагина приходят не все поля)
test2 - Пример реализации ввода капчи через tix/tkinter
test3 - Пример реализации проверки через браузер (playwright)
test4 - Пример ручной реализации проверки через браузер (playwright)

Обратная связь.

Оптимальный способ обратной связи - оставить issue на github (для создания issue нужно зарегистрироваться)
Также обсуждение работы проходит в форуме 4pda посвященном программе MobileBalance
Или в канале телеграмм также для личной связи и передачи непубличных данных есть бот для связи с автором

Помощь проекту

Для желающих написать свой плагин на wiki проекта есть небольшая инструкция по разработке плагина
Если у Вас есть желание помочь проекту, то лучший способ - это сделать код и документацию более понятной и избавить их от ошибок. Сделать можно отправив pull request к проекту. Это не так сложно как кажется на первый взгляд. Только не присылайте сразу полностью переписанный файл, такие изменения очень тяжело обрабатывать, лучше небольшими кусками, и обязательно к ветке dev. И желательно перед тем как Вы решите начать изменения предупредить меня.