Claude Skill

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

LLM Mart · 0 points · 3 views 0 listing impressions 0 install-command copies
Download kerberosclaw-kc_ai_skills-searxng-ad005ac.zip · 3 KB

Install

skills CLI npx skills add https://github.com/KerberosClaw/kc_ai_skills/tree/main/searxng
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kerberosclaw-kc-ai-skills@llmmart
Git 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_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).

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.

No comments yet.

Reviews (0)

No reviews yet.