mcpField
S
searxng

searxng

github.com/sundial-orgProductivity670235 installsUpdated 34w ago
Repository

About searxng

searxng is a skill for searching the web through a local SearXNG instance. It supports category, language, and time-range filters, with JSON output for programmatic use.

Key features

  1. 01Web search with result limits
  2. 02Image, news, and video categories
  3. 03Language and time-range filters
  4. 04JSON output

Use cases

  1. 01Search the web through a local SearXNG instance
  2. 02Retrieve results for image, news, or video searches
  3. 03Use search results in scripts via JSON output

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill searxng

After installing, type/searxngin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CHANGELOG.md
PUBLISH.md
PUBLISHING_CHECKLIST.md
README.md
scripts/
searxng.py

Details

From the project README

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

Comments

Markdown supported