SearXNG Web Search

When to Use

• You need up-to-date information not in your training data
• Researching a topic, technology, library, or recent event
• Searching for news articles or current affairs
• Finding documentation, tutorials, or code examples
• Looking up anything that benefits from a live web search

Procedure

Run the search script with your query:

./scripts/search.py "<query>"

General web search

./scripts/search.py "Python asyncio best practices"

News search with time filter

./scripts/search.py "AI announcements" --engine news --time-range week

Technical / IT search

./scripts/search.py "Docker multi-stage build" --engine it --max-results 15

Science or academic topics

./scripts/search.py "transformer architecture attention mechanism" --engine science

Options

Flag	Short	Default	Description
--engine	-e	general	Category: general, news, images, videos, it, science, files, social media, music, map
--max-results	-n	10	Number of results to return
--time-range	-t	—	Filter by day, week, month, or year
--language	-l	en-US	Language code (e.g. zh-CN, fr-FR)
--format	-f	json	Output format: json or text
--url	—	$SEARXNG_URL	Override the SearXNG instance URL

Configuration

Set SEARXNG_URL to point at your instance (defaults to http://localhost:8080):

export SEARXNG_URL="http://localhost:8080"