Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shingareom/n2resmsbte
The project monitors a MSBTE result website for exam results using a Bash script. It fetches content from the webpage using `curl`, searches for a designated text ("Select Enrollment No"), and if found, sends a notification to a Telegram chat via a Telegram bot API.
https://github.com/shingareom/n2resmsbte
crontab curl msbte msbtehack om omshingare result shingare
Last synced: 23 days ago
JSON representation
The project monitors a MSBTE result website for exam results using a Bash script. It fetches content from the webpage using `curl`, searches for a designated text ("Select Enrollment No"), and if found, sends a notification to a Telegram chat via a Telegram bot API.
- Host: GitHub
- URL: https://github.com/shingareom/n2resmsbte
- Owner: ShingareOm
- License: mit
- Created: 2024-06-26T10:07:29.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-06-26T15:32:05.000Z (4 months ago)
- Last Synced: 2024-10-14T01:42:06.223Z (23 days ago)
- Topics: crontab, curl, msbte, msbtehack, om, omshingare, result, shingare
- Language: Shell
- Homepage: https://omshingare.me
- Size: 2.82 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/ShingareOm/n2resMSBTE/stargazers)
[](https://github.com/ShingareOm/n2resMSBTE/network)
[](https://github.com/ShingareOm/n2resMSBTE/issues)
[](https://github.com/ShingareOm/n2resMSBTE/blob/main/LICENSE)
## Automating Result Notifications with Cron and Curl By Om Shingare
## Table of Contents
1. [Workflow Diagram](#workflow-diagram)
2. [What is Curl?](#what-is-curl)
3. [What are Cron Jobs?](#what-are-cron-jobs)
4. [Shell Script Code](#shell-script-code)
5. [Setting Up Cron Job in Linux ECS Server](#setting-up-cron-job-in-linux-ecs-server)
6. [For Android: Using Third-Party Tools](#for-android-using-third-party-tools)
---
### Workflow Diagram
### What is Curl?
Curl is a command-line tool used to transfer data to or from a server, using various protocols like HTTP, HTTPS, FTP, etc. Its purpose in this project is to fetch the HTML content from a specific URL (the result page of an institution's website). This fetched HTML is then saved to a file (result.html), where the script checks for specific text ("Select Enrollment No."). If found, it triggers a notification via the Telegram bot API, informing about the availability of exam results. Thus, curl is integral for automating the retrieval of web content, crucial for monitoring updates like result declarations.
### What are Cron Jobs?
Cron is a time-based job scheduler in Unix-like operating systems. Its purpose in this project is to execute a shell script (check_result.sh, for example) at regular intervals (every minute in this case). This shell script uses tools like curl to fetch the HTML content from a specified URL (e.g., the result page of an institution's website). By scheduling this script with cron, the project automates the periodic checking of the website for result updates. If specific conditions are met (e.g., finding "Select Enrollment No." in the fetched HTML), the script can trigger actions like sending notifications via the Telegram bot API. Therefore, cron enables the automation of repetitive tasks, crucial for timely updates and notifications in projects like this result alert system.
### Shell Script Code
```bash
#!/bin/bash
TOKEN="YOUR-AUTH-TOKEN"
CHAT_ID="YOUR-CHAT-ID"
URL="https://msbte.org.in/pcwebBTRes/pcResult01/pcfrmViewMSBTEResult.aspx"
SEARCH_TEXT="Select Enrollment No"
TEMP_FILE="/tmp/website_content.txt"
send_telegram_message() {
local message="$1"
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
-d chat_id="$CHAT_ID" \
-d text="$message" \
-d parse_mode="HTML" > /dev/null
}
curl -s "$URL" > "$TEMP_FILE"
if grep -q "$SEARCH_TEXT" "$TEMP_FILE"; then
DATE="$(date +'%d.%b.%Y -- %H:%M')"
MESSAGE="Bro, your MSBTE Result is out at : $DATE"
send_telegram_message "$MESSAGE"
fi
rm "$TEMP_FILE"
exit 0
```
### Setting Up Cron Job in Linux ECS Server
Ensure your cron job is set to run check_result.sh every minute. Edit your crontab (`crontab -e`) and add the following line:
```bash
* * * * * /bin/bash /path/to/check_result.sh
```
### Explanation of Each Part:
- **Shebang (`#!/bin/bash`)**: Indicates that the script should be executed using the Bash shell.
- **Telegram Bot Credentials**: Replace "YOUR-AUTH-TOKEN" and "YOUR-CHAT-ID" with your actual bot token and chat ID.
- **URL**: The website page from which you want to fetch content.
- **Search Text**: The text pattern that the script will search for within the fetched content.
- **Temporary File**: Path to a temporary file where the script will save the fetched website content.
- **Function `send_telegram_message()`**: Sends messages via the Telegram bot API.
- **Main Script Execution**: Fetches website content, checks for the search text, and sends a notification if the text is found.
- **Cleanup**: Removes the temporary file after processing.
- **Exit Status**: Exits the script with status 0, indicating successful execution.
### Functionality:
- **Purpose**: Automates checking a webpage for specific text indicating exam results.
- **Notification**: Sends a Telegram notification if the text is found.
- **Automation**: Designed to be run periodically to monitor the webpage and alert you when results are published.
- **Customization**: Customize the search text, URL, and message format as needed.
### For Android: Using Third-Party Tools
You can use tools like Uptime Robot to monitor the webpage and send notifications to your Android device. Here's a video demonstrating how to set up the monitor:
[](https://github.com/ShingareOm/n2resMSBTE/assets/109802903/bb524b53-aa9e-452d-982a-6fe2a990ec21)
Website: [Uptime Robot](https://uptimerobot.com), After that you can simply login into the android application for update.
Author: Om Shingare (Om Shingare)