---
name: searxng-search
description: Search the web using a private SearXNG instance.
---

# SearXNG Web Search

Search the web and retrieve privacy-respecting results from a SearXNG
meta-search engine instance.

## Description

This skill allows the agent to perform broad web searches across
multiple engines (Google, Bing, DuckDuckGo, etc.) via a SearXNG
endpoint, using curl in a shell command. It returns results in JSON
format, including titles, URLs, and snippets.

## Configuration

To use this skill, ensure the environment variable `SEARXNG_URL` is
set to your instance's base URL (e.g., `https://search.mydomain.com`).

## Usage

The agent uses this skill when it needs up-to-date information, news,
or specific webpage links that are not in its training data.

### Example Request

"Search for the latest news on SpaceX Starship launches."

```
curl -X POST \
  --data-urlencode "q=latest news SpaceX Starship launch" \
  -d "format=json" \
  "$SEARXNG_URL/search"
```

## SearXNG search API reference

**Key Parameters**
    - `q`: The search query string.
    - `format`: Must be set to `json` for programmatic processing.
    - `categories`: (Optional) Comma-separated list (e.g., `general`, `news`, `it`, `science`, `images`).
    - `engines`: (Optional) Specific engines to query (e.g., `google`, `duckduckgo`, `wikipedia`).
    - `language`: (Optional) Search language (e.g., `en-US`).
    - `pageno`: (Optional) Results page number (starting from 1).
    - `safesearch`: (Optional) `0` (None), `1` (Moderate), `2` (Strict).