o2_scrap is a python library to access the web portal of Telefonica O2 Germany to fetch
- mobile data-usage of the phone numbers under a specific contract
- the mobile plan details
- the last 6 bills
These instructions will get you a copy of the project up and running on your local machine.
To run o2_scrap on your system you need
- Python
- Selenium - Selenium Python Bindigs
- geckodriver - Proxy for using W3C WebDriver-compatible clients to interact with Gecko-based browsers.
- Beautiful Soup - a Python library for pulling data out of HTML and XML files.
Please make sure python and all the above modules had been installed successfully before you start any kind of testing.
> pip install o2_scrap- download the archive and unpack it
- enter the directory and run the setup script
> python setup.py install- download the archive and unpack it
- move the "o2_scrap" subfolder into the directory your script is located
you need to import o2_scrap into your script
> from o2_scrap import O2mobilecreate a new o2_scrap context handler and login to web portal portal to
> with O2mobile(USER, PASSWORD, DEBUG, HEADLESS) as O2M:- USER: User-account for o2-online.de
- PASSWORD: Password for the above user-account
- DEBUG: True/False - Debug-mode shows more messages and takes screenshots
- HEADLESS: True/Fals - Turn headless mode on/off (usefull for debugging)
The method get_numbers() can be used to get the list of mobile numbers under the same contract
> numbers = O2M.get_numbers()The method returns a dictionary containing the mobile numbers and tariff name
> from pprint import pprint
> pprint(numbers)
{u'0176-1234567': u'O2 Blue Data S',
u'0176-101010101': u'O2 Free M',
u'0176-87654321': u'O2 Blue Basic',
u'0176-12312345' Blue All-in L (2015)',
u'0179-5513345': u'O2 Blue All-in S (2015)'}To get the mobile data-usage and further plan details use the get_overview() method
> data_dict = O2M.get_overview(<mobile-number>)- mobile-number: phone number to be queried (format must be as obtained via get_numbers() method)
The method returns a dictionary in the following format
> from pprint import pprint
> pprint(data_dict)
{'data-usage': {'autoadjust': u'Datenautomatik deaktiviert',
'current': '122 MB',
'limit': u'2 GB',
'estimation': u'2,35 GB'},
'plan-data': {u'K\xfcndigungsfrist:': u'3 Monat(e) zum Vertragsende',
u'Verl\xe4ngerbar ab:': u'15.12.2017',
u'Vertragsbeginn:': u'16.08.2016',
u'Vertragsende:': u'15.08.2017',
'price': u'19,99 \u20ac\nmonatlich',
u'sp\xe4tester K\xfcndigungstermin:': u'15.05.2018',
'tariff': u'O2 Blue All-in S (2015)'}}To get the latest bills the method get_bills() must be used.
bill_list = O2M.get_bills()The method returns a list of bills in the following format
> from pprint import pprint
> pprint(bill_list)
[{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-0-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'23,13€',
'text': u'Aktuelle Rechnung vom 03.01.18'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-1-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'56,95€',
'text': u'Rechnung vom 03.12.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-2-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'45,95€',
'text': u'Rechnung vom 03.11.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-3-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'23,39€',
'text': u'Rechnung vom 04.10.17'},
{'download': u'https://www.o2online.de/ecare/?0-1.ILinkListener-selfcarePanel-content-contentContainer-content-tabContent-content-mainBills-content-list-4-billDownloadPanel-billDocumentParts-0-downloadLink&intcmp=epo2p_quick-links-teaser_mein-o2-mein-verbrauch',
'price': u'67,44€',
'text': u'Rechnung vom 05.09.17'}]to close the browser instance and end the session use the logout() methods
> O2M.logout(o2b)create a new context handler and login to web portal portal to
> with O2dsl(USER, PASSWORD, DEBUG) as O2D:DSL usage statistics can be obtained by using the get_overview() method
> data_usage = O2D.get_overview()the method will return a dictionary containing
- the actual data usage
- the monthly limit
- the prognosed data usage by end of the period
- the remaining time till period ends
- a dictionary with the data consumption of the last 6 months
> from pprint import pprint
> pprint(data_usage)
{'history': [{'from': u'15.08.', 'to': u'15.09.', 'usage': 213},
{'from': u'15.09.', 'to': u'15.10.', 'usage': 271},
{'from': u'15.10.', 'to': u'15.11.', 'usage': 326},
{'from': u'15.11.', 'to': u'15.12.', 'usage': 123},
{'from': u'15.12.', 'to': u'15.01.', 'usage': 89},
{'from': u'15.01.', 'to': u'15.02.', 'usage': 472}],
'limit': 300,
'prognosed': 169,
'remaining': u'Noch 25 Tage im Rechnungsmonat',
'since': u'Verbrauchte Daten seit 15.02.2018',
'used': 66}Please check the doc folder of the project. You will find further documentation and an example scripts of all methods there.
Please read CONTRIBUTING.md for details on my code of conduct, and the process for submitting pull requests. Please note that I have a life besides programming. Thus, expect a delay in answering.
I use SemVer for versioning. For the versions available, see the tags on this repository.
This project is licensed under the GPLv3 - see the LICENSE.md file for details