Functions
	init (_)

	request (query, params)

	response (resp)

	parse_news (data)

	parse_images (data)

	parse_videos (data)

Variables
dict	about

bool	paging = True

bool	time_range_support = True

int	results_per_page = 10

list	categories = []

	ChinasoCategoryType = typing.Literal['news', 'videos', 'images']

str	chinaso_category = 'news'

	ChinasoNewsSourceType = typing.Literal['CENTRAL', 'LOCAL', 'BUSINESS', 'EPAPER', 'all']

ChinasoNewsSourceType	chinaso_news_source = 'all'

dict	time_range_dict = {'day': '24h', 'week': '1w', 'month': '1m', 'year': '1y'}

str	base_url = "https://www.chinaso.com"

Detailed Description

ChinaSo_, a search engine for the chinese language area.

.. attention::

   ChinaSo engine does not return real URL, the links from these search
   engines violate the privacy of the users!!

   We try to find a solution for this problem, please follow `issue #4694`_.

   As long as the problem has not been resolved, these engines are
   not active in a standard setup (``inactive: true``).

.. _ChinaSo: https://www.chinaso.com/
.. _issue #4694: https://github.com/searxng/searxng/issues/4694

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

The engine has the following additional settings:

- :py:obj:`chinaso_category` (:py:obj:`ChinasoCategoryType`)
- :py:obj:`chinaso_news_source` (:py:obj:`ChinasoNewsSourceType`)

In the example below, all three ChinaSO engines are using the :ref:`network
<engine network>` from the ``chinaso news`` engine.

.. code:: yaml

   - name: chinaso news
     engine: chinaso
     shortcut: chinaso
     categories: [news]
     chinaso_category: news
     chinaso_news_source: all

   - name: chinaso images
     engine: chinaso
     network: chinaso news
     shortcut: chinasoi
     categories: [images]
     chinaso_category: images

   - name: chinaso videos
     engine: chinaso
     network: chinaso news
     shortcut: chinasov
     categories: [videos]
     chinaso_category: videos


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

Function Documentation

◆ init()

searx.engines.chinaso.init ( _ )

Definition at line 109 of file chinaso.py.

def init(_):
    if chinaso_category not in ('news', 'videos', 'images'):
        raise ValueError(f"Unsupported category: {chinaso_category}")
    if chinaso_category == 'news' and chinaso_news_source not in typing.get_args(ChinasoNewsSourceType):
        raise ValueError(f"Unsupported news source: {chinaso_news_source}")
 
 

◆ parse_images()

searx.engines.chinaso.parse_images ( data )

Definition at line 182 of file chinaso.py.

def parse_images(data):
    results = []
    if not data.get("data", {}).get("arrRes"):
        raise SearxEngineAPIException("Invalid response")
 
    for entry in data["data"]["arrRes"]:
        results.append(
            {
                'url': entry["web_url"],
                'title': html_to_text(entry["title"]),
                'content': html_to_text(entry["ImageInfo"]),
                'template': 'images.html',
                'img_src': entry["url"].replace("http://", "https://"),
                'thumbnail_src': entry["largeimage"].replace("http://", "https://"),
            }
        )
    return results
 
 

◆ parse_news()

searx.engines.chinaso.parse_news ( data )

Definition at line 158 of file chinaso.py.

def parse_news(data):
    results = []
    if not data.get("data", {}).get("data"):
        raise SearxEngineAPIException("Invalid response")
 
    for entry in data["data"]["data"]:
        published_date = None
        if entry.get("timestamp"):
            try:
                published_date = datetime.fromtimestamp(int(entry["timestamp"]))
            except (ValueError, TypeError):
                pass
 
        results.append(
            {
                'title': html_to_text(entry["title"]),
                'url': entry["url"],
                'content': html_to_text(entry["snippet"]),
                'publishedDate': published_date,
            }
        )
    return results
 
 

◆ parse_videos()

searx.engines.chinaso.parse_videos ( data )

Definition at line 201 of file chinaso.py.

def parse_videos(data):
    results = []
    if not data.get("data", {}).get("arrRes"):
        raise SearxEngineAPIException("Invalid response")
 
    for entry in data["data"]["arrRes"]:
        published_date = None
        if entry.get("VideoPubDate"):
            try:
                published_date = datetime.fromtimestamp(int(entry["VideoPubDate"]))
            except (ValueError, TypeError):
                pass
 
        results.append(
            {
                'url': entry["url"],
                'title': html_to_text(entry["raw_title"]),
                'template': 'videos.html',
                'publishedDate': published_date,
                'thumbnail': entry["image_src"].replace("http://", "https://"),
            }
        )
    return results

◆ request()

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

Definition at line 116 of file chinaso.py.

def request(query, params):
    query_params = {"q": query}
 
    if time_range_dict.get(params['time_range']):
        query_params["stime"] = time_range_dict[params['time_range']]
        query_params["etime"] = 'now'
 
    category_config = {
        'news': {'endpoint': '/v5/general/v1/web/search', 'params': {'pn': params["pageno"], 'ps': results_per_page}},
        'images': {
            'endpoint': '/v5/general/v1/search/image',
            'params': {'start_index': (params["pageno"] - 1) * results_per_page, 'rn': results_per_page},
        },
        'videos': {
            'endpoint': '/v5/general/v1/search/video',
            'params': {'start_index': (params["pageno"] - 1) * results_per_page, 'rn': results_per_page},
        },
    }
    if chinaso_news_source != 'all':
        if chinaso_news_source == 'EPAPER':
            category_config['news']['params']["type"] = 'EPAPER'
        else:
            category_config['news']['params']["cate"] = chinaso_news_source
 
    query_params.update(category_config[chinaso_category]['params'])
 
    params["url"] = f"{base_url}{category_config[chinaso_category]['endpoint']}?{urlencode(query_params)}"
 
    return params
 
 

◆ response()

searx.engines.chinaso.response ( resp )

Definition at line 147 of file chinaso.py.

def response(resp):
    try:
        data = resp.json()
    except Exception as e:
        raise SearxEngineAPIException(f"Invalid response: {e}") from e
 
    parsers = {'news': parse_news, 'images': parse_images, 'videos': parse_videos}
 
    return parsers[chinaso_category](data)
 
 

Variable Documentation

◆ about

dict searx.engines.chinaso.about

Initial value:

=  {
    "website": "https://www.chinaso.com/",
    "wikidata_id": "Q10846064",
    "use_official_api": False,
    "require_api_key": False,
    "results": "JSON",
    "language": "zh",
}

Definition at line 65 of file chinaso.py.

◆ base_url

str searx.engines.chinaso.base_url = "https://www.chinaso.com"

Definition at line 106 of file chinaso.py.

◆ categories

list searx.engines.chinaso.categories = []

Definition at line 77 of file chinaso.py.

◆ chinaso_category

str searx.engines.chinaso.chinaso_category = 'news'

Definition at line 89 of file chinaso.py.

◆ chinaso_news_source

ChinasoNewsSourceType searx.engines.chinaso.chinaso_news_source = 'all'

Definition at line 101 of file chinaso.py.

◆ ChinasoCategoryType

searx.engines.chinaso.ChinasoCategoryType = typing.Literal['news', 'videos', 'images']

Definition at line 79 of file chinaso.py.

◆ ChinasoNewsSourceType

searx.engines.chinaso.ChinasoNewsSourceType = typing.Literal['CENTRAL', 'LOCAL', 'BUSINESS', 'EPAPER', 'all']

Definition at line 92 of file chinaso.py.

◆ paging

bool searx.engines.chinaso.paging = True

Definition at line 74 of file chinaso.py.

◆ results_per_page

int searx.engines.chinaso.results_per_page = 10

Definition at line 76 of file chinaso.py.

◆ time_range_dict

dict searx.engines.chinaso.time_range_dict = {'day': '24h', 'week': '1w', 'month': '1m', 'year': '1y'}

Definition at line 104 of file chinaso.py.

◆ time_range_support

bool searx.engines.chinaso.time_range_support = True

Definition at line 75 of file chinaso.py.

Functions

Variables