Searxng

Name: Searxng
Author: sundial-org

sundial-org/awesome-openclaw-skills

225 installs
638 repo stars
Updated March 7, 2026
sundial-org/awesome-openclaw-skills

Use searxng for development tasks

About

searxng: A skill for development. This provides functionality for development workflows.

searxng

Searxng by the numbers

225 all-time installs (skills.sh)
+1 installs in the week ending Aug 5, 2026 (Skillselion tracking)
Ranked #1,770 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
Data as of Aug 5, 2026 (Skillselion catalog sync)

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

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/sundial-org/awesome-openclaw-skills/searxng.svg)](https://skillselion.com/skills/sundial-org/awesome-openclaw-skills/searxng)

Installs	225
repo stars	★ 638
Last updated	March 7, 2026
Repository	sundial-org/awesome-openclaw-skills ↗

What it does

Use searxng for development tasks

Files

SKILL.mdMarkdownGitHub ↗

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

Publishing SearXNG Skill to ClawdHub

✅ Pre-Publication Verification

All files present:

[x] SKILL.md (v1.0.1)
[x] README.md
[x] LICENSE (MIT)
[x] CHANGELOG.md
[x] scripts/searxng.py
[x] .clawdhub/metadata.json

Security:

[x] No hardcoded private URLs
[x] Generic default (http://localhost:8080)
[x] Fully configurable via SEARXNG_URL

Author:

[x] Updated to: Avinash Venkatswamy

📤 Publishing Steps

Step 1: Login to ClawdHub

clawdhub login

This will open your browser. Complete the authentication flow.

Step 2: Verify Authentication

clawdhub whoami

Should return your user info if logged in successfully.

Step 3: Publish the Skill

From the workspace root:

cd ~/clawd
clawdhub publish skills/searxng

Or from the skill directory:

cd ~/clawd/skills/searxng
clawdhub publish .

Step 4: Verify Publication

After publishing, you can:

Search for your skill:

clawdhub search searxng

View on ClawdHub: Visit https://clawdhub.com/skills/searxng

📋 What Gets Published

The CLI will upload:

SKILL.md
README.md
LICENSE
CHANGELOG.md
scripts/ directory
.clawdhub/metadata.json

It will NOT upload:

PUBLISH.md (this file)
PUBLISHING_CHECKLIST.md
Any .git files
Any node_modules or temporary files

🔧 If Publishing Fails

Common Issues

1. Not logged in:

   clawdhub login

2. Invalid skill structure:

Verify SKILL.md has all required fields
Check .clawdhub/metadata.json is valid JSON

3. Duplicate slug:

If "searxng" is taken, you'll need a different name
Update name in SKILL.md and metadata.json

4. Network issues:

Check your internet connection
Try again: clawdhub publish skills/searxng

Get Help

clawdhub publish --help

📊 After Publishing

Update Notifications

If you make changes later:

1. Update version in SKILL.md and metadata.json 2. Add entry to CHANGELOG.md 3. Run: clawdhub publish skills/searxng

Manage Your Skill

Delete (soft-delete):

clawdhub delete searxng

Undelete:

clawdhub undelete searxng

🎉 Success!

Once published, users can install with:

clawdhub install searxng

Your skill will appear:

On ClawdHub website: https://clawdhub.com
In search results: clawdhub search privacy
In explore: clawdhub explore

---

Ready to publish? Run clawdhub login and then clawdhub publish skills/searxng!

ClawdHub Publishing Checklist

✅ Pre-Publication Checklist

Required Files

[x] SKILL.md - Skill definition with metadata
[x] README.md - Comprehensive documentation
[x] LICENSE - MIT License
[x] CHANGELOG.md - Version history
[x] scripts/searxng.py - Main implementation
[x] .clawdhub/metadata.json - ClawdHub metadata

SKILL.md Requirements

[x] name field
[x] description field
[x] author field
[x] version field
[x] homepage field
[x] triggers keywords (optional but recommended)
[x] metadata with emoji and requirements

Code Quality

[x] Script executes successfully
[x] Error handling implemented
[x] Dependencies documented (inline PEP 723)
[x] Help text / usage instructions
[x] Clean, readable code

Documentation

[x] Clear description of what it does
[x] Prerequisites listed
[x] Installation instructions
[x] Usage examples (CLI + conversational)
[x] Configuration options
[x] Troubleshooting section
[x] Feature list

Testing

[x] Tested with target system (SearXNG)
[x] Basic search works
[x] Category search works
[x] JSON output works
[x] Error cases handled gracefully
[ ] Tested on different SearXNG instances (optional)
[ ] Tested with authenticated SearXNG (optional)

Metadata

[x] Version number follows semver
[x] Author attribution
[x] License specified
[x] Tags/keywords for discovery
[x] Prerequisites documented

⚠️ Optional Improvements

Nice to Have (not blocking)

[ ] CI/CD for automated testing
[ ] Multiple example configurations
[ ] Screenshot/demo GIF
[ ] Video demonstration
[ ] Integration tests
[ ] Authentication support (for private instances)
[ ] Config file support (beyond env vars)
[ ] Auto-discovery of local SearXNG instances

Future Enhancements

[ ] Result caching
[ ] Search history
[ ] Favorite searches
[ ] Custom result templates
[ ] Export results to various formats
[ ] Integration with other Clawdbot skills

🚀 Publishing Steps

1. Review all files - Make sure everything is polished 2. Test one more time - Fresh installation test 3. Version bump if needed - Update SKILL.md, metadata.json, CHANGELOG.md 4. Git commit - Clean commit message 5. Submit to ClawdHub - Follow ClawdHub submission process 6. Monitor feedback - Be ready to address issues

📝 Current Status

Ready for publication: ✅ YES

Confidence level: High

Known limitations:

Requires a running SearXNG instance (clearly documented)
SSL verification disabled for self-signed certs (by design)
No authentication support yet (acceptable for v1.0.0)

Recommended for: Users who:

Value privacy
Run their own SearXNG instance
Want to avoid commercial search APIs
Need local/offline search capability

🎯 Next Steps

1. Publish to ClawdHub - Skill is ready! 2. Gather user feedback - Real-world usage 3. Plan v1.1.0 - Authentication support, more features 4. Community contributions - Accept PRs for improvements

---

Assessment: This skill is publication-ready! 🎉

All critical requirements are met, documentation is excellent, and the code works reliably.

SearXNG Search Skill for Clawdbot

Privacy-respecting web search using your local SearXNG instance.

Prerequisites

This skill requires a running SearXNG instance.

If you don't have SearXNG set up yet:

1. Docker (easiest):

   docker run -d -p 8080:8080 searxng/searxng

2. Manual installation: Follow the official guide

3. Public instances: Use any public SearXNG instance (less private)

Features

🔒 Privacy-focused: Uses your local SearXNG instance
🌐 Multi-engine: Aggregates results from multiple search engines
📰 Multiple categories: Web, images, news, videos, and more
🎨 Rich output: Beautiful table formatting with result snippets
🚀 Fast JSON mode: Programmatic access for scripts and integrations

Quick Start

Basic Search

Search "python asyncio tutorial"

Advanced Usage

Search "climate change" with 20 results
Search "cute cats" in images category
Search "breaking news" in news category from last day

Configuration

You must configure your SearXNG instance URL before using this skill.

Set Your SearXNG Instance

Configure the SEARXNG_URL environment variable in your Clawdbot config:

{
  "env": {
    "SEARXNG_URL": "https://your-searxng-instance.com"
  }
}

Or export it in your shell:

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

Direct CLI Usage

You can also use the skill directly from the command line:

# Basic search
uv run ~/clawd/skills/searxng/scripts/searxng.py search "query"

# More results
uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" -n 20

# Category search
uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" --category images

# JSON output (for scripts)
uv run ~/clawd/skills/searxng/scripts/searxng.py search "query" --format json

# Time-filtered news
uv run ~/clawd/skills/searxng/scripts/searxng.py search "latest AI news" --category news --time-range day

Time Ranges

Filter results by recency:

day - Last 24 hours
week - Last 7 days
month - Last 30 days
year - Last year

Examples

Web Search

uv run ~/clawd/skills/searxng/scripts/searxng.py search "rust programming language"

Image Search

uv run ~/clawd/skills/searxng/scripts/searxng.py search "sunset photography" --category images -n 10

Recent News

uv run ~/clawd/skills/searxng/scripts/searxng.py search "tech news" --category news --time-range day

JSON Output for Scripts

uv run ~/clawd/skills/searxng/scripts/searxng.py search "python tips" --format json | jq '.results[0]'

SSL/TLS Notes

The skill is configured to work with self-signed certificates (common for local SearXNG instances). If you need strict SSL verification, edit the script and change verify=False to verify=True in the httpx request.

Troubleshooting

Connection Issues

If you get connection errors:

1. Check your SearXNG instance is running:

   curl -k $SEARXNG_URL
   # Or: curl -k http://localhost:8080 (default)

2. Verify the URL in your config 3. Check SSL certificate issues

No Results

If searches return no results:

1. Check your SearXNG instance configuration 2. Ensure search engines are enabled in SearXNG settings 3. Try different search categories

Privacy Benefits

No tracking: All searches go through your local instance
No data collection: Results are aggregated locally
Engine diversity: Combines results from multiple search providers
Full control: You manage the SearXNG instance

About SearXNG

SearXNG is a free, open-source metasearch engine that respects your privacy. It aggregates results from multiple search engines while not storing your search data.

Learn more: https://docs.searxng.org/

License

This skill is part of the Clawdbot ecosystem and follows the same license terms.

#!/usr/bin/env python3
# /// script
# requires-python = ">=3.11"
# dependencies = ["httpx", "rich"]
# ///
"""SearXNG CLI - Privacy-respecting metasearch via your local instance."""

import argparse
import os
import sys
import json
import warnings
import httpx
from rich.console import Console
from rich.table import Table
from rich import print as rprint
from urllib.parse import urlencode

# Suppress SSL warnings for local self-signed certificates
warnings.filterwarnings('ignore', message='Unverified HTTPS request')

console = Console()
SEARXNG_URL = os.getenv("SEARXNG_URL", "http://localhost:8080")

def search_searxng(
    query: str,
    limit: int = 10,
    category: str = "general",
    language: str = "auto",
    time_range: str = None,
    output_format: str = "table"
) -> dict:
    """
    Search using SearXNG instance.
    
    Args:
        query: Search query string
        limit: Number of results to return
        category: Search category (general, images, news, videos, etc.)
        language: Language code (auto, en, de, fr, etc.)
        time_range: Time range filter (day, week, month, year)
        output_format: Output format (table, json)
    
    Returns:
        Dict with search results
    """
    params = {
        "q": query,
        "format": "json",
        "categories": category,
    }
    
    if language != "auto":
        params["language"] = language
    
    if time_range:
        params["time_range"] = time_range
    
    try:
        # Disable SSL verification for local self-signed certs
        response = httpx.get(
            f"{SEARXNG_URL}/search",
            params=params,
            timeout=30,
            verify=False  # For local self-signed certs
        )
        response.raise_for_status()
        
        data = response.json()
        
        # Limit results
        if "results" in data:
            data["results"] = data["results"][:limit]
        
        return data
        
    except httpx.HTTPError as e:
        console.print(f"[red]Error connecting to SearXNG:[/red] {e}", file=sys.stderr)
        return {"error": str(e), "results": []}
    except Exception as e:
        console.print(f"[red]Unexpected error:[/red] {e}", file=sys.stderr)
        return {"error": str(e), "results": []}


def display_results_table(data: dict, query: str):
    """Display search results in a rich table."""
    results = data.get("results", [])
    
    if not results:
        rprint(f"[yellow]No results found for:[/yellow] {query}")
        return
    
    table = Table(title=f"SearXNG Search: {query}", show_lines=False)
    table.add_column("#", style="dim", width=3)
    table.add_column("Title", style="bold")
    table.add_column("URL", style="blue", width=50)
    table.add_column("Engines", style="green", width=20)
    
    for i, result in enumerate(results, 1):
        title = result.get("title", "No title")[:70]
        url = result.get("url", "")[:45] + "..."
        engines = ", ".join(result.get("engines", []))[:18]
        
        table.add_row(
            str(i),
            title,
            url,
            engines
        )
    
    console.print(table)
    
    # Show additional info
    if data.get("number_of_results"):
        rprint(f"\n[dim]Total results available: {data['number_of_results']}[/dim]")
    
    # Show content snippets for top 3
    rprint("\n[bold]Top results:[/bold]")
    for i, result in enumerate(results[:3], 1):
        title = result.get("title", "No title")
        url = result.get("url", "")
        content = result.get("content", "")[:200]
        
        rprint(f"\n[bold cyan]{i}. {title}[/bold cyan]")
        rprint(f"   [blue]{url}[/blue]")
        if content:
            rprint(f"   [dim]{content}...[/dim]")


def display_results_json(data: dict):
    """Display results in JSON format for programmatic use."""
    print(json.dumps(data, indent=2))


def main():
    parser = argparse.ArgumentParser(
        description="SearXNG CLI - Search the web via your local SearXNG instance",
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog=f"""
Examples:
  %(prog)s search "python asyncio"
  %(prog)s search "climate change" -n 20
  %(prog)s search "cute cats" --category images
  %(prog)s search "breaking news" --category news --time-range day
  %(prog)s search "rust tutorial" --format json

Environment:
  SEARXNG_URL: SearXNG instance URL (default: {SEARXNG_URL})
        """
    )
    
    subparsers = parser.add_subparsers(dest="command", help="Commands")
    
    # Search command
    search_parser = subparsers.add_parser("search", help="Search the web")
    search_parser.add_argument("query", nargs="+", help="Search query")
    search_parser.add_argument(
        "-n", "--limit",
        type=int,
        default=10,
        help="Number of results (default: 10)"
    )
    search_parser.add_argument(
        "-c", "--category",
        default="general",
        choices=["general", "images", "videos", "news", "map", "music", "files", "it", "science"],
        help="Search category (default: general)"
    )
    search_parser.add_argument(
        "-l", "--language",
        default="auto",
        help="Language code (auto, en, de, fr, etc.)"
    )
    search_parser.add_argument(
        "-t", "--time-range",
        choices=["day", "week", "month", "year"],
        help="Time range filter"
    )
    search_parser.add_argument(
        "-f", "--format",
        choices=["table", "json"],
        default="table",
        help="Output format (default: table)"
    )
    
    args = parser.parse_args()
    
    if not args.command:
        parser.print_help()
        return
    
    if args.command == "search":
        query = " ".join(args.query)
        
        data = search_searxng(
            query=query,
            limit=args.limit,
            category=args.category,
            language=args.language,
            time_range=args.time_range,
            output_format=args.format
        )
        
        if args.format == "json":
            display_results_json(data)
        else:
            display_results_table(data, query)


if __name__ == "__main__":
    main()

Related skills

Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k

Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16k

Lark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k

Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41

Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k

Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198k

Backend & APIsbackendintegrations

About

Searxng by the numbers

Add your badge

What it does

Files

SearXNG Search

Commands

Web Search

Category Search

Advanced Options

Configuration

Features

API

Changelog

[1.0.1] - 2026-01-26

Changed

Security

[1.0.0] - 2026-01-26

Added

Features

Publishing SearXNG Skill to ClawdHub

✅ Pre-Publication Verification

📤 Publishing Steps

Step 1: Login to ClawdHub

Step 2: Verify Authentication

Step 3: Publish the Skill

Step 4: Verify Publication

📋 What Gets Published

🔧 If Publishing Fails

Common Issues

Get Help

📊 After Publishing

Update Notifications

Manage Your Skill

🎉 Success!

ClawdHub Publishing Checklist

✅ Pre-Publication Checklist

Required Files

SKILL.md Requirements

Code Quality

Documentation

Testing

Metadata

⚠️ Optional Improvements

Nice to Have (not blocking)

Future Enhancements

🚀 Publishing Steps

📝 Current Status

🎯 Next Steps

SearXNG Search Skill for Clawdbot

Prerequisites

Features

Quick Start

Basic Search

Advanced Usage

Configuration

Set Your SearXNG Instance

Direct CLI Usage

Available Categories

Time Ranges

Examples

Web Search

Image Search

Recent News

JSON Output for Scripts

SSL/TLS Notes

Troubleshooting

Connection Issues

No Results

Privacy Benefits

About SearXNG

License

Related skills

This week in AI coding