searxngcli

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

15|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/fprochazka/claude-code-plugins --skill searxngcli-fprochazka
Or copy as Structured Prompt for Agent▼
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?▼

Pass `--time-range day|week|month|year` for recency and `--categories news|images|videos|it|science` for content type. Combine them, for example `searxng search "climate change" --categories news --time-range month --json`.

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.