searxng/seekr.py at 5f1dd5f3c31e4d18300ada2c8e7904b1742da784

 # SPDX-License-Identifier: AGPL-3.0-or-later
 """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
 ===============
 """
 from datetime import datetime
 from json import loads
 from urllib.parse import urlencode
 from flask_babel import gettext
 about = {
     "website": 'https://seekr.com/',
     "official_api_documentation": None,
     "use_official_api": False,
     "require_api_key": True,
     "results": 'JSON',
     "language": 'en',
 }
 base_url = "https://api.seekr.com"
 paging = True
 api_key = "srh1-22fb-sekr"
 """API key / reversed engineered / is still the same one since 2022."""
 seekr_category: str = 'unset'
 """Search category, any of ``news``, ``videos`` or ``images``."""
 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']}")
 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
 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
 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
 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
 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}")