searxng-search

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free web search without requiring an API key by querying a self-hosted or public SearXNG instance, and serves as an automatic fallback when the primary web search toolset is unavailable. ## Core Features & Use Cases - Meta-Search Aggregation: Queries 70+ search engines simultaneously through a single SearXNG JSON API endpoint. - Flexible Access Methods: Supports curl CLI calls, Python requests, and a bundled shell script for structured queries with engine, category, safesearch, and time-range filters. - Self-Hosting Support: Includes Docker and pip instructions for running a private SearXNG instance to avoid rate limits. - Use Case: When FIRECRAWL_API_KEY is not configured, search for "fastapi deployment guide" via a public SearXNG instance, then extract the top result's full page content with web_extract. ## Quick Start Set the SEARXNG_URL environment variable to a reachable 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 using SearXNG?▼

Set the SEARXNG_URL environment variable to a public or self-hosted SearXNG instance, then call its /search endpoint with curl or Python requests using format=json. No API key is required for public instances.

How to self-host a SearXNG search instance with Docker?▼

Run docker run -d -p 8888:8080 with the searxng/searxng image and a settings volume, then set SEARXNG_URL=http://localhost:8888. Self-hosting avoids public instance rate limits and downtime.

Does SearXNG return full page content from search results?▼

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

Why does SearXNG search return empty results or fail?▼

Failures usually come from an unset SEARXNG_URL, an unreachable instance, or a public instance blocking the query. Verify the instance responds with a test curl request, or switch to another instance or self-host.

What search filters does the SearXNG API support?▼

The API supports query parameters for engines, categories like news and science, safesearch levels, time_range filters such as day or week, result limits, and output formats including json, csv, and rss.