searxng-search

Query a SearXNG instance to aggregate search results from multiple engines.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

searxng-search helps you get fast, privacy-respecting search results by aggregating many engines through SearXNG, especially when the usual web search toolset is unavailable.

Core Features & Use Cases

  • Free meta-search aggregation: Queries 70+ search engines at once and returns consolidated results and snippets.
  • Self-host or use public instances: Works with a user-provided SEARXNG_URL or a public SearXNG endpoint.
  • Automatic fallback for missing web tools: Becomes available when FIRECRAWL_API_KEY is not configured, avoiding a dead-end when web search support is missing.
  • Category, engine, and safesearch controls: Lets you narrow results by engines, categories, safesearch level, and time range.

Example use case: You need sources for “AI news” but your primary web search credentials are not set; you can use SearXNG to find relevant articles across multiple engines and then extract full pages separately.

Quick Start

Set SEARXNG_URL to your SearXNG instance and ask: “Search for AI news from the past week using SearXNG and return 5 results with titles and URLs.”

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 when my primary search credentials are missing?

Web search without primary credentials is possible via SearXNG meta-search aggregation, which queries 70+ upstream engines using the JSON API and returns consolidated results without requiring standard API keys.

How do I filter web research results by time range and category?

Filter web research results by passing time_range and categories parameters to the SearXNG JSON API, allowing you to narrow meta-search outputs by specific engines, safesearch levels, and time constraints.

Do I need a self-hosted SearXNG instance to use meta-search?

A self-hosted SearXNG instance is not required; you can use any reachable public SearXNG endpoint by setting the SEARXNG_URL environment variable to access the JSON API for privacy-friendly searching.

What is a privacy-friendly meta-search and how does it work?

Privacy-friendly meta-search works by querying a SearXNG instance that aggregates requests across 70+ search engines, returning consolidated snippets and URLs directly through a JSON API without direct user tracking.

Can I use SearXNG as a fallback when FIRECRAWL_API_KEY is not configured?

SearXNG works as an automatic fallback for web research when FIRECRAWL_API_KEY is not configured, preventing dead-ends by providing cross-engine meta-search coverage through its JSON API.

Why does my SearXNG meta-search return no results?

SearXNG meta-search returns no results if the SEARXNG_URL is unreachable or incorrectly configured, as the JSON API requires network access to the instance to aggregate upstream engines and return data.