searxng-search

Search the web through a local SearXNG instance with category and time filters.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/varlabz/skills --skill searxng-search-varlabz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/varlabz/skills/tree/main/searxng-search
Command: npx skills add https://github.com/varlabz/skills --skill searxng-search-varlabz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve? It gives you live web search results from a self-hosted SearXNG instance, so you can find current information, news, and documentation that is not in the model's training data without relying on a commercial search API. ## Core Features & Use Cases - Categorized Search: Query across categories like general, news, images, videos, it, science, and social media, combinable with commas. - Filtering Options: Narrow results by time range (day, week, month, year), language, safe search level, and maximum result count. - Flexible Output: Get results as structured JSON or a readable numbered text list. - Use Case: Ask for the latest AI announcements from the past week, and the skill runs a news-category search with a week time filter against your local SearXNG server and returns titles, URLs, and snippets. ## Quick Start Ask the assistant to search the web for a topic, for example: search for recent news about transformer architecture from the past week.

Frequently Asked Questions about searxng-search

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

FAQPage Schema
How do I search the web using a local SearXNG instance?

Run the search script with your query, for example ./scripts/search "Python asyncio best practices". The script sends the query to the SearXNG /search endpoint and returns results as JSON by default.

How do I filter SearXNG search results by category or time?

Use the --category flag with values like general, news, it, or science, combining multiple with commas. Add --time-range with day, week, month, or year to restrict results to a recent period.

Can I use a different SearXNG server URL?

Yes. Pass the --server flag to override the instance URL, or set the SEARXNG_URL environment variable. The default is http://localhost:8080.

What output formats does the SearXNG search script support?

The script supports JSON and plain text output via the --format flag. JSON is the default and includes title, url, engine, score, and content fields for each result.

Why does the SearXNG search return no results or fail?

Failures usually occur when the local SearXNG instance is not running or unreachable at the configured URL. Verify the server is up at http://localhost:8080 and that the JSON format is enabled in your SearXNG settings.