Skip to content

SearXNG is a free internet metasearch engine which aggregates results from various search services and databases. Users are neither tracked nor profiled.

[feat] engines: add findborg.com - general, news, images, videos (#6688)

Bnyrod63bbef7a028
diff --git a/searx/engines/findborg.py b/searx/engines/findborg.py
new file mode 100644
index 000000000..3b59fe7d0
--- /dev/null
+++ b/searx/engines/findborg.py
@@ -0,0 +1,64 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+"""Findborg_ is a small search engine that gets its results from Brave.
+
+.. _Findborg: https://www.findborg.com/about/
+"""
+
+import typing as t
+from urllib.parse import urlencode
+
+from searx.engines.brave import parse_image_result, parse_news_result, parse_search_result, parse_video_result
+from searx.extended_types import SXNG_Response
+from searx.result_types import EngineResults
+
+if t.TYPE_CHECKING:
+ from searx.search.processors import OnlineParams
+
+about = {
+ "website": "https://www.findborg.com",
+ "official_api_documentation": None,
+ "use_official_api": False,
+ "require_api_key": False,
+ "results": "JSON",
+}
+categories: list[str] = None # type: ignore[reportAssignmentType]
+time_range_support = True
+
+FindborgCategType = t.Literal["search", "images", "videos", "news"]
+findborg_categ: FindborgCategType = None # type: ignore[reportAssignmentType]
+
+
+base_url = "https://www.findborg.com"
+
+
+def setup(_: dict[str, t.Any]):
+ if findborg_categ not in t.get_args(FindborgCategType):
+ raise ValueError("invalid category: %s" % findborg_categ)
+
+
+def request(query: str, params: "OnlineParams"):
+ args = {"q": query, "type": findborg_categ}
+ if params["time_range"]:
+ args["time"] = params["time_range"]
+ params["url"] = f"{base_url}/apis/proxy.php?{urlencode(args)}"
+
+
+def response(resp: "SXNG_Response") -> EngineResults:
+ data: dict[str, t.Any] = resp.json()["data"] # type: ignore[reportAny]
+
+ res = EngineResults()
+ match findborg_categ:
+ case "search":
+ for result in data["web"]["results"]:
+ res.add(parse_search_result(result))
+ case "news":
+ for result in data["results"]:
+ res.add(parse_news_result(result))
+ case "videos":
+ for result in data["results"]:
+ res.add(parse_video_result(result))
+ case "images":
+ for result in data["results"]:
+ res.add(parse_image_result(result))
+
+ return res
diff --git a/searx/settings.yml b/searx/settings.yml
index 17e6b17f6..f697d35b1 100644
--- a/searx/settings.yml
+++ b/searx/settings.yml
@@ -946,6 +946,35 @@ engines:
shortcut: fd
disabled: true
+ - name: findborg
+ engine: findborg
+ shortcut: fi
+ findborg_categ: search
+ categories: general
+ inactive: true
+
+ - name: findborg images
+ engine: findborg
+ shortcut: fii
+ paging: false
+ findborg_categ: images
+ categories: images
+ inactive: true
+
+ - name: findborg videos
+ engine: findborg
+ shortcut: fiv
+ findborg_categ: videos
+ categories: videos
+ inactive: true
+
+ - name: findborg news
+ engine: findborg
+ shortcut: fin
+ findborg_categ: news
+ categories: news
+ inactive: true
+
- name: findfiles
engine: findfiles
findfiles_categ: all