python-chefkoch

A simple Python retrieval tool for recipes from chefkoch.de

🐍 Installation

pip install python-chefkoch

Requirements:

• Python 3.7+
• requests
• beautifulsoup4
• isodate

🚀 Quickstart

from chefkoch.recipe import Recipe

recipe = Recipe('https://www.chefkoch.de/rezepte/745721177147257/Lasagne.html')
print(recipe.title)

🍽️ Recipe Attributes

🕵️ Retrievers

RandomRetriever

Retrieve one or more random recipes from chefkoch.de.

from chefkoch.retrievers import RandomRetriever

retriever = RandomRetriever()
recipes = retriever.get_recipes(n=3)  # Get 3 random recipes
retriever.close()  # Always close when done

DailyRecipeRetriever

Retrieve daily recommended recipes ("kochen" or "backen").

from chefkoch.retrievers import DailyRecipeRetriever

retriever = DailyRecipeRetriever()
recipes = retriever.get_recipes(type="kochen")  # or type="backen"
retriever.close()

SearchRetriever

Search for recipes with advanced filters.

from chefkoch.retrievers import SearchRetriever

retriever = SearchRetriever(
    properties=["Einfach"],
    health=["Vegan"],
    categories=["Pizza"],
    countries=["Italien"],
    meal_type=["Hauptspeise"],
    prep_times="30",
    ratings="4",
    sort="Bewertung"
)
recipes = retriever.get_recipes(search_query="Lasagne", page=1)
retriever.close()

Available Filter Options

• properties: Einfach, Schnell, Basisrezepte, Preiswert
• health: Vegetarisch, Vegan, Kalorienarm, Low Carb, Ketogen, Paleo, Fettarm, Trennkost, Vollwert
• categories: Auflauf, Pizza, Reis- oder Nudelsalat, Salat, Salatdressing, Tarte, Fingerfood, Dips, Saucen, Suppe, Klöße, Brot und Brötchen, Brotspeise, Aufstrich, Süßspeise, Eis, Kuchen, Kekse, Torte, Confiserie, Getränke, Shake, Gewürzmischung, Pasten, Studentenküche
• countries: Deutschland, Italien, Spanien, Portugal, Frankreich, England, Osteuropa, Skandinavien, Griechenland, Türkei, Russland, Naher Osten, Asien, Indien, Japan, Amerika, Mexiko, Karibik, Lateinamerika, Afrika, Marokko, Ägypten, Australien
• meal_type: Hauptspeise, Vorspeise, Beilage, Dessert, Snack, Frühstück
• prep_times: 15, 30, 60, 120, Alle
• ratings: Alle, 2, 3, 4, Top
• sort: Empfehlung, Bewertung, Neuheiten

🧹 Session Management

All retrievers (RandomRetriever, DailyRecipeRetriever, SearchRetriever) use a persistent HTTP session. Always call close() when done to free resources.

💁 Contributing

As an open-source initiative in a rapidly evolving domain, I welcome contributions, be it through the addition of new features or the improvement of existing ones. If you have any suggestions, bug reports, or annoyances, please report them to the issue tracker.

📃 License

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