Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sarojbelbase/nepstonks

An automated bot that scrapes the latest upcoming issues, news, and investment opportunities that are announced inside Nepal and sends them to a telegram channel.
https://github.com/sarojbelbase/nepstonks

bot debenture fpo git-scraping hacktoberfest investment-opportunities ipo made-in-nepal meroshare mutual-funds nepal nepali-app nepse news right-share share-market sharesansar stock-market telegram-bot telegram-channel

Last synced: about 1 month ago
JSON representation

An automated bot that scrapes the latest upcoming issues, news, and investment opportunities that are announced inside Nepal and sends them to a telegram channel.

Awesome Lists containing this project

README 

        







A telegram channel that provides information on the latest share market news, upcoming stocks, issues, and investment opportunities announced inside Nepal.





Total Subscribers Count








### Screenshots













### Overview



A channel that publishes the latest news & upcoming stocks related to `IPOs`, `FPOs`, `Mutual Funds`, `Right Shares` & `Debentures` and reminds us to apply them. It is backed by a `telegram-bot` that does all the heavy lifting i.e. from scraping share-related news from the reputed websites to updating with the latest upcoming issues. The upcoming stocks are fetched from an API and published to this telegram channel, whereas articles are scraped from multiple sources. The most important works are carried out by github actions which run these workflows every day at an appointed time frame to check if there are any new issues or articles available, where I don't need to worry about deploying and cron jobs. As an automation-loving guy, I just saved myself many clicks of `sharesansar`, `bizmandu`, `merolagani`, or any other similar portals we get these updates from.



### Features



- Informs about upcoming issues

- Announces when shares are allotted to the general public

- Share market and stock-related news from reputed sites

- Reminds to apply for stocks beforehand



### Prerequisites



- Python 3 or higher

- Github Account

- Telegram Account

- SQLite Database



### Used Tools & Technologies



- Requests: HTTP Requests

- BeautifulSoup: Web Scraping

- Pillow: Python Imaging Library

- SQLite: A database for storing stocks

- SQLAlchemy: SQL toolkit and object-relational mapper for Python

- Github Actions: CI/CD that makes it easy to automate all your software workflows



### Changelogs



- `2023, May 21` Updated the API URL and models for fetching upcoming stocks

- `2022, October 16` Added General Public Share Allotment Announcements

- `2021, June 08` Remove share market news

- `2021, May 06` Support For Local IPOs

- `2021, May 02` Send stocks in Images

- `2021, April 28` Remove merolagani updates

- `2021, April 26` Add Reminder Notification for stocks

- `2021, April 21` Add the latest share market news



### Environment Variables



- `ALLOTMENT_URL`: URL for the allotment result

- `CHANNEL` = 'The telegram channel you want to send updates e.g @nepstonks'

- `BOT_TOKEN` = 'Bot Token generated from @botfather on telegram'

- `BOT_USERNAME` = 'Bot username generated from @botfather on telegram'

- `API_URL` = 'URL from where stocks are fetched (POST REQUEST)'



### Run & Setups



- [Install & activate virtual environment in the project root folder](https://uoa-eresearch.github.io/eresearch-cookbook/recipe/2014/11/26/python-virtual-env/)

- Add `.env` file in this folder & add all the environment variables with values given here

- Run `python -m pip install -r requirements.txt`

- Run `python run.py`



### Links



telegram channel > t.me/nepstonks



Inspired from auto-investment.

Feel free to fork or give a star to support my doing.



### Made with ❤️ in Nepal.