À propos du projet

recipe-scrapers est un package Python conçu pour extraire des données de recettes depuis des sites de cuisine. Il analyse les informations de recettes à partir de la structure HTML standard, du balisage Schema.org (incluant les formats JSON-LD, Microdata et RDFa), ou des métadonnées OpenGraph. Le package fournit une API simple et cohérente pour récupérer des données telles que les ingrédients, les instructions, les temps de cuisson, et plus encore. Il est exclusivement axé sur l'analyse HTML et ne contourne ni ne bypass aucune mesure de protection contre les bots mise en place par les sites web. ## Installation ```shell pip install recipe-scrapers ``` ## Utilisation de base ```python from recipe_scrapers import scrape_me scraper = scrape_me("https://www.allrecipes.com/recipe/158968/spinach-and-feta-turkey-burgers/") scraper.title() scraper.instructions() scraper.to_json() # pour une liste complète des méthodes : # help(scraper) ``` Pour des implémentations avancées, vous devrez mettre en place votre propre solution pour récupérer les HTML de recettes et gérer les requêtes réseau. La bibliothèque fonctionne mieux lorsque vous fournissez à la fois le contenu HTML et son domaine source. Vous êtes encouragé à utiliser la méthode `scrape_html` : ```python from recipe_scrapers import scrape_html ``` La détection d'images de meilleure qualité est activée par défaut lorsque plusieurs options sont disponibles sur une page. Si vous préférez conserver la première image renvoyée par le site, désactivez ce comportement par appel ou via le paramètre global : ```python scraper = scrape_html(html, url, best_image=False) image_url = scraper.image() from recipe_scrapers.settings import settings settings.BEST_IMAGE_SELECTION = False ``` ## Sites pris en charge Une large gamme de sites de recettes est prise en charge dès l'installation. Consultez la [liste des sites pris en charge](https://docs.recipe-scrapers.com/getting-started/supported-sites/) pour la liste complète. Vous pouvez également obtenir la liste complète par programmation avec : ```python from recipe_scrapers import SCRAPERS SCRAPERS.keys() ``` ## Contribuer Les contributions sont les bienvenues. Veuillez lire le [guide de contribution](https://docs.recipe-scrapers.com/contributing/home/) pour commencer. ## Remerciements spéciaux À tous les [contributeurs](https://github.com/hhursev/recipe-scrapers/graphs/contributors) qui aident à améliorer ce projet. ## Partagez votre projet Vous avez une idée pour utiliser recipe-scrapers ? Consultez le [mur d'idées de projets](https://github.com/hhursev/recipe-scrapers/issues/9) pour trouver l'inspiration ou partager votre propre projet.