searxngcli

Searches the web through a private SearXNG metasearch instance via the searxng CLI.

15|1|Updated Jan 3, 2026

Search Tags:#cli #web search #json #jq #searxng #metasearch #search engines

Ready to run

npx skills add https://github.com/fprochazka/claude-code-plugins --skill searxngcli-fprochazka

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: searxngcli
Source: https://github.com/fprochazka/claude-code-plugins/tree/main/plugins/searxngcli/skills/searxngcli
Command: npx skills add https://github.com/fprochazka/claude-code-plugins --skill searxngcli-fprochazka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It gives you web search results from a private SearXNG metasearch engine without relying on built-in search tools, returning structured JSON you can filter and process programmatically. ## Core Features & Use Cases - Metasearch via CLI: Aggregates results from Google, Bing, DuckDuckGo, and other engines through one `searxng search` command. - Structured JSON output: The `--json` flag returns titles, URLs, snippets, engines, scores, and suggestions ready for `jq` filtering. - Flexible filtering: Narrow results by category, engine, language, time range, and safe-search level, or pass operators like `site:` and `filetype:` through to backend engines. - Use Case: When asked "what's the latest on a library release", run a time-range-filtered news search and extract the top URLs with `jq` to cite current sources. ## Quick Start Ask the assistant to search the web for a topic, for example "search the web for the latest Python asyncio documentation updates".

Frequently Asked Questions about searxngcli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search the web from the command line with SearXNG?▼

Run `searxng search "your query" --json` to get machine-readable results from a SearXNG instance. Flags like `--categories`, `--engines`, and `--time-range` narrow the scope, and output can be filtered with `jq`.

How to filter SearXNG search results by time range or category?▼

Can I use search operators like site: with SearXNG?▼

Yes, operators such as `site:`, `filetype:`, and `intitle:` are passed through to backend engines as-is. For example, `searxng search "site:github.com python cli" --json` restricts results to GitHub.

Why should I avoid piping searxng output through grep or head?▼

The `--json` output is already structured JSON, so text tools like grep or head can corrupt or misread it. Use `jq` instead, for example `jq -r '.results[].url'` to extract URLs.

What happens if the searxng CLI is not configured?▼

The skill instructs the assistant to ask the user for their SearXNG instance URL when the CLI lacks configuration. Without a configured instance, searches cannot be executed.