@@ -1,16 +1,30 @@
1# SPDX-License-Identifier: AGPL-3.0-or-later
1# SPDX-License-Identifier: AGPL-3.0-or-later
3− Startpage (Web)
3+"""Startpage (Web)
7−from dateutil import parser
8−from datetime import datetime, timedelta
10+from urllib.parse import urlencode
10from unicodedata import normalize, combining
11from unicodedata import normalize, combining
12+from datetime import datetime, timedelta
14+from dateutil import parser
11from babel import Locale
16from babel import Locale
12from babel.localedata import locale_identifiers
17from babel.localedata import locale_identifiers
19+from searx import logger
20+from searx.network import get
13from searx.utils import extract_text, eval_xpath, match_language
21from searx.utils import extract_text, eval_xpath, match_language
22+from searx.exceptions import (
23+ SearxEngineResponseException,
24+ SearxEngineCaptchaException,
27+logger = logger.getChild('startpage')
@@ -33,7 +47,7 @@ supported_languages_url = 'https://www.startpage.com/do/settings'
34# search-url
48# search-url
35base_url = 'https://startpage.com/'
49base_url = 'https://startpage.com/'
36−search_url = base_url + 'do/search'
50+search_url = base_url + 'sp/search?'
38# specific xpath variables
52# specific xpath variables
39# ads xpath //div[@id="results"]/div[@id="sponsored"]//div[@class="result"]
53# ads xpath //div[@id="results"]/div[@id="sponsored"]//div[@class="result"]
@@ -42,18 +56,74 @@ results_xpath = '//div[@class="w-gl__result__main"]'
42link_xpath = './/a[@class="w-gl__result-title result-link"]'
56link_xpath = './/a[@class="w-gl__result-title result-link"]'
43content_xpath = './/p[@class="w-gl__description"]'
57content_xpath = './/p[@class="w-gl__description"]'
59+# timestamp of the last fetch of 'sc' code
64+def raise_captcha(resp):
66+ if str(resp.url).startswith('https://www.startpage.com/sp/captcha'):
67+ # suspend CAPTCHA for 7 days
68+ raise SearxEngineCaptchaException(suspended_time=7 * 24 * 3600)
71+def get_sc_code(headers):
72+ """Get an actual `sc` argument from startpage's home page.
74+ Startpage puts a `sc` argument on every link. Without this argument
75+ startpage considers the request is from a bot. We do not know what is
76+ encoded in the value of the `sc` argument, but it seems to be a kind of a
77+ *time-stamp*. This *time-stamp* is valid for a few hours.
79+ This function scrap a new *time-stamp* from startpage's home page every hour
84+ global sc_code_ts, sc_code # pylint: disable=global-statement
86+ if time() > (sc_code_ts + 3000):
87+ logger.debug("query new sc time-stamp ...")
89+ resp = get(base_url, headers=headers)
91+ dom = html.fromstring(resp.text)
94+ # href --> '/?sc=adrKJMgF8xwp20'
95+ href = eval_xpath(dom, '//a[@class="footer-home__logo"]')[0].get('href')
96+ except IndexError as exc:
97+ # suspend startpage API --> https://github.com/searxng/searxng/pull/695
98+ raise SearxEngineResponseException(
99+ suspended_time=7 * 24 * 3600, message="PR-695: query new sc time-stamp failed!"
104+ logger.debug("new value is: %s", sc_code)
46# do search-request
109# do search-request
47def request(query, params):
110def request(query, params):
49− params['url'] = search_url
112+ # pylint: disable=line-too-long
50− params['method'] = 'POST'
113+ # The format string from Startpage's FFox add-on [1]::
51− params['data'] = {
114+ #
115+ # https://www.startpage.com/do/dsearch?query={searchTerms}&cat=web&pl=ext-ff&language=__MSG_extensionUrlLanguage__&extVersion=1.3.0
117+ # [1] https://addons.mozilla.org/en-US/firefox/addon/startpage-private-search/
52 'query': query,
120 'query': query,
53 'page': params['pageno'],
121 'page': params['pageno'],
54 'cat': 'web',
122 'cat': 'web',
55− 'cmd': 'process_search',
123+ # 'pl': 'ext-ff',
56− 'engine0': 'v1all',
124+ # 'extVersion': '1.3.0',
126+ 'sc': get_sc_code(params['headers']),
59 # set language if specified
129 # set language if specified
@@ -61,9 +131,10 @@ def request(query, params):
61 lang_code = match_language(params['language'], supported_languages, fallback=None)
131 lang_code = match_language(params['language'], supported_languages, fallback=None)
62 if lang_code:
132 if lang_code:
63 language_name = supported_languages[lang_code]['alias']
133 language_name = supported_languages[lang_code]['alias']
64− params['data']['language'] = language_name
134+ args['language'] = language_name
65− params['data']['lui'] = language_name
135+ args['lui'] = language_name
137+ params['url'] = search_url + urlencode(args)
67 return params
138 return params
@@ -139,10 +210,11 @@ def response(resp):
140# get supported languages from their site
211# get supported languages from their site
141def _fetch_supported_languages(resp):
212def _fetch_supported_languages(resp):
142− # startpage's language selector is a mess
213+ # startpage's language selector is a mess each option has a displayed name
143− # each option has a displayed name and a value, either of which may represent the language name
214+ # and a value, either of which may represent the language name in the native
144− # in the native script, the language name in English, an English transliteration of the native name,
215+ # script, the language name in English, an English transliteration of the
145− # the English name of the writing script used by the language, or occasionally something else entirely.
216+ # native name, the English name of the writing script used by the language,
217+ # or occasionally something else entirely.
147 # this cases are so special they need to be hardcoded, a couple of them are mispellings
219 # this cases are so special they need to be hardcoded, a couple of them are mispellings
148 language_names = {
220 language_names = {
@@ -156,7 +228,15 @@ def _fetch_supported_languages(resp):
158 # get the English name of every language known by babel
230 # get the English name of every language known by babel
231+ language_names.update(
234+ name.lower(): lang_code
235+ # pylint: disable=protected-access
159− language_names.update({name.lower(): lang_code for lang_code, name in Locale('en')._data['languages'].items()})
236+ for lang_code, name in Locale('en')._data['languages'].items()
161 # get the native name of every language known by babel
241 # get the native name of every language known by babel
162 for lang_code in filter(lambda lang_code: lang_code.find('_') == -1, locale_identifiers()):
242 for lang_code in filter(lambda lang_code: lang_code.find('_') == -1, locale_identifiers()):
@@ -181,8 +261,8 @@ def _fetch_supported_languages(resp):
181 if isinstance(lang_code, str):
261 if isinstance(lang_code, str):
182 supported_languages[lang_code] = {'alias': sp_option_value}
262 supported_languages[lang_code] = {'alias': sp_option_value}
183 elif isinstance(lang_code, list):
263 elif isinstance(lang_code, list):
184− for lc in lang_code:
264+ for _lc in lang_code:
185− supported_languages[lc] = {'alias': sp_option_value}
265+ supported_languages[_lc] = {'alias': sp_option_value}
187 print('Unknown language option in Startpage: {} ({})'.format(sp_option_value, sp_option_text))
267 print('Unknown language option in Startpage: {} ({})'.format(sp_option_value, sp_option_text))