searx.autocomplete Namespace Reference

Functions
	update_kwargs (**kwargs)
SXNG_Response	get (*args, **kwargs)
SXNG_Response	post (*args, **kwargs)
	baidu (query, _lang)
	brave (query, _lang)
	dbpedia (query, _lang)
	duckduckgo (query, sxng_locale)
	google_complete (query, sxng_locale)
	mwmbl (query, _lang)
	qihu360search (query, _lang)
	quark (query, _lang)
	seznam (query, _lang)
	sogou (query, _lang)
	stract (query, _lang)
	swisscows (query, _lang)
	qwant (query, sxng_locale)
	wikipedia (query, sxng_locale)
	yandex (query, _lang)
	search_autocomplete (backend_name, query, sxng_locale)

Variables
dict	backends

Detailed Description

This module implements functions needed for the autocompleter.

Function Documentation

baidu()

searx.autocomplete.baidu	(		query,
			_lang )

Definition at line 42 of file autocomplete.py.

def baidu(query, _lang):
    # baidu search autocompleter
    base_url = "https://www.baidu.com/sugrec?"
    response = get(base_url + urlencode({'ie': 'utf-8', 'json': 1, 'prod': 'pc', 'wd': query}))
 
    results = []
 
    if response.ok:
        data = response.json()
        if 'g' in data:
            for item in data['g']:
                results.append(item['q'])
    return results
 
 

References get().

Here is the call graph for this function:

brave()

searx.autocomplete.brave	(		query,
			_lang )

Definition at line 57 of file autocomplete.py.

def brave(query, _lang):
    # brave search autocompleter
    url = 'https://search.brave.com/api/suggest?'
    url += urlencode({'q': query})
    country = 'all'
    # if lang in _brave:
    #    country = lang
    kwargs = {'cookies': {'country': country}}
    resp = get(url, **kwargs)
 
    results = []
 
    if resp.ok:
        data = resp.json()
        for item in data[1]:
            results.append(item)
    return results
 
 

References get().

Here is the call graph for this function:

dbpedia()

searx.autocomplete.dbpedia	(		query,
			_lang )

Definition at line 76 of file autocomplete.py.

def dbpedia(query, _lang):
    # dbpedia autocompleter, no HTTPS
    autocomplete_url = 'https://lookup.dbpedia.org/api/search.asmx/KeywordSearch?'
 
    response = get(autocomplete_url + urlencode(dict(QueryString=query)))
 
    results = []
 
    if response.ok:
        dom = lxml.etree.fromstring(response.content)
        results = dom.xpath('//Result/Label//text()')
 
    return results
 
 

References get().

Here is the call graph for this function:

duckduckgo()

searx.autocomplete.duckduckgo	(		query,
			sxng_locale )

Autocomplete from DuckDuckGo. Supports DuckDuckGo's languages

Definition at line 91 of file autocomplete.py.

def duckduckgo(query, sxng_locale):
    """Autocomplete from DuckDuckGo. Supports DuckDuckGo's languages"""
 
    traits = engines['duckduckgo'].traits
    args = {
        'q': query,
        'kl': traits.get_region(sxng_locale, traits.all_locale),
    }
 
    url = 'https://duckduckgo.com/ac/?type=list&' + urlencode(args)
    resp = get(url)
 
    ret_val = []
    if resp.ok:
        j = resp.json()
        if len(j) > 1:
            ret_val = j[1]
    return ret_val
 
 

References get().

Here is the call graph for this function:

get()

SXNG_Response searx.autocomplete.get	(	*	args,
		**	kwargs )

Definition at line 32 of file autocomplete.py.

def get(*args, **kwargs) -> SXNG_Response:
    update_kwargs(**kwargs)
    return http_get(*args, **kwargs)
 
 

References update_kwargs().

Referenced by baidu(), brave(), dbpedia(), duckduckgo(), google_complete(), mwmbl(), qihu360search(), quark(), qwant(), seznam(), sogou(), swisscows(), wikipedia(), and yandex().

Here is the call graph for this function:

Here is the caller graph for this function:

google_complete()

searx.autocomplete.google_complete	(		query,
			sxng_locale )

Autocomplete from Google.  Supports Google's languages and subdomains
(:py:obj:`searx.engines.google.get_google_info`) by using the async REST
API::

    https://{subdomain}/complete/search?{args}

Definition at line 111 of file autocomplete.py.

def google_complete(query, sxng_locale):
    """Autocomplete from Google.  Supports Google's languages and subdomains
    (:py:obj:`searx.engines.google.get_google_info`) by using the async REST
    API::
 
        https://{subdomain}/complete/search?{args}
 
    """
 
    google_info = google.get_google_info({'searxng_locale': sxng_locale}, engines['google'].traits)
 
    url = 'https://{subdomain}/complete/search?{args}'
    args = urlencode(
        {
            'q': query,
            'client': 'gws-wiz',
            'hl': google_info['params']['hl'],
        }
    )
    results = []
    resp = get(url.format(subdomain=google_info['subdomain'], args=args))
    if resp and resp.ok:
        json_txt = resp.text[resp.text.find('[') : resp.text.find(']', -3) + 1]
        data = json.loads(json_txt)
        for item in data[0]:
            results.append(lxml.html.fromstring(item[0]).text_content())
    return results
 
 

References get().

Here is the call graph for this function:

mwmbl()

searx.autocomplete.mwmbl	(		query,
			_lang )

Autocomplete from Mwmbl_.

Definition at line 140 of file autocomplete.py.

def mwmbl(query, _lang):
    """Autocomplete from Mwmbl_."""
 
    # mwmbl autocompleter
    url = 'https://api.mwmbl.org/search/complete?{query}'
 
    results = get(url.format(query=urlencode({'q': query}))).json()[1]
 
    # results starting with `go:` are direct urls and not useful for auto completion
    return [result for result in results if not result.startswith("go: ") and not result.startswith("search: ")]
 
 

References get().

Here is the call graph for this function:

post()

SXNG_Response searx.autocomplete.post	(	*	args,
		**	kwargs )

Definition at line 37 of file autocomplete.py.

def post(*args, **kwargs) -> SXNG_Response:
    update_kwargs(**kwargs)
    return http_post(*args, **kwargs)
 
 

References update_kwargs().

Referenced by stract().

Here is the call graph for this function:

Here is the caller graph for this function:

qihu360search()

searx.autocomplete.qihu360search	(		query,
			_lang )

Definition at line 152 of file autocomplete.py.

def qihu360search(query, _lang):
    # 360Search search autocompleter
    url = f"https://sug.so.360.cn/suggest?{urlencode({'format': 'json', 'word': query})}"
    response = get(url)
 
    results = []
 
    if response.ok:
        data = response.json()
        if 'result' in data:
            for item in data['result']:
                results.append(item['word'])
    return results
 
 

References get().

Here is the call graph for this function:

quark()

searx.autocomplete.quark	(		query,
			_lang )

Definition at line 167 of file autocomplete.py.

def quark(query, _lang):
    # Quark search autocompleter
    url = f"https://sugs.m.sm.cn/web?{urlencode({'q': query})}"
    response = get(url)
 
    results = []
 
    if response.ok:
        data = response.json()
        for item in data.get('r', []):
            results.append(item['w'])
    return results
 
 

References get().

Here is the call graph for this function:

qwant()

searx.autocomplete.qwant	(		query,
			sxng_locale )

Autocomplete from Qwant. Supports Qwant's regions.

Definition at line 241 of file autocomplete.py.

def qwant(query, sxng_locale):
    """Autocomplete from Qwant. Supports Qwant's regions."""
    results = []
 
    locale = engines['qwant'].traits.get_region(sxng_locale, 'en_US')
    url = 'https://api.qwant.com/v3/suggest?{query}'
    resp = get(url.format(query=urlencode({'q': query, 'locale': locale, 'version': '2'})))
 
    if resp.ok:
        data = resp.json()
        if data['status'] == 'success':
            for item in data['data']['items']:
                results.append(item['value'])
 
    return results
 
 

References get().

Here is the call graph for this function:

search_autocomplete()

searx.autocomplete.search_autocomplete	(		backend_name,
			query,
			sxng_locale )

Definition at line 314 of file autocomplete.py.

def search_autocomplete(backend_name, query, sxng_locale):
    backend = backends.get(backend_name)
    if backend is None:
        return []
    try:
        return backend(query, sxng_locale)
    except (HTTPError, SearxEngineResponseException):
        return []

seznam()

searx.autocomplete.seznam	(		query,
			_lang )

Definition at line 181 of file autocomplete.py.

def seznam(query, _lang):
    # seznam search autocompleter
    url = 'https://suggest.seznam.cz/fulltext/cs?{query}'
 
    resp = get(
        url.format(
            query=urlencode(
                {'phrase': query, 'cursorPosition': len(query), 'format': 'json-2', 'highlight': '1', 'count': '6'}
            )
        )
    )
 
    if not resp.ok:
        return []
 
    data = resp.json()
    return [
        ''.join([part.get('text', '') for part in item.get('text', [])])
        for item in data.get('result', [])
        if item.get('itemType', None) == 'ItemType.TEXT'
    ]
 
 

References get().

Here is the call graph for this function:

sogou()

searx.autocomplete.sogou	(		query,
			_lang )

Definition at line 204 of file autocomplete.py.

def sogou(query, _lang):
    # Sogou search autocompleter
    base_url = "https://sor.html5.qq.com/api/getsug?"
    response = get(base_url + urlencode({'m': 'searxng', 'key': query}))
 
    if response.ok:
        raw_json = extr(response.text, "[", "]", default="")
 
        try:
            data = json.loads(f"[{raw_json}]]")
            return data[1]
        except json.JSONDecodeError:
            return []
 
    return []
 
 

References get().

Here is the call graph for this function:

stract()

searx.autocomplete.stract	(		query,
			_lang )

Definition at line 221 of file autocomplete.py.

def stract(query, _lang):
    # stract autocompleter (beta)
    url = f"https://stract.com/beta/api/autosuggest?q={quote_plus(query)}"
 
    resp = post(url)
 
    if not resp.ok:
        return []
 
    return [html.unescape(suggestion['raw']) for suggestion in resp.json()]
 
 

References post().

Here is the call graph for this function:

swisscows()

searx.autocomplete.swisscows	(		query,
			_lang )

Definition at line 233 of file autocomplete.py.

def swisscows(query, _lang):
    # swisscows autocompleter
    url = 'https://swisscows.ch/api/suggest?{query}&itemsCount=5'
 
    resp = json.loads(get(url.format(query=urlencode({'query': query}))).text)
    return resp
 
 

References get().

Here is the call graph for this function:

update_kwargs()

searx.autocomplete.update_kwargs

(

**

kwargs

)

Definition at line 26 of file autocomplete.py.

def update_kwargs(**kwargs):
    if 'timeout' not in kwargs:
        kwargs['timeout'] = settings['outgoing']['request_timeout']
    kwargs['raise_for_httperror'] = True
 
 

Referenced by get(), and post().

Here is the caller graph for this function:

wikipedia()

searx.autocomplete.wikipedia	(		query,
			sxng_locale )

Autocomplete from Wikipedia. Supports Wikipedia's languages (aka netloc).

Definition at line 258 of file autocomplete.py.

def wikipedia(query, sxng_locale):
    """Autocomplete from Wikipedia. Supports Wikipedia's languages (aka netloc)."""
    results = []
    eng_traits = engines['wikipedia'].traits
    wiki_lang = eng_traits.get_language(sxng_locale, 'en')
    wiki_netloc = eng_traits.custom['wiki_netloc'].get(wiki_lang, 'en.wikipedia.org')  # type: ignore
 
    url = 'https://{wiki_netloc}/w/api.php?{args}'
    args = urlencode(
        {
            'action': 'opensearch',
            'format': 'json',
            'formatversion': '2',
            'search': query,
            'namespace': '0',
            'limit': '10',
        }
    )
    resp = get(url.format(args=args, wiki_netloc=wiki_netloc))
    if resp.ok:
        data = resp.json()
        if len(data) > 1:
            results = data[1]
 
    return results
 
 

References get().

Here is the call graph for this function:

yandex()

searx.autocomplete.yandex	(		query,
			_lang )

Definition at line 285 of file autocomplete.py.

def yandex(query, _lang):
    # yandex autocompleter
    url = "https://suggest.yandex.com/suggest-ff.cgi?{0}"
 
    resp = json.loads(get(url.format(urlencode(dict(part=query)))).text)
    if len(resp) > 1:
        return resp[1]
    return []
 
 

References get().

Here is the call graph for this function:

Variable Documentation

backends

dict searx.autocomplete.backends

Initial value:

=  {
    '360search': qihu360search,
    'baidu': baidu,
    'brave': brave,
    'dbpedia': dbpedia,
    'duckduckgo': duckduckgo,
    'google': google_complete,
    'mwmbl': mwmbl,
    'quark': quark,
    'qwant': qwant,
    'seznam': seznam,
    'sogou': sogou,
    'stract': stract,
    'swisscows': swisscows,
    'wikipedia': wikipedia,
    'yandex': yandex,
}

Definition at line 295 of file autocomplete.py.