searxng

# SearXNG Search

Search the web using your local SearXNG instance - a privacy-respecting metasearch engine.

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

# 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)**:
   ```bash
   docker run -d -p 8080:8080 searxng/searxng
   ```

2. **Manual installation**: Follow the [official guide](https://docs.searxng.org/admin/installation.html)

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:

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

Or export it in your shell:
```bash
export SEARXNG_URL=https://your-searxng-instance.com
```

## Direct CLI Usage

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

```bash
# 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...