Searxng

Privacy-respecting metasearch using your local SearXNG instance. Search the web, images, news, and more without external API dependencies.

Avinash Venkatswamy

@abk234

What This Skill Does

SearXNG is a CLI tool that queries your local SearXNG metasearch instance to search the web, images, news, and videos. It returns top results in plain text or JSON format, with options for language and time range filtering.

Replaces reliance on third-party search APIs by routing all queries through your own privacy-respecting SearXNG instance.

When to Use It

  • Search the web for current information without tracking
  • Find images related to a specific topic using your local instance
  • Retrieve recent news articles on a given subject
  • Search for videos across multiple engines aggregated by SearXNG
  • Fetch search results in JSON format for programmatic processing
  • Look up information with language or time-range filters applied

Install

$ openclaw skills install @abk234/searxng

SearXNG Search

Search the web using your local SearXNG instance - a privacy-respecting metasearch engine.

Commands

Web Search

uv 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

uv 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

uv 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:

export SEARXNG_URL=https://your-searxng-instance.com

Or configure in your Clawdbot config:

{
  "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).

Related skills