university-news-notifier's Introduction

📚 University news notifier

When any announcement at your university, notifier will notify you via telegram.

Node.js module to interact with official Telegram Bot API. A bot token is needed, to obtain one, talk to and create a new bot.

👍 Usage

Start conversation with your bot

Bot will notify you when any announcement at your university

✨ Contribution Guideline

This guide will show you how to build and contribute to the project.

Clone and install dependencies

git clone https://github.com/cagataycali/university-news-notifier.git
cd university-news-notifier
npm install

Add your parser in sites directory

Example parser json file,

{
    "university": "Pamukkale Üniversitesi",
    "faculity": "Computer Engineering",
    "home":"http://www.pamukkale.edu.tr",
    "url": "http://www.pamukkale.edu.tr/bilgisayar/tr/haberler",
    "scrape": {
        "news": {
            "listItem": "tr",
            "name": "announcement",
            "data": {
                "url": {
                    "selector": "a.tumunuGorLink",
                    "attr": "href"
                },
                "title": "div.tumunuGorBaslik",
                "publishedAt": "div.tumunuGorTarih"
            }
        }
    }
}

Even you can add your rss listener,

{
    "university": "Yildiz Teknik Üniversitesi",
    "faculity": "Computer Engineering",
    "rss": "https://ytuce.maliayas.com/?type=rss"
}

Update university list

Check out here

Test your parser

Check out here

Run end to end test for results

npm run test

☁️ Deploy on your own notifier

⚡ Status

University	Crawling Site	Status
Yildiz Technical	https://ytuce.maliayas.com/	OK
Pamukkale	http://www.pamukkale.edu.tr/bilgisayar	OK
Dokuz Eylül	http://www.eng.deu.edu.tr	OK
Anadolu Universitesi	https://www.anadolu.edu.tr/duyurular	OK
İstanbul Teknik Universitesi	http://www.itu.edu.tr/duyuru	OK