searxng-search

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill searxng-search-episvr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: searxng-search
Source: https://github.com/episvr/USTB-2026-SummerInternship/tree/main/hermes-config/optional-skills/research/searxng-search
Command: npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill searxng-search-episvr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It provides free web search without 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: Query 70+ search engines simultaneously through a single SearXNG JSON API endpoint using curl or Python requests. - Flexible Filtering: Control engines, categories, safesearch level, time range, and result limits per query. - Self-Hosting Support: Run your own SearXNG instance via Docker or pip to avoid rate limits and public instance downtime. - Use Case: When the main web search toolset lacks a configured API key, set SEARXNG_URL to a public instance and run searches like "AI news this week" with category and time-range filters, then extract full pages from the top URLs. ## Quick Start Set the SEARXNG_URL environment variable to a reachable SearXNG instance and ask the agent to search the web for a topic such as "fastapi deployment guide" with JSON results.

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: curl -s "${SEARXNG_URL}/search?q=your+query&format=json&limit=10". Always set format=json explicitly and use --max-time to avoid hanging on unreachable instances.

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.

How do I self-host a SearXNG instance with Docker?▼

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 switch instances or self-host if problems persist.

Can SearXNG extract full page content from search results?▼

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