Web Search via SearXNG

CLI

# Basic search
python scripts/search.py "python async tutorial"
Limit results
python scripts/search.py "machine learning" --limit 5
Specific category
python scripts/search.py "breaking news" --category news
Time range
python scripts/search.py "tech announcements" --time week
Specific engines
python scripts/search.py "wikipedia python" --engines wikipedia
JSON output
python scripts/search.py "docker tutorial" --json

Python API

from searxng import SearXNGClient
Initialize
client = SearXNGClient()
Search
results = client.search("quantum computing")
Access results
for result in results["results"]:
    print(f"{result['title']}: {result['url']}")
Search with options
results = client.search(
    query="AI safety",
    category="news",
    time_range="month",
    limit=5
)

Edit config/searxng.yaml:

# SearXNG instance URL
Use public instance or your own
base_url: "https://searx.be"  # or your local instance
Default search settings
defaults:
  language: "en-US"
  safesearch: 0  # 0 = off, 1 = moderate, 2 = strict
  time_range: ""  # day, week, month, year
  results_per_page: 10
Preferred engines (optional)
engines:
  - google
  - duckduckgo
  - bing
  - brave
  - wikipedia
Categories
categories:
  general: "general"
  news: "news"
  images: "images"
  videos: "videos"
  files: "files"

"Connection refused"

# Check if SearXNG instance is reachable
curl https://your-searx-instance/healthz

"No results"

"Rate limited"