searx.engines.google_news Namespace Reference

Functions
	request (query, params)
	response (resp)
	fetch_traits (EngineTraits engine_traits)

Variables
dict	about
list	categories = ['news']
bool	paging = False
bool	time_range_support = False
bool	safesearch = True
list	ceid_list
list	_skip_values
dict	_ceid_locale_map = {'NO:no': 'nb-NO'}

Detailed Description

This is the implementation of the Google News engine.

Google News has a different region handling compared to Google WEB.

- the ``ceid`` argument has to be set (:py:obj:`ceid_list`)
- the hl_ argument has to be set correctly (and different to Google WEB)
- the gl_ argument is mandatory

If one of this argument is not set correctly, the request is redirected to
CONSENT dialog::

  https://consent.google.com/m?continue=

The google news API ignores some parameters from the common :ref:`google API`:

- num_ : the number of search results is ignored / there is no paging all
  results for a query term are in the first response.
- save_ : is ignored / Google-News results are always *SafeSearch*

.. _hl: https://developers.google.com/custom-search/docs/xml_results#hlsp
.. _gl: https://developers.google.com/custom-search/docs/xml_results#glsp
.. _num: https://developers.google.com/custom-search/docs/xml_results#numsp
.. _save: https://developers.google.com/custom-search/docs/xml_results#safesp

Function Documentation

fetch_traits()

searx.engines.google_news.fetch_traits

(

EngineTraits

engine_traits

)

Definition at line 273 of file google_news.py.

def fetch_traits(engine_traits: EngineTraits):
    _fetch_traits(engine_traits, add_domains=False)
 
    engine_traits.custom['ceid'] = {}
 
    for ceid in ceid_list:
        if ceid in _skip_values:
            continue
 
        region, lang = ceid.split(':')
        x = lang.split('-')
        if len(x) > 1:
            if x[1] not in ['Hant', 'Hans']:
                lang = x[0]
 
        sxng_locale = _ceid_locale_map.get(ceid, lang + '-' + region)
        try:
            locale = babel.Locale.parse(sxng_locale, sep='-')
        except babel.UnknownLocaleError:
            print("ERROR: %s -> %s is unknown by babel" % (ceid, sxng_locale))
            continue
 
        engine_traits.custom['ceid'][locales.region_tag(locale)] = ceid

request()

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

Google-News search request

Definition at line 70 of file google_news.py.

def request(query, params):
    """Google-News search request"""
 
    sxng_locale = params.get('searxng_locale', 'en-US')
    ceid = locales.get_engine_locale(sxng_locale, traits.custom['ceid'], default='US:en')
    google_info = get_google_info(params, traits)
    google_info['subdomain'] = 'news.google.com'  # google news has only one domain
 
    ceid_region, ceid_lang = ceid.split(':')
    ceid_lang, ceid_suffix = (
        ceid_lang.split('-')
        + [
            None,
        ]
    )[:2]
 
    google_info['params']['hl'] = ceid_lang
 
    if ceid_suffix and ceid_suffix not in ['Hans', 'Hant']:
 
        if ceid_region.lower() == ceid_lang:
            google_info['params']['hl'] = ceid_lang + '-' + ceid_region
        else:
            google_info['params']['hl'] = ceid_lang + '-' + ceid_suffix
 
    elif ceid_region.lower() != ceid_lang:
 
        if ceid_region in ['AT', 'BE', 'CH', 'IL', 'SA', 'IN', 'BD', 'PT']:
            google_info['params']['hl'] = ceid_lang
        else:
            google_info['params']['hl'] = ceid_lang + '-' + ceid_region
 
    google_info['params']['lr'] = 'lang_' + ceid_lang.split('-')[0]
    google_info['params']['gl'] = ceid_region
 
    query_url = (
        'https://'
        + google_info['subdomain']
        + "/search?"
        + urlencode(
            {
                'q': query,
                **google_info['params'],
            }
        )
        # ceid includes a ':' character which must not be urlencoded
        + ('&ceid=%s' % ceid)
    )
 
    params['url'] = query_url
    params['cookies'] = google_info['cookies']
    params['headers'].update(google_info['headers'])
    return params
 
 

response()

searx.engines.google_news.response

(

resp

)

Get response from google's search request

Definition at line 125 of file google_news.py.

def response(resp):
    """Get response from google's search request"""
    results = []
    detect_google_sorry(resp)
 
    # convert the text to dom
    dom = html.fromstring(resp.text)
 
    for result in eval_xpath_list(dom, '//div[@class="xrnccd"]'):
 
        # The first <a> tag in the <article> contains the link to the article
        # The href attribute of the <a> tag is a google internal link, we have
        # to decode
 
        href = eval_xpath_getindex(result, './article/a/@href', 0)
        href = href.split('?')[0]
        href = href.split('/')[-1]
        href = base64.urlsafe_b64decode(href + '====')
        href = href[href.index(b'http') :].split(b'\xd2')[0]
        href = href.decode()
 
        title = extract_text(eval_xpath(result, './article/h3[1]'))
 
        # The pub_date is mostly a string like 'yesterday', not a real
        # timezone date or time.  Therefore we can't use publishedDate.
        pub_date = extract_text(eval_xpath(result, './article//time'))
        pub_origin = extract_text(eval_xpath(result, './article//a[@data-n-tid]'))
 
        content = ' / '.join([x for x in [pub_origin, pub_date] if x])
 
        # The image URL is located in a preceding sibling <img> tag, e.g.:
        # "https://lh3.googleusercontent.com/DjhQh7DMszk.....z=-p-h100-w100"
        # These URL are long but not personalized (double checked via tor).
 
        thumbnail = extract_text(result.xpath('preceding-sibling::a/figure/img/@src'))
 
        results.append(
            {
                'url': href,
                'title': title,
                'content': content,
                'thumbnail': thumbnail,
            }
        )
 
    # return results
    return results
 
 

Variable Documentation

_ceid_locale_map

dict searx.engines.google_news._ceid_locale_map = {'NO:no': 'nb-NO'}

protected

Definition at line 270 of file google_news.py.

_skip_values

list searx.engines.google_news._skip_values

protected

Initial value:

=  [
    'ET:en',  # english (ethiopia)
    'ID:en',  # english (indonesia)
    'LV:en',  # english (latvia)
]

Definition at line 264 of file google_news.py.

about

dict searx.engines.google_news.about

Initial value:

=  {
    "website": 'https://news.google.com',
    "wikidata_id": 'Q12020',
    "official_api_documentation": 'https://developers.google.com/custom-search',
    "use_official_api": False,
    "require_api_key": False,
    "results": 'HTML',
}

Definition at line 48 of file google_news.py.

categories

list searx.engines.google_news.categories = ['news']

Definition at line 58 of file google_news.py.

ceid_list

list searx.engines.google_news.ceid_list

Definition at line 174 of file google_news.py.

paging

bool searx.engines.google_news.paging = False

Definition at line 59 of file google_news.py.

safesearch

bool searx.engines.google_news.safesearch = True

Definition at line 66 of file google_news.py.

time_range_support

bool searx.engines.google_news.time_range_support = False

Definition at line 60 of file google_news.py.