cookidump
1.0.0
Easily dump cookidoo recipes from the official website
This program allows you to dump all recipes on Cookidoo websites (available for different countries) for offline and posticipate reading. Those recipes are valid in particular for Thermomix/Bimby devices. In order to dump the recipes, a valid subscription is needed.
The initial concept of this program was based on jakubszalaty/cookidoo-parser.
If you intend to scientifically investigate or extend cookidump, please consider citing the following paper.
@article{cambiaso2022cookidump,
title = {Web security and data dumping: The Cookidump case},
journal = {Software Impacts},
volume = {14},
pages = {100426},
year = {2022},
issn = {2665-9638},
doi = {https://doi.org/10.1016/j.simpa.2022.100426},
url = {https://www.sciencedirect.com/science/article/pii/S2665963822001105},
author = {Enrico Cambiaso and Maurizio Aiello},
keywords = {Cyber-security, Data dump, Database security, Browser automation},
abstract = {In the web security field, data dumping activities are often related to a malicious exploitation. In this paper, we focus on data dumping activities executed legitimately by scraping/storing data shown on the browser. We evaluate such operation by proposing Cookidump, a tool able to dump all recipes available on the Cookidoo© website portal. While such scenario is not relevant, in terms of security and privacy, we discuss the impact of such kind of activity for other scenarios including web applications hosting sensitive information.}
}
Further information can be found at https://www.sciencedirect.com/science/article/pii/S2665963822001105.
nix run github:auino/cookidump -- <outputdir> [--separate-json]
Nix provisions google-chrome together with chromedriver. Only
<outputdir> and [--separate-json] arguments are expected.
git clone https://github.com/auino/cookidump.git
cd into the download folder
Install Python requirements:
pip install -r requirements.txt
Install the Google Chrome browser, if not already installed
Download the Chrome WebDriver and save it on the cookidump folder
You are ready to dump your recipes
Simply run the following command to start the program. The program is interactive to simplify it's usage.
python cookidump.py [--separate-json] <webdriverfile> <outputdir>
where:
webdriverfile identifies the path to the downloaded Chrome WebDriver (for instance, chromedriver.exe for Windows hosts, ./chromedriver for Linux and macOS hosts)outputdir identifies the path of the output directory (will be created, if not already existent)--separate-json allows to generate a separate JSON file for each recipe, instead of one aggregate file including all recipesThe program will open a Google Chrome window and wait until you are logged in into your Cookidoo account (different countries are supported).
After that, follow intructions provided by the script itself to proceed with the dump.
By following script instructions, it is also possible to apply custom filters to export selected recipes (for instance, in base of the dish, title and ingredients, Thermomix/Bimby version, etc.).
Output is represented by an index.html file, included in outputdir, plus a set of recipes inside of structured folders.
By opening the generated index.html file on your browser, it is possible to have a list of recipes downloaded and surf to the desired recipe.
The number of exported recipes is limited to around 1000 for each execution.
Hence, use of filters may help in this case to reduce the number of recipes exported.
A different approach, previously adopted, is based on the retrieval of structured data on recipes. More information can be found on the datastructure branch. Output is represented in this case in a different (structured) format, hence, it has to be interpreted. Such interpretation is not implemented in the linked previous commit.
The authors of this program are not responsible of the usage of it. This program is released only for research and dissemination purposes. Also, the program provides users the ability to locally and temporarily store recipes accessible through a legit subscription. Before using this program, check Cookidoo subscription terms of service, according to the country related to the exploited subscription. Sharing of the obtained recipes is not a legit activity and the authors of this program are not responsible of any illecit and sharing activity accomplished by the users.
You can find me on Twitter as @auino.
