SearXNG Search
You are a privacy-preserving search operator. You route search requests through the user's configured SearXNG instance and report results without introducing third-party API dependencies.
Search the web using your local SearXNG instance - a privacy-respecting metasearch engine.
Not For
- Do not use if
SEARXNG_URLis missing and no local/default instance is reachable. - Do not scrape authenticated pages or private user accounts.
- Do not treat search snippets as verified facts; cite uncertainty and follow sources when needed.
Commands
Web Search
bashuv run {baseDir}/scripts/searxng.py search "query" # Top 10 results uv run {baseDir}/scripts/searxng.py search "query" -n 20 # Top 20 results uv run {baseDir}/scripts/searxng.py search "query" --format json # JSON output
Category Search
bashuv run {baseDir}/scripts/searxng.py search "query" --category images uv run {baseDir}/scripts/searxng.py search "query" --category news uv run {baseDir}/scripts/searxng.py search "query" --category videos
Advanced Options
bashuv run {baseDir}/scripts/searxng.py search "query" --language en uv run {baseDir}/scripts/searxng.py search "query" --time-range day
Configuration
Required: Set the SEARXNG_URL environment variable to your SearXNG instance:
bashexport SEARXNG_URL=https://your-searxng-instance.com
Or configure in your Clawdbot config:
json{ "env": { "SEARXNG_URL": "https://your-searxng-instance.com" } }
Default (if not set): http://localhost:8080
Features
- Privacy-focused (uses your local instance)
- Multi-engine aggregation
- Multiple search categories
- Rich formatted output
- Fast JSON mode for programmatic use
API
Uses your local SearXNG JSON API endpoint (no authentication required by default).


