Masmovil Balance Scraper with MQTT Integration

This repository contains a Python script designed to automate the retrieval of the Masmovil balance using Playwright, with the additional capability to publish the balance to an MQTT broker. Masmovil is a Cellphone provider in Panama, and this script facilitates the seamless acquisition of the balance, followed by its transmission to a specified MQTT topic. The script is configured to use an .env file for securely storing credentials and configuration settings.

Features:

• Automated Login: The script securely logs into the Masmovil website using credentials stored in an .env file, ensuring that sensitive information remains protected.
• Balance Retrieval: It efficiently scrapes and retrieves the current Masmovil balance.
• MQTT Publishing: Once retrieved, the balance is published to an MQTT broker, with the topic and broker details also sourced from the .env file.
• Error Handling: Robust error handling is implemented to manage issues related to login failures, balance retrieval errors, and MQTT publishing failures.
• Cross-Platform Compatibility: The script is designed to operate across various platforms, including Windows, macOS, and Linux.

Requirements:

• Python 3.7+
• Playwright for Python
• Paho-MQTT (for MQTT communication)
• Python-dotenv (for loading environment variables)

Installation:

1. Clone the repository:

   git clone https://github.com/alejandro5x/masmovil-balance-scraper.git
   cd masmovil-balance-scraper

2. Install the required packages:

   pip install -r requirements.txt
   playwright install
   playwright install-deps

3. Create an .env file in the root directory of the project with the following structure:

   MASMOVIL_NUMBER=yourMasmovilNumber
   MASMOVIL_MQTT_TOPIC=yourMQTTTopic
   MASMOVIL_MQTT_ERROR_TOPIC=yourMQTTErrorTopic
   MQTT_BROKER=yourMQTTBrokerAddress
   MQTT_PORT=yourMQTTPort
   MQTT_USER=yourMQTTUser
   MQTT_PASSWORD=yourMQTTPassword
   

Usage:

python masmovil-balance-scraper.py

Example Output:

Upon execution, the script will retrieve the Masmovil balance and publish it to the specified MQTT broker and topic, as defined in the .env file:

Published balance of $30.40 to MQTT topic 'masmovil/balance'.

Crontab:

At minute 0 past every hour

0 * * * * /bin/bash -l -c 'source /home/alex/python/masmovil-balance-scraper/bin/activate && python /home/alex/python/masmovil-balance-scraper/masmovil-balance-scraper.py' > /dev/null 2>&1