skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
xyenon/agents54 installs

searxng-search

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.

How do I install this agent skill?

npx skills add https://github.com/xyenon/agents --skill searxng-search
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a legitimate utility for searching the web using a SearXNG instance. It handles sensitive credentials (API tokens and passwords) stored in a local configuration file and processes untrusted content from the web, which presents a surface for indirect prompt injection.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerpass

    1/2 files flagged

What does this agent skill do?

SearXNG Search Skill

Search the web using a SearXNG instance via its API.

Configuration issues

This skill depends on a local SearXNG config file. Keep setup details out of this file and load references/configuration.md only when needed.

If scripts/search.py reports configuration, auth, or instance setup errors, read references/configuration.md before retrying. Common examples include:

  • ERROR: Config file not found
  • ERROR: Invalid TOML ... / ERROR: Invalid JSON ...
  • ERROR: base_url is required
  • ERROR: Environment variable ... is not set
  • ERROR: auth.token required for bearer auth
  • ERROR: auth.user and auth.pass required for basic auth
  • ERROR: Unknown auth.type ...
  • ERROR: HTTP 401 / ERROR: HTTP 403

Usage

Run the search script:

python3 scripts/search.py [OPTIONS] <query>

Options

FlagDescription
-c, --categoriesComma-separated categories (general, news, images, videos, music, files, it, science, social media)
-e, --enginesComma-separated engines (google, duckduckgo, bing, etc.)
-l, --languageLanguage code (en, zh-CN, ja, etc.)
-p, --pagePage number (default: 1)
-t, --time-rangeTime range: day, month, year
-n, --max-resultsMax results to show (overrides config default)
-s, --safesearchSafe search: 0 (off), 1 (moderate), 2 (strict)

Examples

# 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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/xyenon/agents/searxng-search">View searxng-search on skillZs</a>