Home

recipe_scrapers

A Ruby gem that reads recipes from cooking websites. It gives every site the same fields: the title, the ingredients as written and split into amount, unit and name, the instructions, times, yields, nutrition and more.

recipe = RecipeScrapers.scrape("https://www.recipetineats.com/crispy-potato-straws-pommes-paille/")
recipe.title  # => "Crispy potato straws (Pommes Paille)"
recipe.to_h   # every field as plain data

Using the gem

• Supported Sites: every site the gem reads out of the box
• Usage: fetching, other HTTP clients, unsupported sites, errors
• Recipe Fields: every field with its type and an example
• Configuration: timeouts, size limits, your own connection
• Parsers: your own ingredient and nutrient parsers
• API reference

Adding a site

• Adding a Site: from a recipe URL to a pull request
• Declarations: where the fields are on a site without usable markup
• Testing: recorded pages, and what to do when a site changes

Copyright

• Copyright and Usage: what the gem does and what you are responsible for
• License: the code and the recorded pages