🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › SearXNG Docker
🦀 ClawHub

SearXNG Docker

by @triwinds

Search the web using a local SearXNG instance (privacy-respecting metasearch engine). Use when user asks to search, look something up, "搜索", "搜一下", "查一下", or...

Versionv1.0.0
Installs2
#clawhub
⚡ When to Use
TriggerAction
- Need results from multiple engines (Google, Bing, DuckDuckGo, etc.)
- Need news, images, IT/science, or social media search
- `web_search` unavailable or returns poor results
💡 Examples

All commands use the script at scripts/searxng_search.py (relative to this skill directory). The script defaults to http://127.0.0.1:8888 but accepts --base-url to point elsewhere.

# Basic search
python3 scripts/searxng_search.py "your query"
Number of results

python3 scripts/searxng_search.py "your query" -n 5
Language

python3 scripts/searxng_search.py "your query" -l zh    # Chinese
python3 scripts/searxng_search.py "your query" -l en    # English
Category

python3 scripts/searxng_search.py "your query" -c news
python3 scripts/searxng_search.py "your query" -c images
python3 scripts/searxng_search.py "your query" -c it
python3 scripts/searxng_search.py "your query" -c science
Time filter

python3 scripts/searxng_search.py "your query" -t day
python3 scripts/searxng_search.py "your query" -t week
python3 scripts/searxng_search.py "your query" -t month
Specific engines

python3 scripts/searxng_search.py "your query" -e google,bing
JSON output

python3 scripts/searxng_search.py "your query" --json
Custom SearXNG URL

python3 scripts/searxng_search.py "your query" --base-url http://192.168.1.100:8888
Combined

python3 scripts/searxng_search.py "最新科技新闻" -c news -l zh -t week -n 5

⚙️ Configuration

Edit files in the docker/ folder:

  • Port: Default 127.0.0.1:8888 → change in docker-compose.yml ports section
  • Engines: Edit settings.yml engines list (Google, Bing, DuckDuckGo, Wikipedia, GitHub enabled by default)
  • Language: default_lang in settings.yml (default: auto)

    • Troubleshooting

    # Check if running
docker ps | grep searxng
    Restart
    
docker compose -f docker/docker-compose.yml restart
    View logs
    
docker logs searxng --tail 50

    📋 Tips & Best Practices

  • SearXNG aggregates and deduplicates results from multiple engines
  • The score field indicates cross-engine ranking confidence
  • No API key needed — fully self-hosted and private

    • View on ClawHub
    TERMINAL
    clawhub install searxng-docker

    🧪 Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    Manus
    Task-oriented agent. Great for testing AI skills end-to-end.
    Try Manus →
    OpenClaw
    Local-first agent. Install skills via ClawHub CLI.
    Set up OpenClaw →
    Claude Code
    Anthropic's coding agent. Paste the prompt or SKILL.md into your session.
    Claude Code docs →
    Cursor
    AI-powered IDE. Use the smoke-test prompt in Cursor Agent.
    Open Cursor →
    Continue.dev
    Open-source AI code assistant. Add SKILL.md as a custom tool.
    Continue docs →
    Windsurf
    Agentic IDE by Codeium. Paste the prompt into Cascade.
    Try Windsurf →
    Cline
    VS Code extension for autonomous coding with MCP tools.
    Cline on GitHub →
    Copilot Workspace
    GitHub's AI dev environment. Suitable for code-generation skills.
    Copilot Workspace →

    🔍 Can't find the right skill?

    Search 60,000+ AI agent skills — free, no login needed.

    Search Skills →