A command-line tool for scraping student data from the Athens University of Economics and Business (AUEB) eClass system.
- Login securely with your credentials
- Fetch and save student data to a file
- Search by student ID or name with O(1) performance
- Support for multiple course databases
- CLI-friendly with argument parsing
- requests
- beautifulsoup4
- Clone the repository:
git clone https://github.com/Thanos-png/ecs.git
cd ecs- Install the scraper tool:
pip install .Your credentials are securely requested on runtime via terminal prompts. No hardcoded values are stored.
ecs --scrape
This will log into the system, fetch user data, and save it to data/user-ids-{course code}.txt and data/students_{course code}.json.
ecs --search 1234567
You can use either this 1234567 or this p1234567 format.
ecs --name "Παναγιωτίδης Αθανάσιος"
The student name has to be in the following format: "LASTNAME FIRSTNAME" or "LASTNAME MIDDLENAME FIRSTNAME" if the student has a middle name.
ecs --info
This shows information about all scraped course databases.
Problem: After modifying the source code, running ecs commands still uses the old version.
Cause: The package was installed in standard mode, which creates a cached/compiled version that doesn't update when you change the source.
Solution: Install in development mode for live code updates:
pip uninstall eClass-Scraper
pip install -e .Contributions are welcome! Please feel free to fork the repository and submit a pull request.
For questions or feedback, feel free to reach me out: