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.