SearXNG Web Search

SkillSearch

Deep web search using the local SearXNG metasearch instance. Use when you need to research a topic, find documentation, look up current events, or gather information from the web.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the SearXNG Web Search skill

What this skill tells your AI

The instructions your AI receives, as published by yspreen/dotfiles in .agents/skills/searxng/SKILL.md and read by ahel’s review.

Use this skill to search with the local helper command:

search-internet "This is my search"

The command automatically:

  1. Verifies Docker is running (tries orp, then orb, then opens OrbStack/Docker).
  2. Ensures the SearXNG container is running from ~/Documents/proj/searxng with:
    docker run --rm --name searxng -d \
        -p 8888:8080 \
        -v "./config/:/etc/searxng/" \
        -v "./data/:/var/cache/searxng/" \
        docker.io/searxng/searxng:latest
    
  3. Runs a JSON search request against http://localhost:8888/search.
  4. Keeps a 10-minute idle timeout that kills the searxng container if no new searches happen.

search-internet is provisioned by /Users/user/dotfiles/scripts/post-activation.sh.

Usage notes

  • Pass exactly one query argument (quote it).
  • Output is raw JSON from SearXNG; use jq when you want filtered fields.

Signals

GitHub stars
33
Forks
2
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
searxng-yspreen
Source
github.com/yspreen/dotfiles