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-read
Install
npx skills add https://github.com/KerberosClaw/kc_ai_skills/tree/main/searxng
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kerberosclaw-kc-ai-skills@llmmart
git clone https://github.com/KerberosClaw/kc_ai_skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kerberosclaw/kc_ai_skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
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
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).
Files (kc_ai_skills)
-
scripts
-
searxng-search 121 B · in bundle
-
searxng.py 6.1 KB
Loading…
-
-
SKILL.md 2.6 KB
--- name: searxng description: "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." author: Avinash Venkatswamy version: 1.0.2 status: stable homepage: https://searxng.org triggers: - "search for" - "search web" - "find information" - "look up" metadata: {"clawdbot":{"emoji":"🔍","requires":{"bins":["python3"]},"config":{"env":{"SEARXNG_URL":{"description":"SearXNG instance URL","default":"http://localhost:8080","required":true}}}}} --- # 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 ```bash 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 ```bash 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 ```bash 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: ```bash export 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).
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.