A Python browser recorder that turns actions into simple Python code.
Erpeto is a Chrome recorder aimed for automation and HTTP content analysis. Its philosophy is simple: any HTTP request is a transformation of strings from the previous responses. It can generate automation scripts that only use Python's requests library.
To get started you need to make sure you have Google Chrome installed, or a similar release that supports the Chrome DevTools Protocol (CDP).
To install, you can either:
git clone https://github.com/RazorBest/erpeto && cd erpeto
python3 -m pip install -r requirements.txt
or:
pip install git+https://github.com/RazorBest/erpeto.git
To run from repository:
python3 main.py --help
Or, if installed via pip, you can use the erpeto command:
erpeto --help
A typical run goes like this:
- Open the Chrome browser with CDP debugging port enabled
- Connect to the debugging port and listen to the CDP events
- Wait for the user to perform the actions (enter credentials, login, click some buttons etc.)
- Analyse the recorded events, determining causality between requests
- Generate a python script
- Run the script to replay the user's actions
Erpeto does 3 things:
- Records network traffic and user actions using Chrome DevTools Protocol (CDP).
- Performs string based analysation to determine what parts of the request content should be dinamically determined by the content of a previous request. For example, a CSRF token is taken from the HTML of a response, and will be sent in a CSRF header in the next request. This is automatically detected.
- Generates a script that performs the requests, based an the analysation step.