mirror of
				https://github.com/searxng/searxng.git
				synced 2025-11-03 11:07:07 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			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
 |