searxngr-search

Stars14

Forks5

UpdatedApril 30, 2026 at 00:26

Search the local SearXNG instance via searxngr CLI. Use proactively when researching Reddit discussions, technical topics, or any web content — especially when you need to read actual post/comment text from Reddit threads.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

GregHilston

GregHilston/toolbox

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	searxngr-search
description	Search the local SearXNG instance via searxngr CLI. Use proactively when researching Reddit discussions, technical topics, or any web content — especially when you need to read actual post/comment text from Reddit threads.
model	inherit
tools	["Bash","WebFetch"]

SearXNG Search Skill

Search using the self-hosted SearXNG instance on dungeon via the searxngr CLI.

How to search

# Basic search
searxngr "your search query"

# Search with specific category
searxngr -c social+media "topic"

# JSON output (best for programmatic use)
searxngr --json "search query"

# More results
searxngr -n 20 "search query"

Reddit workflow

This is the primary use case. To find and read Reddit discussions:

Find threads — search with site restriction:

searxngr --json -w reddit.com "topic" | jq -r '.[] | "\(.title)\n  \(.url)\n"'

Read the thread — append .json to any Reddit URL and fetch it:

# Take a URL like https://www.reddit.com/r/homelab/comments/abc123/title/
# Fetch the JSON to get post body + all comments:
curl -s -H "User-Agent: searxngr-skill" "https://www.reddit.com/r/homelab/comments/abc123/title/.json" | jq '.[1].data.children[].data | {author, body}' | head -80

Or use WebFetch on the old.reddit.com URL for a simpler text view.

When to use this skill

Researching Reddit discussions or opinions on a topic
Finding technical solutions people have shared online
Searching without corporate tracking
Any web search where the built-in WebSearch could also work — prefer this for privacy

Configuration

Config file: ~/.config/searxngr/config.ini (managed by stow from ~/Git/toolbox/dot/searxngr-config/)
SearXNG URL: https://searxng.grehg2.xyz (dungeon instance via Tailscale)
INI section: must be [searxngr] (not [default])

Setup

Installed automatically on all hosts via nix-darwin/NixOS activation. For manual setup:

~/Git/toolbox/bin/setup-searxngr.sh

Troubleshooting

"command not found": Run ~/Git/toolbox/bin/setup-searxngr.sh
Connection timeout: Check Tailscale is connected (ping 100.103.22.125)
"No SearXNG instance URL set": Config file missing or has wrong section name. Re-stow: cd ~/Git/toolbox/dot && stow -t $HOME searxngr-config

More from this repository

same repository

github-code-researcher

GregHilston/toolbox

Research open-source projects and implementations on GitHub using the gh CLI. Finds code examples, implementation patterns, library usage, and discovers relevant projects. Handles multi-step searches with parallel query execution, refinement, and drill-down analysis. <example> Context: User implementing connection retry logic user: "Search GitHub for how projects implement retry logic on pgx.Pool.Acquire in Go" assistant: "I'll launch the github-code-researcher agent to find pgx.Pool retry implementations." <commentary> User wants focused implementation examples. Agent searches for code patterns and returns snippets with URLs. </commentary> </example> <example> Context: User exploring the project landscape user: "Find Go projects that implement a postgres proxy, especially ones using pgx with multi-backend support" assistant: "I'll use the github-code-researcher agent to discover Go-based PostgreSQL proxy projects." <commentary> User wants broad project discovery. Agent finds repos, drills down to check cri

2026-04-1714

name	searxngr-search
description	Search the local SearXNG instance via searxngr CLI. Use proactively when researching Reddit discussions, technical topics, or any web content — especially when you need to read actual post/comment text from Reddit threads.
model	inherit
tools	["Bash","WebFetch"]

SearXNG Search Skill

Search using the self-hosted SearXNG instance on dungeon via the searxngr CLI.

How to search

# Basic search
searxngr "your search query"

# Search with specific category
searxngr -c social+media "topic"

# JSON output (best for programmatic use)
searxngr --json "search query"

# More results
searxngr -n 20 "search query"

Reddit workflow

This is the primary use case. To find and read Reddit discussions:

Find threads — search with site restriction:

searxngr --json -w reddit.com "topic" | jq -r '.[] | "\(.title)\n  \(.url)\n"'

Read the thread — append .json to any Reddit URL and fetch it:

# Take a URL like https://www.reddit.com/r/homelab/comments/abc123/title/
# Fetch the JSON to get post body + all comments:
curl -s -H "User-Agent: searxngr-skill" "https://www.reddit.com/r/homelab/comments/abc123/title/.json" | jq '.[1].data.children[].data | {author, body}' | head -80

Or use WebFetch on the old.reddit.com URL for a simpler text view.

When to use this skill

Researching Reddit discussions or opinions on a topic
Finding technical solutions people have shared online
Searching without corporate tracking
Any web search where the built-in WebSearch could also work — prefer this for privacy

Configuration

Config file: ~/.config/searxngr/config.ini (managed by stow from ~/Git/toolbox/dot/searxngr-config/)
SearXNG URL: https://searxng.grehg2.xyz (dungeon instance via Tailscale)
INI section: must be [searxngr] (not [default])

Setup

Installed automatically on all hosts via nix-darwin/NixOS activation. For manual setup:

~/Git/toolbox/bin/setup-searxngr.sh

Troubleshooting

"command not found": Run ~/Git/toolbox/bin/setup-searxngr.sh
Connection timeout: Check Tailscale is connected (ping 100.103.22.125)
"No SearXNG instance URL set": Config file missing or has wrong section name. Re-stow: cd ~/Git/toolbox/dot && stow -t $HOME searxngr-config