https://github.com/artyl/mbplugin
Mbplugin, самостоятельная программа, которая может работать и как плагин для Mobilebalance. (Умеет получать балансы для большой четверки МТС, Билайн, Мегафон, Теле2 и еще десятка других сервисов). Умеет работать как бот телеграм. Имеет открытый код. Плагины пишутся на python. Для работы со сложными сайтами используется playwright. Работает на Windows, Linux и Mac.
https://github.com/artyl/mbplugin
mbplugin mobilebalance playwright python telegram
Last synced: 5 months ago
JSON representation
Mbplugin, самостоятельная программа, которая может работать и как плагин для Mobilebalance. (Умеет получать балансы для большой четверки МТС, Билайн, Мегафон, Теле2 и еще десятка других сервисов). Умеет работать как бот телеграм. Имеет открытый код. Плагины пишутся на python. Для работы со сложными сайтами используется playwright. Работает на Windows, Linux и Mac.
- Host: GitHub
- URL: https://github.com/artyl/mbplugin
- Owner: artyl
- License: mit
- Created: 2020-06-01T17:36:52.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-12-13T16:20:14.000Z (6 months ago)
- Last Synced: 2025-12-15T08:43:00.143Z (6 months ago)
- Topics: mbplugin, mobilebalance, playwright, python, telegram
- Language: Python
- Homepage:
- Size: 1.85 MB
- Stars: 12
- Watchers: 4
- Forks: 6
- Open Issues: 6
-
Metadata Files:
- Readme: readme.md
- Changelog: changelist.md
- License: LICENSE
Awesome Lists containing this project
README
# Автоматический контроль баланса сотовых операторов и не только их
## Возможности программы MBplugin
Есть три варианта использования данного продукта:
* Самостоятельное приложение (в инструкции описывается как **standalone**)
* как плагин для программы MobileBalance
* как python модуль в вашем собственном коде
Программа, позволяет автоматизировать получение балансов МТС, Билайн, Мегафон, Теле2, Yota(modem), Ростелеком, ОнЛайм, Zadarma/Novofon, Cardtel, SipNet, Карта стрелка, Автодор транспондер, Московский паркинг, Мосэнергосбыт, курсы валют и акций, список операторов пополняется.
Изначально была написана как надстройка для MobileBalance и такой вариант работы по прежнему возможен.
В инструкции вариант использования без MobileBalance называется **standalone**.
Интерфейс программы организован в виде веб сервера, есть интеграция с телеграммом - можно отправлять в телеграм результаты запросов и производить запросы балансов.
Для работы с личными кабинетами используется где это возможно API и простые запросы. В сложных случаях (коих как показала практика большинство) используется библиотека [playwright-python](https://github.com/microsoft/playwright-python)
## Важная информация для пользователей MobileBalance:
Все возможности standalone версии доступны и в режиме работы как плагина для MobileBalance (см соответствующий раздел в инструкции в Standalone версии) за исключением того момента что если запрос баланса был инициирован не через интерфейс MobileBalance, то его результаты не попадут в базу MobileBalance
## Инструкцию по настройке в режиме самостоятельной программы смотрите в standalone.md
Работает на Windows, Linux и MacOs на архитектуре i386 и arm.
Полное отсутствие ограничений, накладываемых лицензией mobilebalance, можно проверять любое количество телефонов.
[Инструкция по варианту использования standalone](https://github.com/artyl/mbplugin/blob/master/standalone.md)
## Инструкцию по настройке в режиме мега-плагина для программы MobileBalance смотрите в mobilebalance.md
[Инструкция по варианту использования mobilebalance](https://github.com/artyl/mbplugin/blob/master/mobilebalance.md)
## Инструкцию использованию в качестве python модуля в своем коде (beta)
[Инструкция по варианту использования как python модуль](https://github.com/artyl/mbplugin/blob/master/module.md)
## Дополнительная информация
[FAQ часто задаваемые вопросы](https://github.com/artyl/mbplugin/blob/master/faq.md)
[История изменения (в ней часть информации не попавшая в документацию)](https://github.com/artyl/mbplugin/blob/master/changelist.md)
[Описание параметров mbplugin.ini (почти все параметры из секции Options из mbplugin.ini могут быть прописаны индивидуально в секцию к телефону)](https://github.com/artyl/mbplugin/blob/master/mbplugin_ini.md)
## На данный момент реализованы плагины
(Источником информации послужили как собственное изучение так и существующие плагины, так что, пользуясь случаем, хочу выразить благодарность всем авторам:
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) Беларусь (сотовая связь)
ucelluz - my.ucell.uz ucell Узбекистан (сотовая связь)
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 - strelkacard.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)
discovery - Запись действий для анализа что происходит в процессе обхода ЛК
### Обратная связь.
Оптимальный способ обратной связи - [оставить issue на github](https://github.com/artyl/mbplugin/issues) (для создания issue нужно зарегистрироваться)
Также обсуждение работы проходит в [форуме 4pda посвященном программе MobileBalance](https://4pda.to/forum/index.php?showtopic=985296)
Или [в канале телеграмм](https://t.me/mbplugin) также для личной связи и передачи непубличных данных есть [бот для связи с автором](https://t.me/artyl_mbplugin_bot)
### Помощь проекту
Для желающих написать свой плагин на wiki проекта есть [небольшая инструкция по разработке плагина](https://github.com/artyl/mbplugin/wiki/Для-авторов-новых-плагинов)
Если у Вас есть желание помочь проекту, то лучший способ - это сделать код и документацию более понятной и избавить их от ошибок. Сделать можно отправив pull request к проекту. Это не так сложно как кажется на первый взгляд. Только не присылайте сразу полностью переписанный файл, такие изменения очень тяжело обрабатывать, лучше небольшими кусками, и обязательно к ветке dev.
И желательно перед тем как Вы решите начать изменения предупредить меня.