- name
- searxng
- description
- Search the web using a self-hosted SearXNG instance. Privacy-respecting metasearch that aggregates results from multiple engines.
- metadata
- clawdbot
- config
- optionalEnv
- tools
- description
- Search the web using the self-hosted SearXNG instance.
- args
- type
- string
- description
- Search query
- type
- string
- description
- Search categories (general, images, news, videos, it, science)
- default
- general
- command
- kind
- http
- method
- GET
- url
- ${SEARXNG_URL:-http://localhost:8080}/search
- query
- q
- ${query}
- categories
- ${categories}
- format
- json
SearXNG Search Skill
Search the web using your self-hosted SearXNG instance. Privacy-respecting metasearch that aggregates results from Google, DuckDuckGo, Brave, Startpage, and many other engines.
Prerequisites
SearXNG running locally or on a server.
Quick Docker setup:
mkdir -p ~/Projects/searxng/searxng
cd ~/Projects/searxng
cat > docker-compose.yml << 'EOF'
services:
searxng:
image: searxng/searxng:latest
container_name: searxng
ports:
- "8080:8080"
volumes:
- ./searxng:/etc/searxng:rw
environment:
- SEARXNG_BASE_URL=http://localhost:8080/
restart: unless-stopped
EOF
cat > searxng/settings.yml << 'EOF'
use_default_settings: true
server:
secret_key: "change-me-to-random-string"
bind_address: "127.0.0.1"
port: 8080
search:
safe_search: 0
autocomplete: "google"
default_lang: "en"
formats:
- html
- json
EOF
docker compose up -dConfiguration
Set the SearXNG URL (optional, defaults to http://localhost:8080):
export SEARXNG_URL="http://localhost:8080"Response Format
Each result includes:
title– Result titleurl– Link to the resultcontent– Snippet/descriptionengines– Engines returning the resultscore– Relevance scorecategory– Result category
Security Notes
- Default binding is
127.0.0.1to prevent public exposure. - Replace the default
secret_keywith a strong random value. - Do not expose SearXNG directly to the public internet without HTTPS and authentication.
- This skill uses HTTP requests only and does not execute shell commands.
Why SearXNG?
- Privacy-first (no tracking, no ads)
- Aggregates 70+ engines
- Self-hosted control
- JSON API support
- No API keys or rate limits