An open-source bot that automatically checks the ÖSYM website and sends instant Telegram notifications to all registered users when YKS results are announced.
Instead of constantly pressing F5 waiting for YKS results to be announced, just send /start to the bot on Telegram and get notified instantly when the results are out.
┌─────────────────────────────────────────────────────────┐
│ GitHub Actions (every 5 min) │
│ ├── 1. Register new /start users │
│ ├── 2. Check ÖSYM using 3 different strategies │
│ └── 3. If results found → send Telegram to all users │
└─────────────────────────────────────────────────────────┘
| Step | Description |
|---|---|
| 👥 User Registration | Anyone who sends /start to the bot is automatically registered |
| 🏠 ÖSYM Homepage | Scans announcements on osym.gov.tr for result keywords |
| 📊 Results Page | Searches for 2026-YKS result documents on sonuc.osym.gov.tr |
| 📰 Google News | Searches Google News RSS for "YKS results announced" |
| 📬 Bulk Notification | Sends a message to all registered users when results are detected |
| 🔒 Auto Shutdown | Automatically disables the bot after sending notifications |
├── .github/workflows/
│ └── yks-checker.yml # GitHub Actions cron workflow
├── main.py # Main entry point
├── checker.py # ÖSYM check strategies (3 different sources)
├── notifier.py # Telegram notification system (bulk + admin alerts)
├── storage.py # User database (users.json) management
├── config.py # Configuration and environment variables
├── requirements.txt # Python dependencies
└── README.md
How often does the bot check?
Every 5 minutes. GitHub Actions cron may have a 5-15 minute delay during peak hours.
I sent /start but didn't get a message immediately?
Since the bot runs on GitHub Actions every 5 minutes, the "Bot Active" message will reach you within at most 5 minutes. This is a natural limitation of the free infrastructure.
Does it use my personal data?
No. The bot only checks ÖSYM's public pages. It does not access T.C. ID numbers, passwords, or any private information. It only stores your Telegram Chat ID to send you messages.
Will I receive repeated messages after results are announced?
No. Once the bot detects the results and sends the notification, it automatically disables itself. You will receive only a single notification.
This project is fully open-source and free.
If you find it useful, please give it a ⭐ Star on GitHub!
🌐 Developer: metee.com.tr
An open-source project developed to make life easier for students.