searxng-search

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Search the web using a self-hosted SearXNG instance. Use when users ask to search with SearXNG, or when web search is needed and a SearXNG instance is configured. Supports categories, engines, time range, and language filters.

14installs
Sourcexyenon/agents
Added on

NPX Install

npx skill4agent add xyenon/agents searxng-search

Tags

Translated version includes tags in frontmatter
searxngweb-searchself-hostedcli-toolapi-integration

SKILL.md Content

View Translation Comparison →

SearXNG Search Skill

Search the web using a SearXNG instance via its API.

Configuration

The config file is read from 
$XDG_CONFIG_HOME/agents/searxng.json
(defaults to 
~/.config/agents/searxng.json
).

Config fields

FieldTypeRequiredDescription
base_url
string
YesSearXNG instance URL (no trailing slash)
auth
object
NoAuth config object (see below)
auth.type
string
If auth
"bearer"
or 
"basic"
auth.token
string
If bearerBearer token value (supports 
$ENV_VAR
)
auth.user
string
If basicBasic auth username
auth.pass
string
If basicBasic auth password
headers
object
NoKey-value pairs of additional HTTP headers
default_language
string
NoDefault language code (e.g. 
"en"
, 
"zh-CN"
)
default_categories
string[]
NoDefault categories (e.g. 
["general", "news"]
)
default_engines
string[]
NoDefault engines (e.g. 
["google", "duckduckgo"]
)
default_safesearch
number
NoDefault safe search level: 
0
, 
1
, 
2
default_time_range
string
NoDefault time range: 
"day"
, 
"month"
, 
"year"
default_max_results
number
NoMax results to display (default: 
5
)
timeout
number
NoRequest timeout in seconds (default: 
30
)

Example config (Bearer auth)

json
{
  "base_url": "https://searx.example.com",
  "auth": {
    "type": "bearer",
    "token": "your-token-here"
  },
  "default_categories": ["general"],
  "default_engines": ["google", "duckduckgo", "brave"],
  "default_max_results": 10,
  "headers": {
    "X-Custom-Header": "value"
  }
}

Example config (Basic auth)

json
{
  "base_url": "https://searx.example.com",
  "auth": {
    "type": "basic",
    "user": "admin",
    "pass": "password"
  },
  "default_safesearch": 1
}

Usage

Run the search script:
bash
python3 scripts/search.py [OPTIONS] <query>

Options

FlagDescription
-c, --categories
Comma-separated categories (
general
, 
news
, 
images
, 
videos
, 
music
, 
files
, 
it
, 
science
, 
social media
)
-e, --engines
Comma-separated engines (
google
, 
duckduckgo
, 
bing
, etc.)
-l, --language
Language code (
en
, 
zh-CN
, 
ja
, etc.)
-p, --page
Page number (default: 1)
-t, --time-range
Time range: 
day
, 
month
, 
year
-n, --max-results
Max results to show (overrides config default)
-s, --safesearch
Safe search: 
0
(off), 
1
(moderate), 
2
(strict)

Examples

bash
# Basic search
python3 scripts/search.py "SearXNG documentation"

# Search news from the last day
python3 scripts/search.py -c news -t day "latest tech news"

# Search with specific engines, page 2
python3 scripts/search.py -e google,duckduckgo -p 2 "rust programming"

# Search in Chinese with more results
python3 scripts/search.py -l zh-CN -n 10 "开源搜索引擎"

Best Practices

  • Technical topics (programming, software, science, IT, etc.): Always use English as both the query language and search language (
    -l en
    ), regardless of the user's input language. Translate the query to English if needed. English results are more comprehensive and up-to-date for technical content.
  • Chinese lifestyle topics (food, travel, shopping, local services, social trends, etc.): In addition to the default search, run a second search with 
    -e baidu,sogou -l zh-CN
    using a Chinese query to capture China-specific results. Merge and deduplicate results before presenting to the user.

Workflow

  1. User asks to search for something
  2. Determine the topic type:
    • Technical: translate query to English if needed, search with 
      -l en
    • Chinese lifestyle: run the default search first, then an additional search with 
      -e baidu,sogou -l zh-CN
  3. Run 
    scripts/search.py
    with the query and any relevant filters
  4. Present results to the user in a readable format
  5. If user wants more results, use 
    -p
    for pagination or 
    -n
    for more per page