mcpField
S
searxng-search

searxng-search

github.com/xyenonProductivity154 installsUpdated 3w ago
Repository

About searxng-search

searxng-search is a skill for searching the web through a SearXNG instance's API. It supports filters for categories, engines, language, time range and safe search, along with pagination and result limits.

Key features

  1. 01Searches through a SearXNG API
  2. 02Filters by category and engine
  3. 03Sets language and time range
  4. 04Controls safe search level
  5. 05Supports pagination and result limits

Use cases

  1. 01Searching for recent news
  2. 02Restricting results to selected engines
  3. 03Finding results in a chosen language

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xyenon/agents --skill searxng-search

After installing, type/searxng-searchin Claude Code to confirm it loaded.

Bundled filesreferences/configuration.mdscripts/search.py

Details

From the project README

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

Comments

Markdown supported