69 lines
1.7 KiB
Python
69 lines
1.7 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""Engine for Microsoft Learn, Microsoft's technical knowledge base.
|
|
|
|
To use this engine add the following entry to your engines list
|
|
in ``settings.yml``:
|
|
|
|
.. code:: yaml
|
|
|
|
- name: microsoft learn
|
|
engine: microsoft_learn
|
|
shortcut: msl
|
|
disabled: false
|
|
"""
|
|
|
|
from urllib.parse import urlencode
|
|
from searx.result_types import EngineResults
|
|
|
|
engine_type = "online"
|
|
language_support = True
|
|
categories = ["it"]
|
|
paging = True
|
|
page_size = 10
|
|
time_range_support = False
|
|
|
|
search_api = "https://learn.microsoft.com/api/search?"
|
|
|
|
about = {
|
|
"website": "https://learn.microsoft.com",
|
|
"wikidata_id": "Q123663245",
|
|
"official_api_documentation": None,
|
|
"use_official_api": False,
|
|
"require_api_key": False,
|
|
"results": "JSON",
|
|
}
|
|
|
|
|
|
def request(query, params):
|
|
|
|
if params['language'] == 'all':
|
|
params['language'] = 'en-us'
|
|
|
|
query_params = [
|
|
("search", query),
|
|
("locale", params["language"]),
|
|
("scoringprofile", "semantic-answers"),
|
|
("facet", "category"),
|
|
("facet", "products"),
|
|
("facet", "tags"),
|
|
("$top", "10"),
|
|
("$skip", (params["pageno"] - 1) * page_size),
|
|
("expandScope", "true"),
|
|
("includeQuestion", "false"),
|
|
("applyOperator", "false"),
|
|
("partnerId", "LearnSite"),
|
|
]
|
|
|
|
params["url"] = search_api + urlencode(query_params)
|
|
return params
|
|
|
|
|
|
def response(resp) -> EngineResults:
|
|
res = EngineResults()
|
|
json_data = resp.json()
|
|
|
|
for result in json_data["results"]:
|
|
res.add(res.types.MainResult(url=result["url"], title=result["title"], content=result.get("description", "")))
|
|
|
|
return res
|