Searxng

Use when the user wants privacy-respecting web, image, news, or video search through a configured local SearXNG instance instead of external search APIs. Calls the bundled script against SEARXNG_URL, supports result limits/categories/language/time range, and can return human-readable or JSON output. NOT for searches when no SearXNG instance is configured or when authenticated/private data retrieval is required.From its SKILL.md

Install

npx -y skills add KerberosClaw/kc_ai_skills --skill searxng

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

reads credentialsReads from 1 credential source: `SEARXNG_URL`.
runs commandsInstructs the agent to run 8 commands, including `uv run {baseDir}/scripts/searxng.py search "query"` and 7 more.

SKILL.md

2.6 KB, 479 tokens by cl100k_base, as published. Nobody here has run it

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_URL is 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

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

What ships with it: 2 files

6.2 KB alongside SKILL.md, 2 of them executable

scripts/

searxng.pyruns6.1 KB
searxng-searchruns121 B