mts-balance-checker 0.1.1

CLI utility for checking MTS balance, traffic, and SMS from the command line.

MTS-Balance-Checker

Утилита командной строки для проверки баланса, остатков трафика и SMS оператора МТС (Россия). Использует API личного кабинета МТС.

⚠️ Дисклеймер

Эта утилита явялется следствием вайбкодинга, создано Gemini 2.5 Flash при 0 внесении правок в код. Автор не несёт какой-либо отсветсвенности ни за его работоспособность, ни за его безопасность

Код был минимально проверен на его корректную работоспособоность, из-за чего было решено его запакетировать и публиковать. Можно только сказать что этот Readme отредактирован вручную. 🐈

Установка

Вы можете установить пакет с помощью pip:

https://pypi.org/project/mts-balance-checker/0.1.0/

Использование

Для работы утилите требуются ваш номер телефона и строка аутентификационных cookie из браузера. (Например, это можно сделать этим расширением просто скопировав куки сайта lk.mts.ru)

ПРИМЕР 1: Человекочитаемый вывод

mts-check --cookies "JSESSIONID=...; lk_mts_sid=..." --phone [phone] --netscape --human --hide-phone

===============================
 ДАННЫЕ ПО СЧЕТУ МТС (СКРЫТО)
===============================
Баланс (руб.)    : 171.51 руб.
Обновление пакета: 26.10.2025
Интернет         : 26.05 ГБ (из 30.0 ГБ)
Минуты           : 405 мин (из 600 мин)
SMS              : 600 шт (из 600 шт)
===============================

ПРИМЕР 2: Машиночитаемый вывод (JSON)

mts-check --phone 79XXXXXXXXX --cookies-file ~/mts_cookies.txt --output json

{
  "balance_rub": 171.51,
  "deadline_date": "26.10.2025",
  "remaining_internet_mb": 26674.05,
  "total_internet_gb": 30.0,
  "remaining_minutes_min": 405,
  "total_minutes_min": 600,
  "remaining_sms_count": 600,
  "total_sms_count": 600
}

Основные аргументы

Флаг	Описание
--phone	Ваш номер телефона в формате 79XXXXXXXXX.
--cookies	Полная строка cookie (альтернатива: --cookies-file).
--cookies-file	Путь к файлу с cookie.
--human	Человекочитаемый вывод (таблица).
--output parse	Машиночитаемый вывод key=value (по умолчанию).
--output json	Машиночитаемый вывод в формате JSON.
--lang {ru, en}	Язык вывода.
--verbose	Вывод логов процесса получения данных в stderr.
--hide-phone	Спрятать номер телефона в выводе.

Лицензия

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