searxng_extra/standalone_searx.py

Script to run SearXNG from terminal.

Getting categories without initiate the engine will only return [‘general’]

>>> import searx.engines
... list(searx.engines.categories.keys())
['general']
>>> import searx.search
... searx.search.initialize()
... list(searx.engines.categories.keys())
['general', 'it', 'science', 'images', 'news', 'videos', 'music', 'files', 'social media', 'map']

Example to use this script:

$ python3 searxng_extra/standalone_searx.py rain

Danger

Be warned, using the standalone_searx.py won’t give you privacy!

On the contrary, this script behaves like a SearXNG server: your IP is exposed and tracked by all active engines (google, bing, qwant, … ), with every query!

Example to run it from python:

>>> import importlib
... import json
... import sys
... import searx.engines
... import searx.search
... search_query = 'rain'
... # initialize engines
... searx.search.initialize()
... # load engines categories once instead of each time the function called
... engine_cs = list(searx.engines.categories.keys())
... # load module
... spec = importlib.util.spec_from_file_location(
...     'utils.standalone_searx', 'searxng_extra/standalone_searx.py')
... sas = importlib.util.module_from_spec(spec)
... spec.loader.exec_module(sas)
... # use function from module
... prog_args = sas.parse_argument([search_query], category_choices=engine_cs)
... search_q = sas.get_search_query(prog_args, engine_categories=engine_cs)
... res_dict = sas.to_dict(search_q)
... sys.stdout.write(json.dumps(
...     res_dict, sort_keys=True, indent=4, ensure_ascii=False,
...     default=sas.json_serial))
{
    "answers": [],
    "infoboxes": [ {...} ],
    "paging": true,
    "results": [... ],
    "results_number": 820000000.0,
    "search": {
        "lang": "all",
        "pageno": 1,
        "q": "rain",
        "safesearch": 0,
        "timerange": null
    },
    "suggestions": [...]
}

searxng_extra.standalone_searx.get_search_query(args: Namespace, engine_categories: Optional[List[str]] = None) → SearchQuery

Get search results for the query

searxng_extra.standalone_searx.json_serial(obj: Any) → Any

JSON serializer for objects not serializable by default json code.

Raises:

TypeError – raised when obj is not serializable

searxng_extra.standalone_searx.no_parsed_url(results: List[Dict[str, Any]]) → List[Dict[str, Any]]

Remove parsed url from dict.

searxng_extra.standalone_searx.parse_argument(args: Optional[List[str]] = None, category_choices: Optional[List[str]] = None) → Namespace

Parse command line.

Raises:

SystemExit – Query argument required on args

Examples:

>>> import importlib
... # load module
... spec = importlib.util.spec_from_file_location(
...     'utils.standalone_searx', 'utils/standalone_searx.py')
... sas = importlib.util.module_from_spec(spec)
... spec.loader.exec_module(sas)
... sas.parse_argument()
usage: ptipython [-h] [--category [{general}]] [--lang [LANG]] [--pageno [PAGENO]] [--safesearch [{0,1,2}]] [--timerange [{day,week,month,year}]]
                 query
SystemExit: 2
>>> sas.parse_argument(['rain'])
Namespace(category='general', lang='all', pageno=1, query='rain', safesearch='0', timerange=None)

searxng_extra.standalone_searx.to_dict(search_query: SearchQuery) → Dict[str, Any]

Get result from parsed arguments.