searxng-search

Queries SearXNG meta-search instances via JSON API to aggregate results from 70+ engines.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill searxng-search-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/research/searxng-search
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill searxng-search-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free, keyless web search when no paid search API key (like FIRECRAWL_API_KEY) is configured, by querying a SearXNG instance that aggregates results from over 70 search engines. ## Core Features & Use Cases - Keyless Meta-Search: Query public or self-hosted SearXNG instances via curl or Python requests with JSON output, engine selection, categories, safesearch, and time-range filters. - Fallback Search Path: Automatically serves as a fallback when the main web search toolset is not configured, with a detection flow to verify SEARXNG_URL reachability. - Self-Hosting Support: Run your own SearXNG instance via Docker or pip for full control and no rate limits. - Use Case: You need current AI news but have no search API key. Set SEARXNG_URL to a public instance, query with categories=news and time_range=week, then extract the top result URL for full content. ## Quick Start Set the SEARXNG_URL environment variable to a reachable SearXNG instance and ask the agent to search the web for a topic using SearXNG.

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 without an API key?▼

Use SearXNG, a free meta-search aggregator that queries 70+ engines without requiring an API key. Set the SEARXNG_URL environment variable to a public or self-hosted instance, then call its JSON search endpoint with curl or Python requests.

How to query SearXNG from the command line with curl?▼

Call the instance search endpoint with format=json, for example: curl -s --max-time 10 "${SEARXNG_URL}/search?q=python+async&format=json&limit=10". You can add engines, categories, safesearch, and time_range parameters to filter results.

Does SearXNG return full page content?▼

No, SearXNG returns only titles, URLs, and snippets per result. To get full page content, search first and then extract the most relevant URL using web_extract, browser tools, or curl.

Why does SearXNG search fail or return empty results?▼

Failures usually mean SEARXNG_URL is unset, the instance is unreachable, or the instance blocks the query. Verify the URL with a test curl request, try a different public instance, or self-host with Docker for reliability.

Can I self-host SearXNG instead of using public instances?▼

Yes, run SearXNG with Docker using docker run -d -p 8888:8080 searxng/searxng:latest, or install via pip. Then set SEARXNG_URL=http://localhost:8888 to avoid public instance rate limits and downtime.