[feat] engine: implementation of Yummly

Co-authored-by: Markus Heiser <markus.heiser@damarit.de>

searx/engines/yummly.py

@@ -0,0 +1,79 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# lint: pylint
+"""Yummly
+"""
+
+from urllib.parse import urlencode
+
+from flask_babel import gettext
+from searx.utils import markdown_to_text
+
+about = {
+    "website": 'https://yummly.com',
+    "wikidata_id": 'Q8061140',
+    # not used since it requires an api key
+    "official_api_documentation": 'https://developer.yummly.com/documentation.html',
+    "use_official_api": False,
+    "require_api_key": False,
+    "results": 'JSON',
+}
+paging = True
+categories = []
+
+api_url = "https://mapi.yummly.com"
+number_of_results = 10
+show_pro_recipes = False
+base_url = "https://www.yummly.com"
+
+
+def request(query, params):
+    args = {
+        'q': query,
+        'start': (params['pageno'] - 1) * number_of_results,
+        'maxResult': number_of_results,
+    }
+
+    params['url'] = f"{api_url}/mapi/v23/content/search?{urlencode(args)}&allowedContent=single_recipe"
+
+    return params
+
+
+def response(resp):
+    results = []
+
+    json = resp.json()
+
+    for result in json['feed']:
+        # don't show pro recipes since they can't be accessed without an account
+        if not show_pro_recipes and result['proRecipe']:
+            continue
+
+        content = result['seo']['web']['meta-tags']['description']
+        description = result['content']['description']
+        if description is not None:
+            content = markdown_to_text(description['text'])
+
+        img_src = None
+        if result['display']['images']:
+            img_src = result['display']['images'][0]
+        elif result['content']['details']['images']:
+            img_src = result['content']['details']['images'][0]['resizableImageUrl']
+
+        url = result['display']['source']['sourceRecipeUrl']
+        if 'www.yummly.com/private' in url:
+            url = base_url + '/' + result['tracking-id']
+
+        results.append(
+            {
+                'url': url,
+                'title': result['display']['displayName'],
+                'content': content,
+                'img_src': img_src,
+                'metadata': f"{gettext('Language')}: {result['locale'].split('-')[0]}",
+            }
+        )
+
+    for suggestion in json['relatedPhrases']['keywords']:
+        results.append({'suggestion': suggestion})
+
+    return results

searx/settings.yml

@@ -1894,6 +1894,11 @@ engines:
     shortcut: wttr
     timeout: 9.0
 
+  - name: yummly
+    engine: yummly
+    shortcut: yum
+    disabled: true
+
   - name: brave
     engine: brave
     shortcut: br