skills.rest
ossoolli
ossoolliCOMMUNITY
Explore all skills by this author →
GitHub

searxng-search

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

Updated May 18, 2026
Search Tags:#research#web search#self-hosted#searxng#json api#meta-search#search fallback
One-click install
npx skills add https://github.com/ossoolli/Nexum-Core --skill searxng-search-ossoolli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/ossoolli/Nexum-Core/tree/main/optional-skills/research/searxng-search
Command: npx skills add https://github.com/ossoolli/Nexum-Core --skill searxng-search-ossoolli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free, API-key-free web search by querying a SearXNG instance, serving as a fallback when the primary web search toolset is unavailable or unconfigured. ## 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 JSON results. - 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, set SEARXNG_URL to a public or self-hosted instance and run searches with engine, category, safesearch, and time-range filters. ## Quick Start Set the SEARXNG_URL environment variable to a reachable SearXNG instance and ask the agent to search for a topic using SearXNG with JSON output.

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 with SearXNG from the command line?▼

Use curl to call the SearXNG JSON API with your query, for example curl -s "${SEARXNG_URL}/search?q=python+async&format=json&limit=10". Always set format=json and a --max-time timeout for machine-readable, non-hanging results.

Does SearXNG search require an API key?▼

No API key is required when using a public SearXNG instance. You only need to set the SEARXNG_URL environment variable pointing to a public or self-hosted instance.

Can I self-host SearXNG with Docker?▼

Yes, run docker run -d -p 8888:8080 -v $(pwd)/searxng:/etc/searxng searxng/searxng:latest, then set SEARXNG_URL=http://localhost:8888. Self-hosting avoids public instance rate limits and downtime.

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 connectivity with a test curl request, and self-host if public instances rate-limit or go down.

Does SearXNG return full page content?▼

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

Related Skills

Explore More Education & Research Skills→
vikrant-projectvikrant-project
2

searxng-search

Aggregate search results from over 70 engines via SearXNG.

Community
Basic
consuelohqconsuelohq
7

deep-search

Search Brave for relevant URLs and extract full-page content into a combined report.

Official
Intermediate
botlearn-aibotlearn-ai
9

google-search

Construct advanced search queries with Boolean operators and credibility-based ranking.

Official
Intermediate
episvrepisvr

searxng-search

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

Community
Intermediate