How chiragjaju13/ncs-bot-project works
NCS Bot checks two Maharashtra tender sources, classifies matching tenders by region, detects new or changed deadlines, and sends alerts. Its main runtime and domain logic are concentrated in main.py; force_check.py provides a manual entry point, while the documented GitHub Actions workflow schedules runs. The excerpts show key MSEDCL, notification, and orchestration behavior; some MahaTenders and archive details are supported by the README, so those links cite the documentation.
Main entry points: main.py Check-and-send job · force_check.py Manual check · run_bot.yml GitHub Actions schedule · tender_archive.json Tender archive
Components 15
Tender sources
- MSEDCL scraper
main.py - MahaTenders scraper
main.py - MSEDCL tender API
- MahaTenders portal
Tender processing
- District and taluka matching
main.py - Change detection
main.py - Tender archive
tender_archive.json
Alert delivery
- Tender message formatting
main.py - Telegram
Run and state
- GitHub Actions schedule
.github/workflows/run_bot.yml - Manual check
force_check.py - Runtime entry
main.py - Check-and-send job
main.py
Other components
- Operator
Connections 16
- Operator → Manual check: starts
README.md - Manual check → Check-and-send job: calls
force_check.py - GitHub Actions schedule → Runtime entry: runs
README.md - Runtime entry → Check-and-send job: calls
main.py - Check-and-send job → MSEDCL scraper: checks
main.py - Check-and-send job → MahaTenders scraper: checks
README.md - MSEDCL scraper → MSEDCL tender API: requests data
main.py - MahaTenders scraper → MahaTenders portal: searches and fetches
README.md - MSEDCL scraper → District and taluka matching: matches region
main.py - MahaTenders scraper → District and taluka matching: classifies region
README.md - Check-and-send job → Tender archive: loads and updates
README.md - MSEDCL scraper → Change detection: checks date changes
main.py - MahaTenders scraper → Change detection: checks date changes
README.md - Check-and-send job → Tender message formatting: groups alerts
main.py - Check-and-send job → Telegram: sends alerts
main.py - Check-and-send job → WhatsApp: sends alerts
main.py