Searxng Search

YPares/agent-skills/searxng-search

作者 YPares69660b8be900d642a5d4da8cbb687ec6cfb14ea5無授權條款收錄於 2026年10月9日更新於 2026年10月9日

Enhanced web and package repository search using local SearXNG instance

包含腳本Research & Analysis
AI 產生的概覽

啟動本機 SearXNG 中繼搜尋引擎容器，並透過 HTTP 查詢網頁與套件倉庫結果。

功能
此技能使用 podman 或 docker 啟動本機 SearXNG 中繼搜尋實例，並透過其 JSON 搜尋 API 進行查詢。它支援一般網頁搜尋，以及 cargo、packages、repos、it、code 等套件與程式碼倉庫分類，並說明 JSON 回應結構。它也提供透過 PyPI JSON API 或 qypi 命令列工具搜尋 PyPI 的替代做法，並附有 Nushell 輔助函式範例與除錯指令。
適用情境
當代理程式需要透過本機代管的搜尋引擎進行重視隱私的網頁搜尋，或查詢套件與倉庫時使用。適合尋找 crate、npm 套件、GitHub 倉庫或一般網頁結果等任務，並以一致的 JSON 介面回傳。
執行需求
需要 podman 或 docker 來執行 SearXNG 容器，需要 curl 發出 HTTP 請求，並需要網路存取讓容器連線上游搜尋引擎。此技能附有可執行指令碼（start-searxng 與 searx）。文中提到的選用工具包括 jq、Nushell，以及用於 PyPI 查詢的 uvx 與 qypi。

SearXNG Search

SearXNG is a privacy-respecting metasearch engine that you can run locally. It aggregates results from multiple search engines and package repositories, returning clean JSON output.

Quick Start

Start SearXNG:

bash
start-searxng --detach

This will:

  • Auto-detect podman or docker
  • Create a minimal config with JSON output enabled
  • Start SearXNG on http://localhost:8888
  • Wait until ready

Stop SearXNG:

bash
podman stop searxng  # or: docker stop searxng

Custom port:

bash
start-searxng --port 9999 --detach

Quick Reference

TaskCommandCategory
General web searchcurl "http://localhost:8888/search?q=<query>&format=json"general
Search Cargo/crates.iocurl "http://localhost:8888/search?q=<crate>&format=json&categories=cargo"cargo
Search npm packagescurl "http://localhost:8888/search?q=<pkg>&format=json&categories=packages"packages
Search code repositoriescurl "http://localhost:8888/search?q=<query>&format=json&categories=repos"repos
Search IT resourcescurl "http://localhost:8888/search?q=<query>&format=json&categories=it"it
Limit resultsAdd &limit=N to URL-
Multiple categories&categories=cat1,cat2-

Available Categories

Run to see all categories:

bash
curl -s "http://localhost:8888/config" | jq '.categories'

Notable categories:

  • general: General web search (default)
  • cargo: Rust crates from crates.io
  • packages: Multi-repo (npm, rubygems, haskell/hoogle, hex, packagist, metacpan, pub.dev, pkg.go.dev, docker hub, alpine, etc.)
  • it: IT/tech resources (includes GitHub, Docker Hub, crates.io)
  • repos: Code repositories
  • code: Code search
  • scientific publications: Academic papers
  • news, videos, images, books, etc.

See package-engine-status.md [blocked] for comprehensive package search testing results.

JSON Response Structure

json
{  "query": "search term",  "number_of_results": 0,  "results": [    {      "url": "https://example.com",      "title": "Result Title",      "content": "Snippet of content...",      "publishedDate": "2025-01-01T00:00:00",      "engine": "duckduckgo",      "engines": ["duckduckgo", "startpage"],      "score": 3.0,      "category": "general"    }  ],  "answers": [],          // Direct answers/infoboxes  "suggestions": [],      // Search suggestions  "corrections": [],      // Query corrections  "infoboxes": [],       // Knowledge panels  "unresponsive_engines": []}

Common Usage Patterns

1. Package Repository Searches

Cargo/Rust crates:

bash
curl -s "http://localhost:8888/search?q=tokio&format=json&categories=cargo" | \  jq '.results[] | {title, url, content}'

npm packages:

bash
curl -s "http://localhost:8888/search?q=express&format=json&categories=packages" | \  jq '.results[] | select(.engines[] == "npm") | {title, url, content}'

PyPI packages (workaround - see below):

bash
# PyPI engine is enabled but not returning results in current SearXNG config# Use direct API or qypi CLI instead (see PyPI Workaround section)

2. Web Search with Filtering

IT/Tech search:

bash
curl -s "http://localhost:8888/search?q=rust+async&format=json&categories=it" | \  jq '.results[0:5] | .[] | {title, url, engines}'

GitHub repositories:

bash
curl -s "http://localhost:8888/search?q=machine+learning&format=json&categories=repos" | \  jq '.results[] | select(.engines[] == "github") | {title, url}'

3. Extracting Specific Information

Get top 3 results:

bash
curl -s "http://localhost:8888/search?q=rust+ownership&format=json" | \  jq '.results[0:3] | .[] | {title, url, content}'

Check which engines returned results:

bash
curl -s "http://localhost:8888/search?q=python&format=json" | \  jq '.results[0].engines'

Get answer boxes/infoboxes:

bash
curl -s "http://localhost:8888/search?q=rust+language&format=json" | \  jq '.infoboxes, .answers'

PyPI Workaround

Since PyPI is not returning results in SearXNG (despite being enabled), use these alternatives:

Option 1: Direct PyPI JSON API

bash
# Search (limited to simple package name matching)curl -s "https://pypi.org/pypi/<package>/json" | jq '.info | {name, summary, version, home_page}'
# Example:curl -s "https://pypi.org/pypi/requests/json" | jq '.info.summary'

Option 2: qypi CLI tool

bash
# Installuvx qypi search pandas --json
# Get package infouvx qypi info requests --json
# List releasesuvx qypi releases flask --json

See references/pypi-direct-search.md for more details.

Integration with Nushell

Create a helper function:

nu
def searx [  query: string,  --category (-c): string = "general",  --limit (-l): int = 10] {  http get $"http://localhost:8888/search?q=($query | url encode)&format=json&categories=($category)"  | get results  | first $limit  | select title url content engines}

Usage:

nu
searx "tokio async" --category cargo --limit 5searx "flask tutorial" --category general

Debugging

Check SearXNG config:

bash
curl -s "http://localhost:8888/config" | jq '.engines[] | select(.name == "pypi")'

Check for engine errors:

bash
curl -s "http://localhost:8888/search?q=test&format=json" | jq '.unresponsive_engines'

Test specific engine:

bash
curl -s "http://localhost:8888/search?q=flask&format=json&engines=pypi" | jq .

Known Issues

  • PyPI engine enabled but not working: Use direct API or qypi CLI as workaround
  • Cargo category sometimes returns empty: Try categories=packages or categories=it which also include crates.io
  • Rate limiting: SearXNG may rate-limit if too many requests in quick succession

Configuration

Using the Helper Script (Recommended)

The start-searxng script creates a minimal configuration automatically:

bash
start-searxng --help

Default config includes:

  • use_default_settings: true (inherits all SearXNG defaults)
  • JSON format enabled
  • Rate limiting disabled (for local use)
  • Secret key (change in production!)

Using Your Own Config

bash
start-searxng --config /path/to/your/config/dir

Your config directory should contain settings.yml.

Manual Container Start

bash
# Create configmkdir -p /tmp/searxng-configcat > /tmp/searxng-config/settings.yml << 'EOF'use_default_settings: truesearch:  formats:    - html    - jsonserver:  secret_key: "change-me-in-production"  bind_address: "0.0.0.0"  port: 8080EOF
# Start with podmanpodman run --rm -d --name searxng \  -p 8888:8080 \  -v /tmp/searxng-config:/etc/searxng:Z \  docker.io/searxng/searxng:latest
# Or with dockerdocker run --rm -d --name searxng \  -p 8888:8080 \  -v /tmp/searxng-config:/etc/searxng \  docker.io/searxng/searxng:latest

Check Logs

bash
podman logs searxng  # or: docker logs searxng

Advanced Config

See SearXNG Settings Documentation for all options.

Minimal config to add JSON output to defaults:

yaml
use_default_settings: truesearch:  formats:    - html    - json

來源與署名

來源：YPares/agent-skills位於searxng-search提交69660b8

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多Research & Analysis技能

Sector Overview

anthropics

精選

產生產業與類股全景報告，涵蓋市場規模、競爭定位、估值與投資啟示。

Research & Analysis39K2 週前更新

Sector Overview

anthropics

精選

產生產業與類股全景報告，涵蓋市場規模、競爭定位、估值與投資啟示。

Research & Analysis39K2 週前更新

Idea Generation

anthropics

精選

透過量化篩選、主題研究與模式辨識，系統性地篩選股票並發掘投資想法。

Research & Analysis39K2 週前更新

Competitive Analysis

anthropics

精選

建立競爭格局簡報：市場定位、競爭對手深入分析、比較表格與策略綜合。

Research & Analysis39K2 週前更新

Equity Research

anthropics

精選

根據分析師共識預估、公司基本面、歷史價格與總體經濟資料，產出結構化的股票研究快照。

Research & Analysis39K2 週前更新

Sector Overview

anthropics

精選

產生產業與類股全景報告，涵蓋市場規模、競爭定位、估值與投資啟示。

Research & Analysis39K2 週前更新