[feat] engine: implementation of imgur

2 files changed, 71 insertions, 0 deletions

diff --git a/searx/engines/imgur.py b/searx/engines/imgur.py
new file mode 100644
index 000000000..960f69f07
--- /dev/null
+++ b/searx/engines/imgur.py
@@ -0,0 +1,66 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# lint: pylint
+"""Imgur (images)
+"""
+
+from urllib.parse import urlencode
+from lxml import html
+from searx.utils import extract_text, eval_xpath, eval_xpath_list
+
+about = {
+    "website": 'https://imgur.com/',
+    "wikidata_id": 'Q107565255',
+    "official_api_documentation": 'https://api.imgur.com/',
+    "use_official_api": False,
+    "require_api_key": False,
+    "results": 'HTML',
+}
+
+categories = ['images']
+paging = True
+time_range_support = True
+
+base_url = "https://imgur.com"
+
+results_xpath = "//div[contains(@class, 'cards')]/div[contains(@class, 'post')]"
+url_xpath = "./a/@href"
+title_xpath = "./a/img/@alt"
+thumbnail_xpath = "./a/img/@src"
+
+
+def request(query, params):
+    time_range = params['time_range'] or 'all'
+    args = {
+        'q': query,
+        'qs': 'thumbs',
+        'p': params['pageno'] - 1,
+    }
+    params['url'] = f"{base_url}/search/score/{time_range}?{urlencode(args)}"
+    return params
+
+
+def response(resp):
+    results = []
+
+    dom = html.fromstring(resp.text)
+
+    for result in eval_xpath_list(dom, results_xpath):
+        thumbnail_src = extract_text(eval_xpath(result, thumbnail_xpath))
+        img_src = thumbnail_src.replace("b.", ".")
+
+        # that's a bug at imgur's side:
+        # sometimes there's just no preview image, hence we skip the image
+        if len(thumbnail_src) < 25:
+            continue
+
+        results.append(
+            {
+                'template': 'images.html',
+                'url': base_url + extract_text(eval_xpath(result, url_xpath)),
+                'title': extract_text(eval_xpath(result, title_xpath)),
+                'img_src': img_src,
+                'thumbnail_src': thumbnail_src,
+            }
+        )
+
+    return results
diff --git a/searx/settings.yml b/searx/settings.yml
index 6946b89db..7ddf23984 100644
--- a/searx/settings.yml
+++ b/searx/settings.yml
@@ -875,6 +875,11 @@ engines:
     timeout: 6.0
     disabled: true
 
+  - name: imgur
+    engine: imgur
+    shortcut: img
+    disabled: true
+
   - name: ina
     engine: ina
     shortcut: in