Add searxng skill with portable configuration
This commit is contained in:
46
skills/searxng/SKILL.md
Normal file
46
skills/searxng/SKILL.md
Normal file
@@ -0,0 +1,46 @@
|
||||
---
|
||||
name: searxng
|
||||
description: Search the web through a local or self-hosted SearXNG instance. Use when you want privacy-respecting web, image, video, or news search without external search API keys, via scripts/searxng.py.
|
||||
---
|
||||
|
||||
# SearXNG Search
|
||||
|
||||
Use `scripts/searxng.py` to run searches against a SearXNG instance.
|
||||
|
||||
## Requirements
|
||||
|
||||
Required runtime:
|
||||
- `python3`
|
||||
- Python packages: `httpx`, `rich`
|
||||
|
||||
Configuration lookup order:
|
||||
1. `SEARXNG_URL` environment variable
|
||||
2. workspace `.clawdbot/credentials/searxng/config.json` found by walking upward from the script location
|
||||
3. `~/.clawdbot/credentials/searxng/config.json`
|
||||
4. fallback: `http://localhost:8080`
|
||||
|
||||
Config file shape if used:
|
||||
|
||||
```json
|
||||
{
|
||||
"url": "https://search.example.com"
|
||||
}
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Examples:
|
||||
|
||||
```bash
|
||||
python3 scripts/searxng.py search "OpenClaw" -n 5
|
||||
python3 scripts/searxng.py search "latest AI news" --category news -n 10
|
||||
python3 scripts/searxng.py search "cute cats" --category images --format json
|
||||
python3 scripts/searxng.py search "rust tutorial" --language en --time-range month
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Uses the SearXNG JSON API endpoint at `<SEARXNG_URL>/search`.
|
||||
- HTTPS certificate verification is disabled in the current script for compatibility with local/self-signed instances.
|
||||
- If connection fails, the script prints the URL it attempted.
|
||||
- `--format json` is best for programmatic use; table output is best for humans.
|
||||
Reference in New Issue
Block a user