1 files changed, 35 insertions, 0 deletions
diff --git a/searx/wikidata.py b/searx/wikidata.py
new file mode 100644
index 000000000..defb2a0bb
--- /dev/null
+++ b/searx/wikidata.py
@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: AGPL-3.0-or-later
+"""Shared methods for accessing Wikidata."""
+
+import typing as t
+from urllib.parse import urlencode
+
+from searx.network import get, post
+from searx.utils import gen_useragent
+
+
+# SPARQL
+SPARQL_ENDPOINT_URL = "https://query.wikidata.org/sparql"
+SPARQL_EXPLAIN_URL = "https://query.wikidata.org/bigdata/namespace/wdq/sparql?explain"
+
+
+def send_wikidata_query(query: str, method: str = "GET", **kwargs: dict[str, t.Any]) -> dict[str, t.Any]:
+    if method == "GET":
+        # query will be cached by wikidata
+        http_response = get(
+            SPARQL_ENDPOINT_URL + "?" + urlencode({"query": query}), headers=get_wikidata_headers(), **kwargs
+        )
+    else:
+        # query won't be cached by wikidata
+        http_response = post(SPARQL_ENDPOINT_URL, data={"query": query}, headers=get_wikidata_headers(), **kwargs)
+
+    http_response.raise_for_status()
+    return http_response.json()
+
+
+def get_wikidata_headers() -> dict[str, str]:
+    # user agent: https://www.mediawiki.org/wiki/Wikidata_Query_Service/User_Manual#Query_limits
+    return {
+        "Accept": "application/sparql-results+json",
+        "User-Agent": gen_useragent(),
+    }