searx.engines.seekr Namespace Reference

Functions
	init (engine_settings)
	request (query, params)
	_images_response (json)
	_videos_response (json)
	_news_response (json)
	response (resp)

Variables
dict	about
str	base_url = "https://api.seekr.com"
bool	paging = True
str	api_key = "srh1-22fb-sekr"
str	seekr_category = 'unset'

Detailed Description

seekr.com Seeker Score

Seekr is a privately held search and content evaluation engine that prioritizes
credibility over popularity.

Configuration
=============

The engine has the following additional settings:

- :py:obj:`seekr_category`
- :py:obj:`api_key`

This implementation is used by seekr engines in the :ref:`settings.yml
<settings engine>`:

.. code:: yaml

  - name: seekr news
    seekr_category: news
    ...
  - name: seekr images
    seekr_category: images
    ...
  - name: seekr videos
    seekr_category: videos
    ...

Known Quirks
============

The implementation to support :py:obj:`paging <searx.enginelib.Engine.paging>`
is based on the *nextpage* method of Seekr's REST API.  This feature is *next
page driven* and plays well with the :ref:`infinite_scroll <settings ui>`
setting in SearXNG but it does not really fit into SearXNG's UI to select a page
by number.

Implementations
===============

Function Documentation

_images_response()

searx.engines.seekr._images_response ( json )

protected

Definition at line 104 of file seekr.py.

def _images_response(json):
 
    search_results = json.get('expertResponses')
    if search_results:
        search_results = search_results[0].get('advice')
    else:  # response from a 'nextResultSet'
        search_results = json.get('advice')
 
    results = []
    if not search_results:
        return results
 
    for result in search_results['results']:
        summary = loads(result['summary'])
        results.append(
            {
                'template': 'images.html',
                'url': summary['refererurl'],
                'title': result['title'],
                'img_src': result['url'],
                'resolution': f"{summary['width']}x{summary['height']}",
                'thumbnail_src': 'https://media.seekr.com/engine/rp/' + summary['tg'] + '/?src= ' + result['thumbnail'],
            }
        )
 
    if search_results.get('nextResultSet'):
        results.append(
            {
                "engine_data": search_results.get('nextResultSet'),
                "key": "nextpage",
            }
        )
    return results
 
 

Referenced by response().

Here is the caller graph for this function:

_news_response()

searx.engines.seekr._news_response ( json )

protected

Definition at line 172 of file seekr.py.

def _news_response(json):
 
    search_results = json.get('expertResponses')
    if search_results:
        search_results = search_results[0]['advice']['categorySearchResult']['searchResult']
    else:  # response from a 'nextResultSet'
        search_results = json.get('advice')
 
    results = []
    if not search_results:
        return results
 
    for result in search_results['results']:
 
        results.append(
            {
                'url': result['url'],
                'title': result['title'],
                'content': result['summary'] or result["topCategory"] or result["displayUrl"] or '',
                'thumbnail': result.get('thumbnail', ''),
                'publishedDate': datetime.strptime(result['pubDate'][:19], '%Y-%m-%d %H:%M:%S'),
                'metadata': gettext("Language") + ': ' + result.get('language', ''),
            }
        )
 
    if search_results.get('nextResultSet'):
        results.append(
            {
                "engine_data": search_results.get('nextResultSet'),
                "key": "nextpage",
            }
        )
    return results
 
 

Referenced by response().

Here is the caller graph for this function:

_videos_response()

searx.engines.seekr._videos_response ( json )

protected

Definition at line 139 of file seekr.py.

def _videos_response(json):
 
    search_results = json.get('expertResponses')
    if search_results:
        search_results = search_results[0].get('advice')
    else:  # response from a 'nextResultSet'
        search_results = json.get('advice')
 
    results = []
    if not search_results:
        return results
 
    for result in search_results['results']:
        summary = loads(result['summary'])
        results.append(
            {
                'template': 'videos.html',
                'url': result['url'],
                'title': result['title'],
                'thumbnail': 'https://media.seekr.com/engine/rp/' + summary['tg'] + '/?src= ' + result['thumbnail'],
            }
        )
 
    if search_results.get('nextResultSet'):
        results.append(
            {
                "engine_data": search_results.get('nextResultSet'),
                "key": "nextpage",
            }
        )
    return results
 
 

Referenced by response().

Here is the caller graph for this function:

init()

searx.engines.seekr.init

(

engine_settings

)

Definition at line 68 of file seekr.py.

def init(engine_settings):
 
    # global paging
    if engine_settings['seekr_category'] not in ['news', 'videos', 'images']:
        raise ValueError(f"Unsupported seekr category: {engine_settings['seekr_category']}")
 
 

request()

searx.engines.seekr.request	(		query,
			params )

Definition at line 75 of file seekr.py.

def request(query, params):
 
    if not query:
        return None
 
    args = {
        'query': query,
        'apiKey': api_key,
    }
 
    api_url = base_url + '/engine'
    if seekr_category == 'news':
        api_url += '/v2/newssearch'
 
    elif seekr_category == 'images':
        api_url += '/imagetab'
 
    elif seekr_category == 'videos':
        api_url += '/videotab'
 
    params['url'] = f"{api_url}?{urlencode(args)}"
    if params['pageno'] > 1:
        nextpage = params['engine_data'].get('nextpage')
        if nextpage:
            params['url'] = nextpage
 
    return params
 
 

response()

searx.engines.seekr.response

(

resp

)

Definition at line 207 of file seekr.py.

def response(resp):
    json = resp.json()
 
    if seekr_category == "videos":
        return _videos_response(json)
    if seekr_category == "images":
        return _images_response(json)
    if seekr_category == "news":
        return _news_response(json)
 
    raise ValueError(f"Unsupported seekr category: {seekr_category}")

References _images_response(), _news_response(), and _videos_response().

Here is the call graph for this function:

Variable Documentation

about

dict searx.engines.seekr.about

Initial value:

=  {
    "website": 'https://seekr.com/',
    "official_api_documentation": None,
    "use_official_api": False,
    "require_api_key": True,
    "results": 'JSON',
    "language": 'en',
}

Definition at line 49 of file seekr.py.

api_key

str searx.engines.seekr.api_key = "srh1-22fb-sekr"

Definition at line 61 of file seekr.py.

base_url

str searx.engines.seekr.base_url = "https://api.seekr.com"

Definition at line 58 of file seekr.py.

paging

bool searx.engines.seekr.paging = True

Definition at line 59 of file seekr.py.

seekr_category

str searx.engines.seekr.seekr_category = 'unset'

Definition at line 64 of file seekr.py.