Skip to content

hoosnick/freelance-job-notifier

Repository files navigation

Freelance Jobs Telegram Notifier

Freelance Jobs Notifier is a Python script designed to periodically fetch new projects from popular freelance platforms (at the moment: Kwork.ru and Upwork.com) and notify a Telegram group about them. It uses the API, RSS Feed to retrieve project details and sends notifications to a specified Telegram group.

Demo

demo-view

freelance-gpt-github.mp4

🍰 Features

[Feb 23, 2024]

  • WebApp in Any Chat.

[Jan 15, 2024]

  • Now you can generate an offer from the description of each job with the help of AI.
  • User friendly Telegram Web App to view the generated offers in bot chat.
  • PremiumUsers, Unlimited Generates and etc.

[Sep 12, 2023]

  • Fetches new [project/job]s based on specified categories.
  • Sends project notifications to a Telegram group.
  • Uses the Apscheduler library for job scheduling.
  • Stores project IDs in an SQLite database to avoid duplicate notifications.

⚙️ Requirements

  • Python 3.11 or higher
  • Dependencies listed in requirements.txt
  • A Telegram Bot Token (obtain one from @BotFather on Telegram)
  • For Kwork.ru - account credentials (LOGIN, PASSWORD, PHONE_LAST, CATEGORIES). You can find a complete list of project categories in the assets/kwork-categories.json file to further search for projects by their ID. (see .env file)
  • For Upwork.com - log in to your account and create a search query for jobs by following this link and get the credentials from the query parameters in the rss feed url that was generated for you. (see .env file)
  • Configuration via environment variables (see .env file)

💽 Installation

  1. Clone this repository:

    git clone https://github.com/hoosnick/freelance-job-notifier.git
    cd freelance-job-notifier
  2. Install the required dependencies using pip:

    pip install -r requirements.txt
  3. Create a .env file in the project directory and add your environment variables from .sample.env file.

  4. Run the script:

    python -m app

❤️ Thanks a lot


📃 License

  • This project is licensed under the MIT License - see the LICENSE file for details.

Buy Me A Coffee